Fetch payment status

POST

https://secure.finixpayment.com/v1/api/payment/fetch

We strongly recommend that, upon receiving a notification, you verify the transaction with Finix using transactionRef to confirm its actual status before updating your database records.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠401Unauthorized

🟠403Forbidden

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://secure.finixpayment.com/v1/api/payment/fetch' \
--header 'MerchantID: FX100001' \
--header 'Signature: paLAc7iNnnFhOYaKIgukzKXNPHIMES47pFnrnHtZ9LZjRyeqehMeKnb7alAdvB8xkUwOJ7y4V1tMSIDXh2otHi2NAxpOMZBrE4D9JWqhEPWQQMJrjrqousC9pfibDXP0I6lhSFoaV0iAQjTcrpfz2ONSpswz3pvYy27UJtldai6gBx1eI2PztrWiotsMojx7TcERibfXjP0wY8mScGePSUxjWThkKK5FggBvkKOXyvQe27nZ7isHUEAdAhdbgeRV' \
--header 'Timestamp: 1750554703' \
--header 'Content-Type: application/json' \
--data-raw '{
    "transactionRef": "2c4d9ff6-dc9a-4bee-a751-18071257685c"
}'

Response Example

200 - SUCCESS

{
    "code": "200",
    "message": "SUCCESS",
    "data": {
        "transactionRef": "481ef975-be6a-4f2b-abe0-ea9263d26791",
        "merchantRef": "0110b711-697b-4341-b8f2-9043ef7bd8a9",
        "currency": "INR",
        "method": "NATIVE",
        "amount": 100.01,
        "paidAmount": 100.01,
        "fee": 5.5,
        "status": "Success"
    }
}

Modified at 2026-04-07 17:04:45

Create payment

Payment webhook (async notification)