v1

latestOpenAPI 3.1.02026-08-06173665.4 KB

Refund a transaction

Creates a refund for a transaction. Partial refunds are not allowed. The amount must equal the original transaction amount received.

post/v1/clients/{clientId}/transactions/{transactionId}/refund

Path parameters

clientIdstring uuid required

Client UUID (must match the client_id embedded in the Authorization token).

transactionIdstring uuid required

Transaction UUID to be refunded.

Request body

amountstring

Refund amount (full refund only) — must be exactly equal to the original transaction amount received. Use two decimal places.

descriptionstring

Text with the refund reason

Example request

{
  "amount": "10.00",
  "description": "Invalid amount"
}

Response

Refund successfully created

idstring uuid

bankIdstring uuid

clientIdstring uuid

externalReferencestring

trackingIdstring

descriptionstring

amountstring decimal

currencystring

categorystring

subCategorystring

transactionStatusstring

Example response

{
  "id": "957459ce-d4e3-40b5-b759-373e844ba1e8",
  "bankId": "9d84b03a-28d1-4898-a69c-38824239e2b1",
  "clientId": "c2d1d1e3-3340-4170-980e-e9269bbbc551",
  "externalReference": "2505091",
  "trackingId": "20250510FINCHFL2SFGP9KT",
  "description": "lorem ipsum dolor sit amet",
  "amount": "100.00",
  "currency": "MXN",
  "category": "DEBIT_TRANS",
  "subCategory": "SPEI_DEBIT",
  "transactionStatus": "INITIALIZED",
  "audit": {
    "createdAt": "2025-05-09 18:02:31.979746-06:00",
    "updatedAt": "2025-05-09 18:02:31.979746-06:00"
  }
}