Paytrie Developer Documentation

Transactions

Create and track stablecoin transactions

Create transactions to buy or sell stablecoins. Transactions require an authenticated user (via JWT token) and process payments through Interac e-Transfer.

Transaction flow

Get a price quote

Fetch current rates using the Price Quotes endpoint.

Create transaction

Submit the transaction with the quote details.

User sends payment

For buy transactions, the user completes the Interac e-Transfer using the reference number. For sell transactions, the user sends USDC from the wallet address provided.

Processing

Once payment is received, Paytrie processes the transfer.

Completion

For buy transactions, stablecoins are sent to the user's wallet and the transaction status updates to complete. For sell transactions, CAD is sent to the user's e-Transfer email address and the transaction status updates to complete.

Create a transaction

curl -X POST "https://api.paytrie.com/transaction" \
  -H "x-api-key: your-api-key" \
  -H "Authorization: Bearer user-jwt-token" \
  -H "Content-Type: application/json" \
  -d '{
    "leftSideLabel": "CAD",
    "leftSideValue": 1000,
    "rightSideLabel": "USDC-ETH",
    "wallet": "0x742d35Cc6634C0532925a3b844Bc9e7595f8bC3a",
    "quoteId": 337362,
    "gasId": 186324
  }'

The response includes the transaction ID and Interac reference:

{
  "message": "New transaction created",
  "status": "success",
  "tx": "3943bb00-1551-4f1d-bf32-2d82608bc15e",
  "rmt": "CA7MREh2Hhg4"
}

For buy transactions, the user must complete the Interac e-Transfer using the rmt reference number before the transaction can be processed.

API Reference: Create Transaction

View complete request parameters and response schema

Get transaction details

curl "https://api.paytrie.com/transaction?tx_id=3943bb00-1551-4f1d-bf32-2d82608bc15e" \
  -H "x-api-key: your-api-key" \
  -H "Authorization: Bearer user-jwt-token"

API Reference: Get Transaction

View complete request parameters and response schema

Transaction statuses

StatusDescription
pending request money transferWaiting for Interac e-Transfer payment
processing request money transferPayment received, processing
finalizing request money transferFinalizing the transaction
sending USDC-ETHSending USDC on Ethereum
sending USDC-SOLSending USDC on Solana
sending cadSending CAD (for sell transactions)
waiting for USDC-ETH transferWaiting for USDC on Ethereum
waiting for USDC-SOL transferWaiting for USDC on Solana
completeTransaction completed successfully
cancelledTransaction was cancelled
expiredTransaction expired
expired - contact supportTransaction expired, contact support

Webhook notifications

Set up Webhooks to receive real-time notifications when transactions are created or status changes occur.

On this page