Status

Time	Status	User Agent
Retrieving recent requests…

Transaction Status API

This API allows you to check the current status of a payment initiated through the EdfaPay platform.

Endpoint

GET https://demo-api.edfapay.com/api/v1/transactions/filterTransaction?id=xxxxxx

Authentication

All requests must include a valid X-API-KEY in the request header.

The API key must be sent from the server side and should never be exposed on the client side.

👉 How to generate API key

🔐
Security Note

Always send API requests from your backend.

Do not expose your API Key in frontend applications.

Example Request

curl --location 'https://demo-api.edfapay.com/api/v1/transactions/filterTransaction?id=xxxxxxxxxxxxxxxxx' \
--header 'X-API-KEY: <Your API Key>'

Query Parameters

Field	Type	Required	Description
id	string	Yes	Unique transaction ID from EdfaPay (UUID).

🚧
Important Note

You can get the id from the Dashboard (Transaction ID) or from the webhook response using transactionId.

Response Example

{
  "code": 200,
  "message": "Success",
  "errorCode": null,
  "data": {
    "content": [
      {
        "transactionId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "orderId": "XXXXXXXX",
        "amount": "1.00",
        "currencyCode": "682",
        "transactionStatus": "FAILED",
        "paymentStatus": "DECLINED",
        "businessUnitId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "channel": "PAYMENT_GATEWAY",
        "rrn": null,
        "transactionType": "PURCHASE",
        "reconciliationStatus": "UNSETTLED",
        "reconciliationAt": null,
        "acquirerBank": null,
        "providerTid": null,
        "holderAccount": null,
        "cardScheme": null,
        "cardChannel": "PHYSICAL_CARD",
        "cardSequenceNumber": null,
        "pan": "5123 45** **** 0008",
        "cardExpiration": "2039/01",
        "cardHolderName": "XXXXXXXX",
        "createdAt": "2026-04-06T14:13:40.265071",
        "finishedAt": "2026-04-06T14:13:41.979423",
        "createdBy": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "createdByName": "XXXXXXXX",
        "totalRefundAmount": "0.00",
        "refundStatus": "NONE",
        "merchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "recurringToken": null,
        "declineReason": "No PaymentURL returned"
      }
    ],
    "number": 0,
    "size": 30,
    "totalElements": 1,
    "hasContent": true,
    "numberOfElements": 1,
    "totalPages": 1,
    "first": true,
    "last": true
  }
}

Important Notes

📘
Key Notes

This API is used for post-transaction validation and reconciliation.

Ensure the id matches the transaction ID returned in the original payment response.

Always verify transaction status before updating order state in your system.