Transaction Status Check

Use this API to check the status of initialized transaction

Rate Limit: Maximum of 7 requests allowed per minute for each transaction ID

GET https://checkout.finzen.money/api/v1/payment/transaction/{transaction_id}/status

Headers

Name	Type	Description
MerchantId*	String	Merchant ID, Can be found under Accounts in User Menu
AccessToken*	String	API Token, Can be generated from dashboard, See the Authentication page for more information

Request Body

Name	Type	Description
transaction_id*	String	Transaction ID that was received in response to Initialize Transaction Set this as path parameter in URL

200 Transaction Status retrieved

{
    "status": true,
    "message": "Transaction retrieved successfully",
    "data": {
        "payment_id": "<payment_id>",
        "merchant_email": "<merchant_email>",
        "merchant_id": "<merchant_id>",
        "status": "Success", // Can be Initialized, Success, Failed Or Dropped
        "status_flag": 1, // 1 in case of Success otherwise 0
        "payment_mode": "<payment_method_used>",
        "rrn": "<bank_rrn_no>",
        "order": {
            "order_id": "<order_id>",
            "product_name": "<product_name>",
            "gross_amount": 10,
            "gateway_fee": 0.2,
            "currency": "INR",
            "tax": 0.036
        },
        "customer": {
            "name": "<customer_name>",
            "email_id": "<customer_email>",
            "mobile_no": "<customer_mobile>"
        },
        "shipping": {
            "address": null,
            "city": null,
            "state": null,
            "country": null,
            "pincode": null
        },
        "billing": {
            "address": null,
            "city": null,
            "state": null,
            "country": null,
            "pincode": null
        },
        "custom_field_1": "<custom_field_1>",
        "custom_field_2": "<custom_field_2>",
        "custom_field_3": "<custom_field_3>",
        "custom_field_4": "<custom_field_4>",
        "custom_field_5": "<custom_field_5>",
        "date": "<txn_date>",
        "signature": "<signature_value>"
    }
}

401: Unauthorized

{
    "status": false,
    "message": "Access Token or Merchant Id is not valid",
    "tracking_id": null,
    "error": {
        "error_code": "Unauthorized",
        "error_details": null
    }
}

429: Too Many Requests

{
    "status": false,
    "message": "Too many requests. Please try again later. Limit: 7. Retry after: 40 seconds.",
    "tracking_id": null,
    "error": {
        "error_code": "RATE_LIMIT_EXCEEDED",
        "error_details": {
            "limit": 7,
            "remaining": 0,
            "reset_at": 1750336899,
            "retry_after": 40
        }
    }
}

400 Bad Request

{
    "status": false,
    "message": "Record does not exist",
    "tracking_id": "t_status_21394176462009769039",
    "error": {
        "error_code": "TRANSACTION_NOT_FOUND",
        "error_details": ""
    }
}

It is recommended to verify the signature before processing the response to ensure the data has not been tampered with.

While signature verification ensures authenticity, it is advisable to also validate the transaction amount against your order amount as an additional security measure.

Signature Generation

Initialize dataString as an empty string

Remove the 'signature' key from requestBody if available

Define function getArrayValues(requestBody, dataString):
    For each key-value pair in requestBody:
        If value is an array:
            Call getArrayValues(value, dataString)
        Else:
            Append value + '|' to dataString
    Return dataString

Call getArrayValues(requestBody, dataString)
Append '#' to dataString

Generate signature as HMAC-SHA512 hash of dataString using apiSecret as the key

API Secret is generated along with API Token, See Authentication page for more information