curl --request POST \
--url https://api.enterprise.sandbox.uphold.com/core/transactions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"quoteId": "623000c8-9bdf-4a2b-aa3d-6a6b44a7f6a0",
"metadata": {
"externalId": 123
}
}
'{
"transaction": {
"id": "623000c8-9bdf-4a2b-aa3d-6a6b44a7f6a0",
"origin": {
"amount": "100.00",
"asset": "GBP",
"rate": "47619.04761904762",
"node": {
"type": "account",
"id": "b98e4f0d-a67d-4126-a99d-666f7e0315d9",
"ownerId": "e4ce04dc-67b7-4e9f-af91-482cb6f9fc4a"
}
},
"destination": {
"amount": "0.0021",
"asset": "BTC",
"rate": "0.000021",
"node": {
"type": "account",
"id": "555a99a1-620d-4431-a0ac-b43e1aad2bdc",
"ownerId": "e4ce04dc-67b7-4e9f-af91-482cb6f9fc4a"
}
},
"denomination": {
"amount": "100.00",
"asset": "GBP",
"target": "origin",
"rate": "1"
},
"fees": [],
"status": "processing",
"quotedAt": "2024-07-24T15:02:39.000Z",
"createdAt": "2024-07-24T15:22:39.000Z",
"updatedAt": "2024-07-24T15:32:39.000Z"
}
}Transactions
Create transaction
Create transaction from a quote.
POST
/
core
/
transactions
curl --request POST \
--url https://api.enterprise.sandbox.uphold.com/core/transactions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"quoteId": "623000c8-9bdf-4a2b-aa3d-6a6b44a7f6a0",
"metadata": {
"externalId": 123
}
}
'{
"transaction": {
"id": "623000c8-9bdf-4a2b-aa3d-6a6b44a7f6a0",
"origin": {
"amount": "100.00",
"asset": "GBP",
"rate": "47619.04761904762",
"node": {
"type": "account",
"id": "b98e4f0d-a67d-4126-a99d-666f7e0315d9",
"ownerId": "e4ce04dc-67b7-4e9f-af91-482cb6f9fc4a"
}
},
"destination": {
"amount": "0.0021",
"asset": "BTC",
"rate": "0.000021",
"node": {
"type": "account",
"id": "555a99a1-620d-4431-a0ac-b43e1aad2bdc",
"ownerId": "e4ce04dc-67b7-4e9f-af91-482cb6f9fc4a"
}
},
"denomination": {
"amount": "100.00",
"asset": "GBP",
"target": "origin",
"rate": "1"
},
"fees": [],
"status": "processing",
"quotedAt": "2024-07-24T15:02:39.000Z",
"createdAt": "2024-07-24T15:22:39.000Z",
"updatedAt": "2024-07-24T15:32:39.000Z"
}
}user:individualuser:business
The transaction ID will be the same as the quote ID to allow for easy tracking and correlation.
You can optionally include custom entity metadata in the
metadata field to store your own business data (e.g., reference numbers, categorization, reconciliation data). If not provided during creation, you can add it later using Set metadata.
Some types of transactions require you to pass user context headers, such as
X-Uphold-User-Ip and X-Uphold-User-Agent Headers.Authorizations
OAuth 2.0 authentication.
Body
application/json
Was this page helpful?