Get Transaction Details by TransactionId
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
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/{transactionId}/details
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.
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/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/details' \
--header 'X-API-KEY: YOUR_API_KEY'Query Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| transactionId | string | Yes | Unique transaction ID from EdfaPay (UUID). |
Important Note
You can get the transactionId from the Dashboard (Transaction ID) or from the webhook response using transactionId.
Response Example
{
"code": 200,
"message": "Success",
"errorCode": null,
"data": {
"transactionDetails": {
"transactionId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"orderId": "XXXXXXX",
"amount": "1.00",
"currencyCode": "682",
"transactionStatus": "SUCCESS",
"paymentStatus": "APPROVED",
"businessUnitId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"channel": "PAYMENT_GATEWAY",
"rrn": "XXXXXXX",
"transactionType": "PURCHASE",
"reconciliationStatus": "UNSETTLED",
"reconciliationAt": null,
"acquirerBank": null,
"providerTid": "XXXXXXX",
"holderAccount": null,
"cardScheme": "VC",
"cardChannel": "PHYSICAL_CARD",
"cardSequenceNumber": null,
"pan": "4111 11** **** 1111",
"cardExpiration": "2039/01",
"cardHolderName": "XXXXXXX",
"createdAt": "2026-04-20T20:08:13.58487",
"finishedAt": "2026-04-20T20:09:13.800044",
"createdBy": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"createdByName": "XXXXXXX",
"totalRefundAmount": "0.00",
"refundStatus": "NONE",
"merchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"recurringToken": null,
"declineReason": null,
"paymentGatewayTransactionId": "XXXXXXXXXXXXXX",
"reason": null,
"status": null,
"initiateOrderId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"gateway": "EDFAPG",
"settlementStatus": "NOT_SETTLED"
},
"businessUnitHierarchy": {
"businessUnitId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"businessUnitName": "XXXXXXX",
"businessUnitNameAr": "XXXXXXX",
"businessUnitType": "XXXXXXX",
"parent": {
"businessUnitId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"businessUnitName": "XXXXXXX",
"businessUnitNameAr": "XXXXXXX",
"businessUnitType": "XXXXXXX",
"parent": {
"businessUnitId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"businessUnitName": null,
"businessUnitNameAr": null,
"businessUnitType": "XXXXXXX",
"parent": null,
"children": null
},
"children": null
},
"children": null
}
}
}{
"code": 404,
"message": "Entity Transaction not found for fields [id] and values [xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx]",
"errorCode": "404",
"data": null
}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.