Fetch

POST

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

We strongly recommend that upon receiving our notification, you initiate a transaction verification request using the transactionRef to confirm the actual status of the transaction before updating your database records.

Request

Header Params

Body Params application/json

Example

{
    "transactionRef": "2c4d9ff6-dc9a-4bee-a751-18071257685c"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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"
}'

Responses

🟢200Success

application/json

Body

Examples

SUCCESSFAIL

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

🟠401Unauthorized

🟠403Forbidden

🔴500Server Error

Initiate

Webhook