Skip to main content
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:39Z",
    "createdAt": "2024-07-24T15:22:39Z",
    "updatedAt": "2024-07-24T15:32:39Z"
  }
}
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

​
Authorization
string
header
required

OAuth 2.0 authentication.

Body

application/json
​
quoteId
string<uuid>
required

The quote ID to commit.

​
params
object

Additional parameters required to create the transaction.

​
metadata
object

Additional data for the transaction.

Response

Transaction created.

​
transaction
object
required
​
errors
object

Additional contextual errors that occurred while processing the request.