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/v2/transactions" \
-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
}'The response includes the transaction ID and Interac reference:
{
"success": true,
"data": {
"id": "3943bb00-1551-4f1d-bf32-2d82608bc15e",
"date": "2025-07-25T14:02:36.000Z",
"coin": "USDC",
"leftSideLabel": "CAD",
"leftSideValue": 1000,
"rightSideLabel": "USDC-ETH",
"rightSideValue": 725.35,
"status": "complete",
"wallet": "0x742d35Cc6634C0532925a3b844Bc9e7595f8bC3a",
"paymentType": "interac",
"paymentId": "pay_123456789",
"rmtId": "CA1MRUaaErpx",
"depositAddress": null
}
}For buy transactions, the user must complete the Interac e-Transfer using the rmtId reference number before the transaction can be processed.
API Reference: Create Transaction for authenticated user
View complete request parameters and response schema
Get transaction details
curl "https://api.paytrie.com/v2/transactions/3943bb00-1551-4f1d-bf32-2d82608bc15e" \
-H "x-api-key: your-api-key" \
-H "Authorization: Bearer user-jwt-token"API Reference: Get Transaction by id
View complete request parameters and response schema
Transaction statuses
| Status | Description |
|---|---|
awaiting-fiat | Buy: awaiting the buyer's Interac e-Transfer payment |
processing-fiat | Buy: Interac payment received, processing |
finalizing-fiat | Buy: finalizing the fiat payment |
sending-crypto | Buy: sending the stablecoin to the buyer's wallet |
awaiting-crypto | Sell: awaiting the seller's stablecoin transfer |
sending-fiat | Sell: sending CAD to the seller |
complete | Transaction completed successfully |
cancelled | Transaction was cancelled |
expired | Transaction expired before payment (clean timeout) |
expired-contact-support | Expired with funds to reconcile — contact support |
refunded | Transaction was refunded |
replaced | Transaction was replaced |
Webhook notifications
Set up Webhooks to receive real-time notifications when transactions are created or status changes occur.