curl -X GET 'https://developers.flouci.com/api/v2/verify_payment/{payment_id}' \
  -H 'authorization: Bearer <APP_PUBLIC>:<APP_SECRET>' \
{
    "success": true,
    "result": {
        "type": "card",
        "amount": 1250,
        "status": "SUCCESS",
        "details": {
            "order_number": "Pb3pNSdyRRWOBdXHDTEdBw",
            "name": "FOULEN BEN FOULEN",
            "pan": "450921**1119",
            "payment_system": "VISA",
            "expiration": "202612",
            "approval_code": "182848",
            "currency": "788",
            "phone_number": "",
            "email": "",
            "bank_country_code": "",
            "destinations": []
        },
        "developer_tracking_id": "your_internal_tracking_id"
    },
    "status_code": 200,
    "name": "developers",
    "code": 0,
    "version": "2.0.0"
}
This endpoint allows you to check the status of a payment using the payment_id returned by the Generate Payment endpoint. In this endpoint, it is crucial to ensure that the “success” field is true before attempting to parse the API’s content. Once confirmed, the payload will reveal the precise status of the transaction at the time of the API call. The transaction status can be one of the following:
  • SUCCESS: This indicates that the transaction has been confirmed and the payment was successful.
  • PENDING: The session is still active, and a payment can still be confirmed.
  • EXPIRED: The session has expired, and no payment is expected.
  • FAILURE: The payment has failed, and details regarding the failure, including the reason, are accessible via the API.
To confirm a payment, it is essential to verify that the “success” field is true and the status is “SUCCESS”. It is advisable to invoke this function upon receiving a success or failure webhook to confirm the transaction’s status. However, it is important to avoid making multiple successive calls (pings) to prevent rate limiting and potential IP bans.
curl -X GET 'https://developers.flouci.com/api/v2/verify_payment/{payment_id}' \
  -H 'authorization: Bearer <APP_PUBLIC>:<APP_SECRET>' \

Path Parameters

payment_id
string
required
The ID of the payment to verify.
{
    "success": true,
    "result": {
        "type": "card",
        "amount": 1250,
        "status": "SUCCESS",
        "details": {
            "order_number": "Pb3pNSdyRRWOBdXHDTEdBw",
            "name": "FOULEN BEN FOULEN",
            "pan": "450921**1119",
            "payment_system": "VISA",
            "expiration": "202612",
            "approval_code": "182848",
            "currency": "788",
            "phone_number": "",
            "email": "",
            "bank_country_code": "",
            "destinations": []
        },
        "developer_tracking_id": "your_internal_tracking_id"
    },
    "status_code": 200,
    "name": "developers",
    "code": 0,
    "version": "2.0.0"
}