Logo

Bank Payment Order

Initiate a high-fidelity bank transfer. This POST request requires detailed KYC information for both the remitter and recipient to comply with international banking standards.

Note: A valid token is required for authentication as it expires after every hour. Refer to the Token Request section to generate a new token.

Remitter Info

Required for Payment Remittance Companies

  • originatorConversationId: Unique client request ID.
  • paymentNotes: Brief summary of request.
  • Identification: idType (National ID/Passport), idNumber, idIssueDate, idExpiryDate.
  • Personal: Name, Contact, Address, Nationality.
  • Financial: sourceOfFunds, principalActivity, ccy.
  • DOB: Format: yyyy/mm/dd.

Recipient & Order

  • institutionIdentifier: SWIFT code or Account (Mandatory).
  • Details: Name, Email, Contact, Address.
  • primaryAccountNumber: Account to be credited.
  • ccy & country: ALPHA 2 country code and currency.
  • transaction: Includes routeId, channelType, amount, and reference.
  • systemTraceAuditNumber: Unique transaction identifier.

NOTE ON DUPLICATES: For duplicate requests, the transaction will be accepted but will trigger a callback instead of processing a new order. Refer to the Sample Duplicate Callback Response for integration details.

POST/v1/payment-order/new-order

Execute Bank Order

Target: https://sandbox-test.wapipay.com/v1/payment-order/new-order