Transaction Status

POST

https://api.formaxpay.com/api/gift_voucher/txn_status

This API is used to check the transaction status of a gift voucher purchase using the Partner Order ID or Formax Order ID.
It helps partners verify whether a voucher transaction is successful, pending, or failed and retrieve voucher details if already issued.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.formaxpay.com/api/gift_voucher/txn_status' \
--header 'Authorization: Basic UVRNRlRKckJjRWt5RnBETGtCSGpkV0dMYnFBclFwbkE6Rm9ybWF4QDEyMw==' \
--header 'Content-Type: application/json' \
--data-raw '{
    "order_id": "TGV66455078125001EPRHD"
}'

Response Example

{
    "status": "SUCCESS",
    "message": "Transaction Details Fetched Successfully",
    "data": {
        "txn_status": "SUCCESS",
        "txn_description": "Transaction Successful",
        "brand_id": 3,
        "brand_name": "Amazon Shopping",
        "quantity": 1,
        "denomination": 500,
        "order_id": "GV07397460937500CENUA",
        "p_order_id": "TGV66455078125001EPRHD",
        "order_amount": "500.00",
        "txn_type": "DR",
        "opening_bal": "780597.12",
        "closing_bal": "780106.62",
        "commercial_amount": "9.50",
        "timestamp": "2025-12-12 16:8:34",
        "vouchers": [
            {
                "voucher_no": "SV8T-A957K4-NRN",
                "voucher_pin": "6014868794024249",
                "voucher_gc_code": "6014868794024249",
                "value": "500.00",
                "expiry_date": "11 Dec 2026"
            }
        ]
    }
}

Modified at 2025-12-24 12:32:46

Pull Voucher

PAN Verification