International Money Transfer through bank

Send money to your customer's bank account in other countries.

Path : io/v3/organizations/{organizationId}/request

Method: POST

Command ID: InternationalMoneyTransferBank

Test Account

organizationId : a353acfa-5340-49ac-8f7c-2f807a87fc2f

shortCode: 746312

Body

Parameter	Description	Mandatory
commandId	Specifies the command to be executed, in this case, InternationalMoneyTransferBank	Yes
serviceProviderId	Specifies the service provider for the transfer, Supported service providers are:- PESALINK	Yes
reference	A unique reference for the transaction. It should be between 8-36 alphanumeric characters.	Yes
request	Object array containing additional request details	Yes

Request Parameters

Parameter	Description	Mandatory
amount	Amount	Yes
mobileNumber	Beneficiary Mobile number	Yes
accountNumber	Beneficiary Bank Account Number	Yes
bankCode	Beneficiary Bank code	Yes
senderType	The type of the entity sending money. E.g COMPANY, INDIVIDUAL	Yes
beneficiaryType	The type of the entity sending money. E.g COMPANY, INDIVIDUAL	Yes
beneficiaryAddress	Beneficiary address	Yes
beneficiaryActivity	Beneficiary Activity/Job/Economic Activity. e.g accountant	Yes
beneficiaryCountry	Beneficiary country	Yes
currency	Beneficiary currency	Yes
beneficiaryEmailAddress	Beneficiary email address	Yes
documentType	Beneficiary document type	Yes
documentNumber	Beneficiary document number	Yes
accountName	Beneficiary Account Name	Yes
narration	Narration	Yes
senderName	Sender Name	Yes
senderAddress	Sender Address	Yes
senderPhoneNumber	Sender Phone Number	Yes
senderDocumentType	Sender document type	Yes
senderDocumentNumber	Sender document number	Yes
senderCountry	Sender country	Yes
senderCurrency	Sender currency	Yes
senderSourceOfFunds	Sender source of funds	Yes
senderPrincipalActivity	Sender principal activity E.g business	Yes
senderBankCode	Sender bank code	No
senderEmailAddress	Sender email address	Yes
senderPrimaryAccountNumber	Sender primary account number	Yes
senderDateOfBirth	Sender date of birth	Yes
ipnUrl	Notification URL	Yes
shortCode	Short code issued by Tanda	Yes

Example

{
  "commandId": "InternationalMoneyTransferBank",
  "serviceProviderId": "PESALINK",
  "reference": "FTA5REF919012",
  "request": [
    {
      "id": "amount",
      "value": "10",
      "label": "Amount"
    },
    {
      "id": "mobileNumber",
      "value": "254742451519",
      "label": "Beneficiary Mobile number"
    },
    {
      "id": "accountNumber",
      "value": "0290175659042",
      "label": "Beneficiry Account Number"
    },
    {
      "id": "bankCode",
      "value": "40468000",
      "label": "Beneficiary Bank code"
    },
    {
      "id": "senderType",
      "value": "INDIVIDUAL",
      "label": "Sender Type"
    },
    {
      "id": "beneficiaryType",
      "value": "INDIVIDUAL",
      "label": "Beneficiary Type"
    },
    {
      "id": "beneficiaryAddress",
      "value": "Mars House, Kasarani",
      "label": "Beneficiary address"
    },
    {
      "id": "beneficiaryActivity",
      "value": "accountant",
      "label": "Beneficiary Activity"
    },
    {
      "id": "beneficiaryCountry",
      "value": "KE",
      "label": "Beneficiary country"
    },
    {
      "id": "currency",
      "value": "KES",
      "label": "Sender Currency currency"
    },
    {
      "id": "beneficiaryEmailAddress",
      "value": "beneficiary@example",
      "label": "Beneficiary email address"
    },
    {
      "id": "documentType",
      "value": "NationalID",
      "label": "Beneficiary document type"
    },
    {
      "id": "documentNumber",
      "value": "1234567",
      "label": "Beneficiary document number"
    },
    {
      "id": "accountName",
      "value": "JOSHUA CHAPAKAZI",
      "label": "Account Name"
    },
    {
      "id": "narration",
      "value": "business",
      "label": "Narration"
    },
    {
      "id": "senderName",
      "value": "Tanda Africa",
      "label": "Sender Name"
    },
    {
      "id": "senderAddress",
      "value": "TRV Office Plaza, Westlands",
      "label": "Sender Address"
    },
    {
      "id": "senderPhoneNumber",
      "value": "254700000000",
      "label": "Sender Phone Number"
    },
    {
      "id": "senderDocumentType",
      "value": "NationalID",
      "label": "Sender document type"
    },
    {
      "id": "senderDocumentNumber",
      "value": "234550",
      "label": "Sender document number"
    },
    {
      "id": "senderCountry",
      "value": "KE",
      "label": "Sender country"
    },
    {
      "id": "senderCurrency",
      "value": "KES",
      "label": "Sender currency"
    },
    {
      "id": "senderSourceOfFunds",
      "value": "Business",
      "label": "Sender source of funds"
    },
    {
      "id": "senderPrincipalActivity",
      "value": "Fintech",
      "label": "Sender principal activity"
    },
    {
      "id": "senderBankCode",
      "value": "40401000",
      "label": "Sender bank code"
    },
    {
      "id": "senderEmailAddress",
      "value": "[email protected]",
      "label": "Sender email address"
    },
    {
      "id": "senderPrimaryAccountNumber",
      "value": "1258259064",
      "label": "Sender primary account number"
    },
    {
      "id": "senderDateOfBirth",
      "value": "2000/03/12",
      "label": "Sender date of birth"
    },
    {
      "id": "ipnUrl",
      "value": "https://tanda-tills-ipn.free.beeceptor.com",
      "label": "Notification URL"
    },
    {
      "id": "shortCode",
      "value": "746312",
      "label": "Short code"
    }
  ]
}

Sample Response

{
  "trackingId": "b5b47bd2-c1da-4b8a-b0de-ffb4ec474bff",
  "reference": "QBQIGRH1",
  "status": "P202000",
  "message": "Successful. Request accepted for processing. You'll be notified by Tanda shortly"
}