API Reference

Supported Operations

  • Withdraw (push to customer bank account in real-time)
  • Transaction status lookup
  • Cancellation request

Endpoints

Withdraw

POST /api/v2/rtr/withdraw

Sends funds from your VoPay account to a customer's bank account via the Real-Time Rail.

Request Parameters

ParameterTypeRequiredDescription
AmountdecimalYesTransaction amount in CAD
FinancialInstitutionNumberstringConditional3-digit bank institution number. Required if not using a token
BranchTransitNumberstringConditional5-digit branch transit number. Required if not using a token
AccountNumberstringConditionalCustomer's bank account number. Required if not using a token
TokenstringConditionalTokenized bank account. Use instead of raw banking details
FirstNamestringOptionalCustomer's first name
LastNamestringOptionalCustomer's last name
CompanyNamestringOptionalCustomer's company name
IsCompanybooleanOptionalSet to true if the recipient is a business
ClientAccountIDstringOptionalLink transaction to a sub-account
ContactIDstringOptionalLink transaction to a contact
WalletIDstringOptionalSource wallet ID
ClientReferenceNumberstringOptionalYour internal reference number
TransactionTypeCodestringOptionalTransaction type code
GLCodestringOptionalGeneral ledger code
NotesstringOptionalInternal notes
IdempotencyKeystringOptionalUnique key to prevent duplicate transactions
ParentTransactionIDstringOptionalID of a parent transaction to link this to

Get Withdraw Transaction

POST /api/v2/rtr/withdraw/transaction

Returns details of a single RTR withdraw transaction.

Request Parameters

ParameterTypeRequiredDescription
TransactionIDstringYesThe transaction ID returned from /rtr/withdraw

Request Cancellation

POST /api/v2/rtr/withdraw/transaction/request-cancellation

Submits a cancellation request for an RTR withdraw transaction. Cancellation is not guaranteed as the transaction may have already settled.

Request Parameters

ParameterTypeRequiredDescription
TransactionIDstringYesThe transaction ID to request cancellation for