Get refund status

Retrieve Refund Status

get

Retrieve the status of a previously created refund. You can trigger the check of the status of a refund at any moment you consider pertinent. However, every time a refund changes its status, we will send you a notification containing the ID of the refund so that you can check its status back to retrieve the new refund's status.

Regarding the Authorization value, since the body of the requests will be empty, you should use an empty ("") string or nothing as the jsonPayload field for generating the signature.

Path parameters

refund_idintegerRequired

Directa24 refund_id. It is obtained when creating the refund.

Example: 1682844

Query parameters

voucherbooleanOptional

true / false value. The request with true value will return the refund invoice in base64 to be decoded to create a .pdf file.

Header parameters

Content-TypestringRequired

Media type of the request. For GET, this is typically application/json if any specific content negotiation is implied by the server, even without a body.

Default: application/json

X-Datestring · date-timeRequired

ISO8601 Datetime with Timezone (yyyy-MM-dd'T'HH:mm:ssZ).

Example: 2023-05-27T10:30:00Z

X-LoginstringRequired

Merchant X-Login API Key.

Example: your-x-login-key

AuthorizationstringRequired

Authentication signature. The signature is generated based on specific headers and an empty payload for GET requests.

Example: D24-HMAC-SHA256 SignedHeaders=x-date;x-login, Signature=your_signature_hash

X-Idempotency-Keystring · uuidOptional

Unique idempotency key for ensuring that the same request is not processed more than once. (Generally more applicable for state-changing requests like POST, PUT, DELETE).

Example: a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11

Responses

200

Refund status successfully retrieved.

application/json

401

Unauthorized access. This could be due to an invalid X-Login, X-Date, or Authorization signature.

application/json

404

The refund with the specified refund_id could not be found.

application/json

get

HTTPcURLJavaScriptPython

GET /v3/refunds/{refund_id} HTTP/1.1
Host: api-stg.directa24.com
Content-Type: application/json
X-Date: 2023-05-27T10:30:00Z
X-Login: your-x-login-key
Authorization: D24-HMAC-SHA256 SignedHeaders=x-date;x-login, Signature=your_signature_hash
Accept: */*

{
  "deposit_id": 300533569,
  "merchant_invoice_id": "84044",
  "status": "COMPLETED",
  "amount": 100
}