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",
    "message": "SUCCESS",
    "data": {
        "transactionRef": "dfce0d4d-0bdb-47b3-9cc9-b2e0f7905dac",
        "merchantRef": "de76d2c9-b4e7-4122-a066-d52fe2b5842e",
        "currency": "NGN",
        "method": "TRANSFER",
        "amount": 100,
        "paidAmount": 100,
        "fee": 5.5,
        "status": "Success"
    }
}

🟠401Unauthorized

🟠403Forbidden

🔴500Server Error

Initiate

Webhook