Guides & Tutorials
Jenga API
MPGS Direct Integration
Query Payment

MPGS Query Payment

Test URL

POSThttps://uat.finserve.africa/mpgs-direct-integration/api/v3.1/transactionStatus

Live URL

POSThttps://api-unt.finserve.africa/mpgs-direct-integration/api/v3.1/transactionStatus

This API will query the status of a transaction.

200 Success Response Schema

Field NameField TypeField Descriptions
statusboolResponse status
codenumberResponse code
messagestringResponse message
dataobjectResponse data
transactionReferencestringTransaction reference
orderReferencestringThe order reference
paymentTransactionIdstringPayment transaction id
amountnumberTransaction amount
chargenumberTransaction charge
actualAmountnumberTransaction actual amount
refundedAmountnumberRefunded amount
stagestringTransaction stage e.g., REFUND
statestringTransaction status e.g., SUCCESS
cardSchemestringThe card scheme

Example Request

⚠️

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

Signature Formula
transactionReference+orderReference
Example Request
curl --request POST \
     --url https://uat-unt.finserve.africa/mpgs-direct-integration/api/v3.1/transactionStatus \
     --header 'Authorization: {{token}}' \
     --header 'content-type: application/json' \
     --data '
            {
                "transactionReference": "TRANREF0000001",
                "orderReference": "OR8982982928299"
            }
'

Example Response

Example Response
{
    "status": true,
    "code": 0,
    "message": "Transaction was successful",
    "data": {
        "transactionReference": "TRANREF0000001",
        "orderReference": "OR8982982928299",
        "paymentTransactionId": "1",
        "cardNumber": "512345xxxxxx0008",
        "amount": 100.56,
        "charge": 3.52,
        "actualAmount": 104.08,
        "refundedAmount": 0.0,
        "cardScheme": "MASTERCARD",
        "stage": "PAYMENT",
        "state": "SUCCESS",
        "transactionReceipt": "328523195675"
    }
}