v1

latestOpenAPI 3.0.32026-07-248079274.0 KB

Transactions

Process a refund

Process a refund for a specific payment. Append the required transaction_id to the URL and enter the amount to be refunded in the body of the request.

post/transactions/{transaction_id}/refund

Path parameters

transaction_idstring uuid required

Unique ID assigned by Acquired.com for the transaction.

Request body

amountnumber float required

The total amount you want to refund.

referencestring

Where supported by the bank, set the reference to appear on the customer's bank statement.

Example request

{
  "amount": 15.02,
  "reference": "Custom Ref 001"
}

Response

Created

transaction_idstring uuid

Unique identifier assigned by Acquired.com for the transaction.

status'success' | 'declined' | 'blocked' | 'pending'

Example response

{
  "transaction_id": "a7e3fde5-5b83-44f4-9915-782bc7121717",
  "status": "success",
  "retry_advice": {
    "category": "retry_later",
    "detail": null,
    "retry_after": "2026-03-04T00:00:00Z",
    "acquirer_code": "25"
  },
  "links": [
    {
      "rel": "self",
      "href": "/v1/transactions/a7e3fde5-5b83-44f4-9915-782bc7121717"
    }
  ]
}