Create a transaction

Authorization

ApiKeyAuth BearerAuth

x-api-key<token>

API key for integrator authentication

In: header

AuthorizationBearer <token>

JWT token for user authentication

In: header

Header Parameters

x-api-key*string

API key for authentication

Authorization*string

JWT token from login endpoints

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

leftSideLabel*string

Currency paid in.

leftSideValue*number

Amount paid in.

rightSideLabel*string

Currency received.

wallet*string

Destination wallet address (EVM or Solana, depending on the chosen network).

quoteId?integer

Optional quote ID returned by /v2/quotes. When provided and still fresh (within ~10 minutes), the transaction is priced against that exact quote. If the quote is expired or no longer in our records, the latest available quote is used instead — the transaction still proceeds, but the rate may differ from what was originally displayed. Refresh the quote before submitting if more than ~10 minutes have elapsed. Omit to always use the latest quote.

externalSessionId?string

Free-form integrator-side identifier echoed on webhooks.

vendorId?string

Iframe vendor app code. When the request is made with the Paytrie api key, the transaction is re-attributed to the vendor integrator resolved by this id.

useReferral?boolean

When true, applies the user’s referral discount and decrements their credit.

Response Body

`application/json`

import { PaytrieAPI, configure } from '@paytrie/sdk'configure({ headers: { 'x-api-key': process.env.PAYTRIE_API_KEY! } })const { data } = await PaytrieAPI.createTransaction({})

{  "success": true,  "data": {    "id": "3943bb00-1551-4f1d-bf32-2d82608bc15e",    "date": "2025-07-25T14:02:36.000Z",    "coin": "USDC",    "leftSideLabel": "CAD",    "leftSideValue": 500,    "rightSideLabel": "ETH-USDC",    "rightSideValue": 325.5,    "status": "complete",    "wallet": "0x756Fead01907b3c2173d148f9864d00fAd371AB6",    "paymentType": "interac",    "paymentId": "pay_123456789",    "rmtId": "CA1MRUaaErpx",    "depositAddress": "0x1234567890123456789012345678901234567890"  }}

{  "success": false,  "errors": [    {      "field": "string",      "message": "string"    }  ]}

{  "success": false,  "errors": [    {      "field": "string",      "message": "string"    }  ]}

{  "success": false,  "errors": [    {      "field": "string",      "message": "string"    }  ]}

Create a transaction

Authorization

Header Parameters

Request Body

Response Body

201application/json

400application/json

401application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`