API Explorer
Receive Money
Merchant Payments

Receive Payments - Merchant Payments

Test URL

POSThttps://uat.finserve.africa/v3-apis/transaction-api/v3.0/tills/pay

Live URL

POSThttps://api.finserve.africa/v3-apis/transaction-api/v3.0/tills/pay

This API Provides Partners the Capability To Make Payments For Goods And Services

200 Success Response Schema

Field NameField TypeField Description
statusstringSUCCESS or FAILURE
merchantNamestringname of merchant receiving the payment
transactionIdstringpayment transaction id

Example Request

⚠️

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

Signature Formula
merchant.till+partner.id+payment.amount+payment.currency+payment.ref
Example Request
curl -X POST \
	-d '{
            "merchant": {
                "till": "0766112112"
            },
            "payment": {
                "ref": "123456789123",
                "amount": "1000.00",
                "currency": "KES"
            },
            "partner": {
                "id": "0011547896523",
                "ref": "987654321"
            }
        }'  \
	-H 'Authorization: Bearer 5fDAgGPdA98EF53ul4YAvR3XWC39'  \
	-H 'signature: e967CLKebZyLfa73/YYltjW5M4cHoyWeHi/5VDKJ64gOwKBvzHJRqJJrBBc34v2m4jyKkDMBtfRJeFlxbNisMAeBtkw0TRcD2LThFK27EOqLM3m8rQYa+7CJ2FhPhK+iOa4RUY+vTfkRX5JXuqOW7a3GHds8qyPaPe19cKUY33eAJL3upXnGnA3/PEhzjhb0pqk2zCI7aRzvjjVUGwUdT6LO73NVhDSWvGpLEsP0dH/stC5BoTPNNt9nY8yvGUPV7fmaPSIFn68W4L04WgePQdYkmD1UPApGcrl+L2ALY3lPaRfI6/N+0Y3NIWQyLgix+69k7V4EGolqejWdion+9A=='  \
	-H 'Content-Type: application/json'  \
	-L 'https://uat.finserve.africa/v3-apis/transaction-api/v3.0/tills/pay'

Example Response

Example Response
{
    "status": "SUCCESS",
    "merchantName": "A N Other",
    "transactionId": "931118931118"
}
Bill PaymentsBill Validation