---
title: "get refund by id"
method: GET
path: "/v3/payments/{payment-id}/refunds/{refund-id}"
---

# get refund by id

`GET /v3/payments/{payment-id}/refunds/{refund-id}`

## Request

- Base URL: `https://merchant.api.preprod.bancontact.net`
- URL: `https://merchant.api.preprod.bancontact.net/v3/payments/{payment-id}/refunds/{refund-id}`
- Auth: API key in header `Signature`
- TypeScript: <https://skmtc.dev/bancontactpro/apis/payment-refund-service-api/docs/v3/payments/:payment-id/refunds/:refund-id/get.ts> (a function with typed inputs; its response is checked against the schema)

Endpoint to get refund details by id.

## Path parameters

- `payment-id` string, required
- `refund-id` string, required

## Response `200`

return refund details

- RefundModel: refund details
  - `refundId` string, required: refund identifier
  - `paymentId` string, required: payment identifier
  - `amount` integer, required: Amount in cents
  - `currency` 'EUR', required: currency code. Only EUR is supported [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217)
  - `status` 'PENDING' | 'REFUNDED' | 'FAILED', required: * _PENDING_ - refund request accepted by Bancontact Company, will be processed soon * _REFUNDED_ - refund request successfully processed and money moved from merchant to debtor * _FAILED_ - refund request processing failed for technical reasons, money movement didn't happen
  - `description` string: refund description
  - `creationDate` string, date-time, required: timestamp, when refund was created

## Other responses

- `400`: Error codes: * _VALIDATION_ERROR_ - request validation failed
- `401`: If JWS signature is not valid. Error codes: * _UNAUTHORIZED_ - caller doesn't have valid authentication credentials
- `403`: Error codes: * _ACCESS_DENIED_ - operation not allowed, caller doesn't have required authorities
- `404`: Error codes: * _REFUND_NOT_FOUND_ - refund not found * _PAYMENT_NOT_FOUND_ - payment not found
- `500`: Error codes: * _TECHNICAL_ERROR_ - technical error
- `503`: Service is unavailable

---

[API](https://skmtc.dev/bancontactpro/apis/payment-refund-service-api.md) - [All operations](https://skmtc.dev/bancontactpro/apis/payment-refund-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bancontactpro/apis/payment-refund-service-api/revisions/7a8f360b4e8a?raw)