Get Refund Info
Refunds — Get Refund Info
3 min readUpdated Mar 27, 2026
GET /api/v1/refunds/card/info/{id}
Retrieve the full details of a refund transaction.
Guide: Initiating a Refund — conceptual walkthrough, flow diagrams, and integration patterns.
#Headers
| Header | Value |
|---|---|
Authorization | Bearer {token} — see Authentication |
#Request
No request body. The transaction ID is passed as a path parameter.
| Parameter | Type | Description |
|---|---|---|
id | String | The unique transaction identifier returned when the transaction was created. |
#Response
| Field | Type | Description |
|---|---|---|
transactionId | String | Unique transaction identifier assigned by Exirom. Use this ID to query status, retrieve info, or reference the transaction in support requests. |
refundId | String | Unique identifier for the refund transaction. |
requestId | String | Unique identifier for the request. Used for idempotency — if you retry with the same requestId, the system will return the original response instead of processing a duplicate. |
mid | String | Merchant account ID. Identifies which merchant account the transaction is associated with. |
transactionStatus | String (NEW, PENDING, FAILED, REFUNDED, CUSTOMER_VERIFICATION, ...) | Current status of the transaction. See Transaction Status Guide for the full lifecycle. |
declineCode | Integer | Numeric code indicating the reason for a decline. Only present when the transaction is FAILED. See Decline Codes Reference. |
totalAmount | Number | |
callbackUrl | String | Server-to-server webhook URL. Exirom sends a POST with the final transaction result to this URL. See Webhook Callbacks. |
createdAt | String | Timestamp when the transaction was created (ISO 8601 format). |
metadata | Map<String, String> | Arbitrary key-value pairs for your own use (e.g. order reference, campaign ID). Returned unchanged in responses and callbacks. |
{
"transactionId": "example_transactionId",
"refundId": "example_refundId",
"requestId": "req_abc123",
"mid": "merchant_123",
"transactionStatus": "NEW",
"declineCode": 12345,
"totalAmount": 100,
"callbackUrl": "https://yourserver.com/callback",
"createdAt": "example_createdAt",
"metadata": {
"key1": "value1"
}
}#Error Responses
| HTTP Status | Description |
|---|---|
400 | Bad Request — missing or invalid parameters. Check the response body for field-level details. |
401 | Unauthorized — missing, expired, or invalid bearer token. Re-authenticate via POST /api/v1/auth. |
404 | Not Found — the requested resource does not exist. |
500 | Internal Server Error — an unexpected error occurred. Retry with exponential backoff. |
curl -X GET https://sandbox.api.exirom.com/api/v1/refunds/card/info/12345 \
-H "Authorization: Bearer YOUR_TOKEN"#Try It
SandboxTry it
https://sandbox.api.exirom.com/api
id=
Was this helpful?