API Reference

Request for Cross-border Bank Transfer

POST /trans/telegraphicTransfer

<Use this endpoint to request for SWIFT cross-border fund transfers>

Parameters

Parameters	Type	Description	Is Required
accountId	string	The ID of the account that is to make the transfer	TRUE
beneficiarySwiftBic	string	The bank code of the receiving bank Use /staticData/getBankCodes endpoint to get the list of bank codes	TRUE
beneficiaryBankName	string	The name of the receiving bank	TRUE
beneficiaryBankCountry	string	The branch code of the receiving bank	FALSE
beneficiaryBankCity	string	The city of the receiving bank	TRUE
beneficiaryBankAddress	string	The address of the receiving bank	FALSE
beneficiaryAccountId	string	The number of the receiving account	TRUE
beneficiaryAccountCcy	string	The currency of the receiving account	TRUE
beneficiaryName	string	Beneficiary name	TRUE
beneficiaryEmail	string	The email address of the beneficiary	FALSE
amount	decimal	Transfer amount	TRUE
amountType	Int	0 - In Debit Account Currency 1 - In Credit Account Currency	TRUE
messageToBeneficiary	string	The message to beneficiary. Not more than 100 characters.	FALSE
paymentChannel	string	SWIFT	TRUE
paymentPurposeId	string	Please refer to Payment Purpose	TRUE
paymentPurpose	string	When paymentPurposeId == OTHR, specify the payment payment in this parameter. Not more than 35 characters.	FALSE
senderAddress	string	Sender's address	TRUE
supportDocument	string	Base 64 string	FALSE
supportDocumentType	string	PDF Image	FALSE
chargeType	string	OUR BEN SHA Notes: OUR: Remitter to pay all charges BEN: Beneficiary to pay all charges SHA: Shared. Remitter to pay all fees charged by the sending bank (Here, Choice Bank) and Beneficiary to pay all fees charged by the receiving bank and intermediary/correspondent bank	TRUE

Response

00000

{
  "applicationId": ""
}

Query Inter-Bank Fund Transfer List

POST /trans/getInterBankTransferList

<Use this endpoint to query the transfer application list of RTGS/EFT/SWIFT>

Parameters

Parameters	Type	Description	Is Required
accountId	string	The ID of the account that is to make the transfer	TRUE
startTime	long	Start time	TRUE
endTime	long	End time	TRUE
pageNo	int	Page number	TRUE
pageSize	int	Page size	TRUE

Response

00000

{
  "result": [
    {
      "applicationId": "",
      "accountId": "",
      "type": "", //1-Domesitc Fund Transfer; 2-Cross-border Fund Transfer
      "currency": "",
      "amount": "",
      "createTime": "",
      "status": "",
    }
  ]
}

Query Inter-Bank Fund Transfer Details

POST /trans/getInterBankTransferDetails

<Use this endpoint to query the transfer application list of RTGS/EFT/SWIFT>

Parameters

Parameters	Type	Description	Is Required
applicationId	string	The ID of the RTGS/EFT/SWIFT transfer application	TRUE
accountId	string	Account number	TRUE

Response

00000

{
  "applicationId": "",
  "type": "", //1-Domesitc Fund Transfer; 2-Cross-border Fund Transfer
  "debitAccountId": "",
  "beneficiaryBankName": "",
  "beneficiaryBankCode": "",
  "beneficiaryBranchCode": "",
  "beneficiaryBankCountry": "",
  "beneficiaryBankCity": "",
  "beneficiaryBankAddress": "",
  "beneficiaryName": "",
  "beneficiaryEmail": "",
  "beneficiaryAccountId": "",
  "beneficiaryAccountCurr": "",
  "requestAmtType": "",//0-In debit account currency; 1-in beneficiary account currency
  "requestAmt": "",//requested transfer amount in the selected requestAmtType
  "transferAmt": "",//Actual transfer amount in debit account currency
  "bankCharge": "",
  "debitAmt": "",
  "chargeType": "",
  "paymentChannel": "",
  "paymentPurposeId": "",
  "paymentPurpose": "",
  "senderAddress": "",
  "messageToBeneficiary": "",
  "supportDocument": "",
  "supportDocumentType": "",
  "txId": "",
  "refundTxId": "",
  "referenceNumber": "",
  "createTime": "",
  "updateTime": "",
  "status": "",
  "errorCode": "",
  "errorMsg": "",
  "exchangeRate": "",
}