Merchant Payments – Jenga Docs

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

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

Request Parameters

Field Name	Field Type	Field Description
`merchant.till`	`string`	Equity Till number to receive funds (Credit Account)
`payment.ref`	`string`	Unique reference for payment
`payment.amount`	`string`	payment amount up to 2 decimal places
`payment.currency`	`string`	payment currency E.g KES
`partner.id`	`string`	This is the partber source account for the partner (Debit account)
`partner.ref`	`string`	This is the partner reference, Has to be Unique

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'

200 Success Response Schema

Field Name	Field Type	Field Description
`status`	`string`	SUCCESS or FAILURE
`merchantName`	`string`	name of merchant receiving the payment
`transactionId`	`string`	payment transaction id

Example Response

{
    "status": "SUCCESS",
    "merchantName": "A N Other",
    "transactionId": "931118931118"
}

Bill Payments Bill Validation