v1

latestOpenAPI 3.0.32026-07-248079274.0 KB

Transactions

Process a reversal

Automatically determines whether a payment should be voided or refunded based on settlement status and acquiring bank rules. Supports both full and partial reversals.

post/transactions/{transaction_id}/reversal

Path parameters

transaction_idstring uuid required

Unique ID assigned by Acquired.com for the transaction.

Request body

amountnumber float

The amount to reverse. If omitted, a full reversal is assumed.

referencestring

Unique reference for the reversal (Optional).

webhook_urlstring uri

Webhook URL for receiving async status updates (Optional).

Example request

{
  "amount": 15.02,
  "reference": "Test Reference",
  "webhook_url": "https://acquired.com"
}

Response

Reversal successfully processed

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",
  "links": [
    {
      "rel": "self",
      "href": "/v1/transactions/a7e3fde5-5b83-44f4-9915-782bc7121717"
    }
  ]
}