Pesalink Bankaccount

Pesalink - To Bank Account

Test URL

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

Live URK

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

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

📘 PesaLink Participating Banks

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

200 Success Response Schema

Field Name	Field Type	Field Description
`transactionId`	`string`	unique transaction id
`status`	`string`	transaction status
`description`	`string`	description

Example Request

⚠️

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

Signature Formulae

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

Request Parameters

Field Name	Data Type	Required	Description
`source.countryCode`	`string`	Yes	Source account country code (e.g., KE for Kenya).
`source.name`	`string`	Yes	Source account name.
`source.accountNumber`	`string`	Yes	Source account number.
`destination.type`	`string`	Yes	Type of destination (e.g., `bank`).
`destination.countryCode`	`string`	Yes	Destination account country code (e.g., KE for Kenya).
`destination.name`	`string`	Yes	Name of the recipient.
`destination.bankCode`	`string`	Yes	Bank code of the recipient's bank (e.g., `57` for the respective bank).
`destination.accountNumber`	`string`	Yes	Destination account number.
`transfer.type`	`string`	Yes	Transfer type (e.g., `PesaLink`).
`transfer.amount`	`string`	Yes	Transfer amount.
`transfer.currencyCode`	`string`	Yes	Transfer currency code (e.g., `KES` for Kenyan Shillings).
`transfer.reference`	`string`	Yes	Unique transaction reference number.
`transfer.date`	`string`	Yes	Transaction date (e.g., `2023-10-11`).
`transfer.description`	`string`	Yes	Transaction description or remarks.

Example Request

curl -X POST \
	-d '{
            "source": {
                "countryCode": "KE",
                "name": "John Doe",
                "accountNumber": "0020100014605"
            },
            "destination": {
                "type": "bank",
                "countryCode": "KE",
                "name": "Tom Doe",
                "bankCode": "57",
                "accountNumber": "99901288715910"
            },
            "transfer": {
                "type": "PesaLink",
                "amount": "500.00",
                "currencyCode": "KES",
                "reference": "112194688993",
                "date": "2023-10-11",
                "description": "Some remarks here"
            }
        }'  \
	-H 'Authorization: Bearer {access_token}'  \
	-H 'Content-Type: application/json'  \
	-H 'signature: e967CLKebZyLfa73/YYltjW5M4cHoyWeHi/5VDKJ64gOwKBvzHJRqJJrBBc34v2m4jyKkDMBtfRJeFlxbNisMAeBtkw0TRcD2LThFK27EOqLM3m8rQYa+7CJ2FhPhK+iOa4RUY+vTfkRX5JXuqOW7a3GHds8qyPaPe19cKUY33eAJL3upXnGnA3/PEhzjhb0pqk2zCI7aRzvjjVUGwUdT6LO73NVhDSWvGpLEsP0dH/stC5BoTPNNt9nY8yvGUPV7fmaPSIFn68W4L04WgePQdYkmD1UPApGcrl+L2ALY3lPaRfI6/N+0Y3NIWQyLgix+69k7V4EGolqejWdion+9A=='  \
	-L 'https://uat.finserve.africa/v3-apis/transaction-api/v3.0/remittance/pesalinkacc'

Example Response

{
    "status": true,
    "code": 0,
    "message": "success",
    "data": {
        "transactionId": "112194688993",
        "status": "SUCCESS",
        "description": "Confirmed. Ksh 500 Sent to 99901288715910 -Tom Doe from your account 0020100014605 on 20-05-2019 at 141313 Ref. 707700078800 Thank you"
    }
}

SWIFT Pesalink - Mobile