Transaction Post

An endpoint to save the transaction data and posting data from both the Payment Gate Provider and System Integrator.

To get the details of the transaction data and posting data, send the following request header parameter.

Transaction Post

Request Samples

Gov curlGov payload

curl
    -L -X POST 'https://fs-api.billeroo.com/transaction/post' \
    -H 'Authorization: {integratorToken}' \
    -H 'Content-Type: application/json' \
    --data-raw '{
    "payment": 
        {
            "billAmount": "<BILL_AMOUNT>",
            "serviceFee": "<SERVICE_FEE>",
            "totalAmountPaid": "<TOTAL_AMOUNT>",
            "paymentDate": "<YYYY-MM-DD HH:MM:SS>",
            "postingDate": "<YYYY-MM-DD HH:MM:SS>",
            "gatewayReference": "<GATEWAY_REFERENCE>",
            "sku": "<SKU>",
            "option": "<PAYMENT_OPTION>"
        },
        "merchantReference": "<MERCHANT_REFERENCE>",
        "customParameters": { "<customParameters>":
        }

    }'
    'https://fs-api.billeroo.com/transaction/post'

{

    "payment": {
            "billAmount": "{Amount}",
            "serviceFee": "{Fee}",
            "totalAmountPaid": "{amountPaid}",
            "paymentDate": "{paymentDate}",
            "postingDate": "{postingDate}",
            "gatewayReference": "{gatewayReference}",
            "sku": "{sku}",
            "option": "{option}"
        },
    "merchantReference": "{merchantReference}",
    "customParameters": {
        "test": "test parameters"

    }
}

200 Successful Response

400 Bad Request

401 Unauthorized Response

422 Unprocessible Entity

Response Samples

Post Successful ResponsePost 422 Unprocessible EntityPost 400 Bad RequestPost 401 Unauthorized Reqeust

{
    "timestamp": "2026-02-11 11:24:16.632 +0000",
    "status": 200,
    "message": "OK",
    "path": "/transaction/post",
    "data": {
        "reference": "FB260211112416HQ0CRA1",
        "statusDescription": "Payment Posted",
        "statusCode": "OK.00.05"
    }
}

{
    "timestamp": "2026-02-11 11:10:37.218 +0000",
    "status": 422,
    "error": "Unprocessable Entity",
    "messages": {
        "payment.gatewayReference": [
            "This field is required."
        ]
    },
    "path": "/transaction/post"
}

{
    "timestamp": "2026-02-11 11:10:37.418 +0000",
    "status": 400,
    "error": "Bad Request",
    "path": "/transaction/post"

}

{
    "timestamp": "2026-02-11 11:10:37.167 +0000",
    "status": 401,
    "error": "Unauthorized",
    "path": "/transaction/post"
}