Manual Post Reference

An endpoint that will allow the integrator to manually post biller reference number.

To manually post biller reference number, send the request headers and body parameters via POST.

POST/post

Manual Post Reference

Request Samples

curlpayload

curl
    -L -X POST 'https://test-api.billeroo.com/post' \
    -H 'Authorization: {integratorToken}' \
    -H 'Content-Type: application/json' \
    -d '{
        "reference": "{transactionReference}",
        "biller": "{jwtString}",
        "paymentDate": "yyyy-mm-dd hh:mm:ss +00:00",
        "fields": [
            {
                "field": "1",
                "value": "{PRN}"
            },
            {
                "field": "2",
                "value": "{Manual Posting Types}"
            },
            {
                "field": "3",
                "value": "{Applicable Month Start}"
            },
            {
                "field": "4",
                "value": "{Applicable Month End}"
            }
        ]
    }'

{
    "reference": "{transactionReference}",
    "biller": "{jwtString}",
    "paymentDate": "yyyy-mm-dd hh:mm:ss +00:00",
    "fields": [
        {
        "field": "1",
        "value": "{PRN}"
        },
        {
        "field": "2",
        "value": "{Manual Posting Types}"
        },
        {
        "field": "3",
        "value": "{Applicable Month Start}"
        },
        {
        "field": "4",
        "value": "{Applicable Month End}"
        }
    ]
}

200 Successful Response

401 Erroneous Response

405 Erroneous Response

Response Samples

Manual Post Reference Successful ResponseManual Post Reference 401 Erroneous ResponseManual Post Reference 405 Erroneous Response

{
    "timestamp": "2024-11-08 06:48:45.283 +0000",
    "status": 200,
    "message": "OK",
    "path": "/post",
    "data": {
        "reference": "B2411080648422ZO5ID4",
        "statusDescription": "Payment Posted",
        "statusCode": "OK.00.05"
    }
}

{
    "timestamp": "2024-11-08 07:22:51 +0000",
    "status": 401,
    "error": "Unauthorized",
    "path": "/post"
}

{
    "timestamp": "2024-11-08 07:23:41 +0000",
    "status": 405,
    "error": "Method Not Allowed",
    "message": "Invalid Biller Code",
    "path": "/post"
}