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

Did this page help you?