Checkout
Check the payment status

Get payment status

To get a checkout payment status, process as follow:

End point: {BASE_URL}/api/gateway/checkout/status/{{checkout_ID}}

Request method: GET

curl --location --request GET '{{BASE_URL}}/api/gateway/checkout/status/{{checkout_ID}}' \
--header 'x-api-key: live_xxxxxxxxxxxxxxx' \
--header 'mode: live' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic xxxxxxxxxx' \

Request params

ParamètreMandatoryDescription
checkout_IDYesL'identifiant unique qui identifie la transaction dans votre système et qui a été généré à l'initialisation du paiement

Response body :

{
    "status": "SUCCESS",
    "statusCode": 200,
    "message": "Checkout Payment Details",
    "data": {
        "id": 168,
        "checkout_id": "PU_payment_8da2310b-a9d5-4c9c-836e-9cc13b718939",
        "transaction_id": "IY74m4ayzWU8Wgo",
        "mode": "payment",
        "checkout_mode": "TEST",
        "status": "PENDING|FAILED|CANCELLED|SUCCESS",
        "phone_number_collection": true,
        "address_collection": true,
        "notify_url": "https://example.com/notify",
        "checkout_card_redirect_url": "http://payunit-staging-checkout.s3-website.us-east-2.amazonaws.com/check-status",
        "cancel_url": "https://example.com/cancel",
        "success_url": "https://example.com/success",
        "total_amount": 10,
        "currency": "XAF",
        "updated_at": "2023-07-10T13:58:45.586Z",
        "transaction": {
            "id": 85,
            "transaction_id": "Pu-CK-1688997260698",
            "card_payment_url": null,
            "amount": 10,
            "currency": "XAF",
            "mode": "payment",
            "username": "xxxx",
            "message": "If you have not yet received an alert, please dial #150*50# and enter your PIN to confirm the payment ",
            "status": "PENDING|FAILED|CANCELLED|SUCCESS",
            "updated_at": "2023-07-10T13:58:45.528Z",
            "created_at": "2023-07-10T13:54:26.220Z",
            "deleted_at": null
        }
    }
}
Last updated on July 25, 2023