Imt Pesalink Bankaccount

IMT Pesalink - To Bank Account

Test URL

POSThttps://uat.finserve.africa/v3-apis/transaction-api/v3.0/remittance/pesalinkacc/imt

Live URL

POSThttps://api.finserve.africa/v3-apis/transaction-api/v3.0/remittance/pesalinkacc/imt

This web service enables an application to send money to a PesaLink participating bank. It is restricted to Kenya.

⚠️

This service is only available in Kenya

📘 Pesalink Participating Banks

To check whether your recipient's bank is participating on PesaLink, go to partners link (opens in a new tab)

200 Success Response Schema

Field Name	Field Type	Field Description
`status`	`string`	Response status
`code`	`number`	Response code
`message`	`string`	Response message
`data.transactionId`	`string`	unique transaction id
`data.status`	`string`	Transaction status

Example Request

⚠️

In the example below, please remember to replace the variables enclosed within curly brackets {{ }} with the actual values.

Signature Formula

transfer.amount+transfer.currencyCode+transfer.reference+destination.name+source.accountNumber

Request Fields

Field Name	Field Type	Required	Description
`source.countryCode`	`string`	Yes	The country code of the sender's bank account.
`source.name`	`string`	Yes	The name of the account holder.
`source.accountNumber`	`string`	Yes	The account number of the sender.
`sender.name`	`string`	Yes	The name of the sender.
`sender.documentType`	`string`	Yes	The document type (e.g., NationalId).
`sender.documentNumber`	`string`	Yes	The document number of the sender.
`sender.countryCode`	`string`	Yes	The country code of the sender.
`sender.mobileNumber`	`string`	Yes	The mobile number of the sender.
`sender.email`	`string`	Yes	The email address of the sender.
`destination.type`	`string`	Yes	The type of destination (e.g., bank).
`destination.countryCode`	`string`	Yes	The country code of the destination account.
`destination.name`	`string`	Yes	The name of the destination account holder.
`destination.bankCode`	`string`	Yes	The bank code of the recipient's bank.
`destination.accountNumber`	`string`	Yes	The destination account number.
`destination.mobileNumber`	`string`	Yes	The mobile number of the recipient.
`destination.documentType`	`string`	Yes	The document type (e.g., NationalId) of the recipient.
`destination.documentNumber`	`string`	Yes	The document number of the recipient.
`transfer.type`	`string`	Yes	The type of transfer (e.g., Pesalink).
`transfer.amount`	`string`	Yes	The amount to be transferred.
`transfer.currencyCode`	`string`	Yes	The currency code (e.g., KES).
`transfer.date`	`string`	Yes	The date of the transfer.
`transfer.description`	`string`	No	A description of the transfer.

Example Request

curl --request POST \
     --url https://uat.finserve.africa/v3-apis/transaction-api/v3.0/remittance/pesalinkacc/imt \
     --header 'Authorization: Bearer TofFGUeU9y448idLCKVAe35LmAtL' \
     --header 'Content-Type: application/json' \
     --header 'signature: huKUSJ1mKy67ptMCDHgSADgPmN8h6Wm5ZYKfLoTJSHWDtA+i2Ra1e3Wc12Pp3Z/Nk+g2JcTGrvWPVw3BCae9QiFI8YpU+GPvezIOmOJvZupo09khePH2nz8TZGKuR6mRhcXd1RNc4dnE6UQbAeqpqPoXbJwOA+02RtfhSDJeLao9bRat4vGWTAlWe/T+mgzMvudeeIpToZLMvBtUVVlLuZFyQb0GeeW9YOghEqfgyzC+6Gpjtg9lnZfDDdAc3fFnGSZ3S0hgaalK94RZSNuF/7OCFKHm5Rv2Q+X91YSqL3Ka3YKkiDfS8kE2w0/8GsWp5WrZo/n3NUTkFonVvucb6w==' \
     --data '
        {
            "source": {
                "countryCode": "KE",
                "name": "John Doe",
                "accountNumber": "0011547896523"
            },
            "sender": {
                "name": "Sender Name",
                "documentType": "NationalId",
                "documentNumber": "12345",
                "countryCode": "KE",
                "mobileNumber": "0763000000",
                "email": "sender.name@example.com"
            },
            "destination": {
                "type": "bank",
                "countryCode": "KE",
                "name": "A N.Other",
                "bankCode": "03",
                "accountNumber": "101080530003",
                "mobileNumber": "0763123456",
                "documentType": "NationalId",
                "documentNumber": "123456"
            },
            "transfer": {
                "type": "Pesalink",
                "amount": "1000",
                "currencyCode": "KES",
                "date": "2018-08-18",
                "description": "some remarks here"
            }
        }
        '

Example Response

{
    "status": true,
    "code": 0,
    "message": "success",
    "data": {
      "transactionId": "",
      "status": "SUCCESS"
    }
}

Mobile Wallets Pesalink - Mobile