Exirom Payment API Documentation

GET /api/v1/refunds/card/status/{id}

Retrieve only the current status of a refund transaction.

Guide: Initiating a Refund — conceptual walkthrough, flow diagrams, and integration patterns.

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.

Returns the transaction status as a plain string.

Possible values: NEW, PENDING, PROCESSING, CUSTOMER_VERIFICATION, SUCCEED, FAILED, CANCELLED, REFUNDED, CHARGEBACK.

See Transaction Status Guide for detailed descriptions of each status.

"SUCCEED"

Polling tip: Use this lightweight endpoint for status checks. For full transaction details, use the corresponding /info/{id} endpoint instead.

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/status/12345 \
  -H "Authorization: Bearer YOUR_TOKEN"