Interac Endpoints

interac/bulk-payout

This endpoint is used to create an Interac e-Transfer bulk payout transaction for sending funds.

If a ClientAccountID is provided, the client account's first/last name, and email address will be used for the transaction.

post/interac/bulk-payout

Request

  • Base URL
    https://earthnode-dev.vopay.com/api/v2
  • URL
    https://earthnode-dev.vopay.com/api/v2/interac/bulk-payout
  • Auth
    none declared

Request body application/x-www-form-urlencoded

AccountIDstring required

Your account ID

Keystring required

API key for the account

Signaturestring required

Hashed signature for the e-transfer

ClientAccountIDstring

Client Account ID

ContactIDstring

The ID of the contact to use for this transactions. The contacts payment method associated with this transaction type will be used.

Amountnumber required

The amount to debit from the customer's bank account.

Currencystring

3 character currency code for the currency to fetch transactions for. If this is not specified the transaction will use the account's local currency (generally CAD). NOTE: Currently the eft/fund API endpoint only supports CAD transactions.

EmailAddressstring

Recipient's email address. Either EmailAddress or PhoneNumber must be provided

PhoneNumberstring

Recipient's mobile phone number. (Digits only - no parentheses or dashes allowed.). Either EmailAddress or PhoneNumber must be provided

SenderNamestring

Sender's full name. This is the name that will be used as the sender's name in the notifications to the recipient. If not provided, your VoPay account name will be used.

RecipientNamestring required

Recipient's name, as known by the sender.

Address1string

Recipient's address line 1

Address2string

Recipient's address line 2

Citystring

Recipient's city

Provincestring

Recipient's province specified using two character abbreviations (eg. BC, AB)

Countrystring

Recipient's country specified using full country name or ISO 3166-1 alpha-2 code.

PostalCodestring

Recipient's postal code.

Languagestring

Recipient's language preference. Accepted values: en (English as the default) or fr (French).

CancellationPeriodinteger

1-30 , number of days after which the transfer will be marked as cancelled.

Memostring

Message to recipient. Set by client for the recipient.

Notesstring

An optional note to associate with the transaction.

ClientReferenceNumberstring

An optional reference number which was associated with the transaction.

Questionstring required

Security question for the transaction.

Answerstring required

Answer to the security question. This can be either a plain text answer or a hashed answer. Hashed answers must have leading and trailing whitespace trimmed, be SHA2 hashed and Base64 encoded. If a hashed answer is provided, the HashSalt input is mandatory.

HashSaltstring

The salt used to hash the answer. This input is mandatory if a hashed answer is provided.

IdempotencyKeystring

A unique key which the server can use to recognize and reject subsequent retries of the same request.

ParentTransactionIDstring

The parent transaction where the withdrawal will be linked to, can become a split payment with multiple withdrawals. When funds of the parent transaction have been released the system will generate the distributions of these funds automatically.

GLCodestring

An optional unique identification general ledger code.

TransactionTypeCodestring

CPA transaction code. Use the /api/v2/account/transactions/codes endpoint to retrieve a list of valid transaction codes. If not specified, the transaction will be created using code 450 (miscellaneous).

Response

Successboolean required

True if the sending was successful, false if it failed

ErrorMessagestring required

Contains a description of the error if the request failed

TransactionIDinteger required

The unique ID of the transaction

TransactionStatusstring required

A message indicating the current transaction status. Statuses are: requested, pending, in progress, successful, failed, cancelled

Flaggedstring

Details on why the transaction was flagged, if applicable. Flagged transactions will need to be confirmed by using the /account/transaction/confirm endpoint.

Example response

{
  "Success": true,
  "TransactionStatus": "successful",
  "Flagged": "The transaction has been flagged as a potential duplicate."
}

Changes

No recorded changes to this operation across all 1 revision of this API.