Refunds

Create Refund

Issue a refund against a payment

post/v1/aggregators/{raast-aggregator-id}/refunds

Request

Base URL: https://api.getsafepay.com/raastwire
URL: https://api.getsafepay.com/raastwire/v1/aggregators/{raast-aggregator-id}/refunds
Auth: API key in header X-SFPY-AGGREGATOR-SECRET-KEY

Request body

request_idstring uuid required

Client-supplied UUID v4 idempotency key (exactly 36 characters with hyphens).

payment_idstring required

amountinteger required

reason'TechnicalProblem' | 'DuplicatePayment' required

addtl_infostring

debitor_ibanstring required

Example request

{
  "request_id": "9af69842-3011-4d6b-98d0-c3de1caa96d3"
}

Response

This response contains details of a refund

api_versionstring

The current version of the API spec

Example response

{
  "api_version": "v1",
  "data": {
    "msg_created_at": "2025-03-13T09:12:34Z",
    "created_at": "2025-03-13T09:12:34Z",
    "updated_at": "2025-03-13T09:12:34Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.