International Money Transfer through Mobile

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

Path : io/v3/organizations/{organizationId}/request
Method: POST
Command ID: InternationalMoneyTransferMobile

Test Account

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

Body

Parameter	Description	Mandatory
commandId	Specifies the command to be executed, in this case, InternationalMoneyTransferMobile	Yes
serviceProviderId	Specifies the service provider for the transfer, Supported service providers are:- MPESA, AIRTELMONEY, TKASH	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 Mobile Wallet Number	Yes
senderType	The type of the entity sending money. E.g COMPANY, INDIVIDUAL	Yes
senderCompanyName	Applicable when senderType is COMPANY	Yes
beneficiaryType	The type of the entity sending money. E.g COMPANY, INDIVIDUAL	Yes
beneficiaryActivity	Beneficiary Activity/Job/Economic Activity. e.g accountant	Yes
beneficiaryCountry	Beneficiary country	Yes
currency	Beneficiary currency	Yes
documentType	Beneficiary legal document type e.g NationalID, Passport	Yes
documentNumber	Beneficiary document numbee.g NationalID, Passportr	Yes
accountName	Beneficiary Account Name	Yes
narration	Narration	Yes
senderName	Sender Name	Yes
senderPhoneNumber	Sender Phone Number	Yes
sender legaDocumentType e.g NationalID, Passport	Sender legall document type. E.g NationalID, Passport	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
ipnUrl	Notification URL	Yes
shortCode	Short code issued by Tanda	Yes

Example

{
  "commandId": "InternationalMoneyTransferBank",
  "serviceProviderId": "MPESA",
  "reference": "FTA5REF919012",
  "request": [
    {
      "id": "amount",
      "value": "10",
      "label": "Amount"
    },
    {
      "id": "mobileNumber",
      "value": "254700000000",
      "label": "Beneficiary Mobile number"
    },
    {
      "id": "accountNumber",
      "value":"254700000000",
      "label": "Beneficiry Account Number"
    },
    {
      "id": "senderType",
      "value": "INDIVIDUAL",
      "label": "Sender Type"
    },
    {
	"id": "senderCompanyName",
	"value": "The Money Company",
	"label": "Sender Company"

	},
    {
      "id": "beneficiaryType",
      "value": "INDIVIDUAL",
      "label": "Beneficiary Type"
    },
    {
      "id": "beneficiaryActivity",
      "value": "accountant",
      "label": "Beneficiary Activity"
    },
    {
      "id": "beneficiaryCountry",
      "value": "KE",
      "label": "Beneficiary country"
    },
    {
      "id": "currency",
      "value": "KES",
      "label": "Sender Currency currency"
    },
    {
      "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": "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": "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"
}