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/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

StatusDescription
awaiting-fiatBuy: awaiting the buyer's Interac e-Transfer payment
processing-fiatBuy: Interac payment received, processing
finalizing-fiatBuy: finalizing the fiat payment
sending-cryptoBuy: sending the stablecoin to the buyer's wallet
awaiting-cryptoSell: awaiting the seller's stablecoin transfer
sending-fiatSell: sending CAD to the seller
completeTransaction completed successfully
cancelledTransaction was cancelled
expiredTransaction expired before payment (clean timeout)
expired-contact-supportExpired with funds to reconcile — contact support
refundedTransaction was refunded
replacedTransaction was replaced

Webhook notifications

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

On this page