Transactions

Refund a transaction

Changed on Sep 26, 2026

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

Request

Base URL
https://apicore.stg.finch.lat
Auth
HTTP bearer
TypeScript
https://skmtc.dev/monato/apis/fincore-api/docs/v1/clients/:clientId/transactions/:transactionId/refund/post.ts
A function with typed inputs. Its response is checked against the schema.

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 required

Decimal amount as a string with exactly two decimal places.

descriptionstring required

Text with the refund reason

Example request

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

Response

Refund successfully created

idstring uuid required

Refund transaction UUID.

bankIdstring uuid required

Bank UUID used by the original transaction account.

clientIdstring uuid required

Client UUID that owns the refund.

externalReferencestring required

Reference associated with the refund transaction.

trackingIdstring required

Tracking key assigned to the refund for reconciliation.

descriptionstring required

Refund concept or reason.

amountstring required

Decimal amount as a string with exactly two decimal places.

currency'MXN' required

category'CREDIT_TRANS' | 'DEBIT_TRANS' | 'INTER_TRANS' | 'OTHER' required

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": "Supplier payment",
  "amount": "5000.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"
  }
}

Changes

Sep 26, 2026e22ef66945df Revision changes
- breaking
  added to the request property allOf list
- breaking
  the request property became required
- breaking
  the request property became required
- breaking
  the request property type changed from string to no type
- breaking
  the response's property format changed from decimal to no format for status
- warning
  the request property's maxLength was set to 40
- warning
  added the new CANCELLED enum value to the response property for the response status
- warning
  added the new CREDIT_TRANS enum value to the response property for the response status
- warning
  added the new DEBIT_TRANS enum value to the response property for the response status
- warning
  added the new DECLINED enum value to the response property for the response status
- warning
  added the new INITIALIZED enum value to the response property for the response status
- warning
  added the new INTER_TRANS enum value to the response property for the response status
- warning
  added the new INT_ADJ_CREDIT enum value to the response property for the response status
- warning
  added the new INT_ADJ_DEBIT enum value to the response property for the response status
- warning
  added the new INT_CREDIT enum value to the response property for the response status
- warning
  added the new INT_DEBIT enum value to the response property for the response status
- warning
  added the new IN_PROGRESS enum value to the response property for the response status
- warning
  added the new LIQUIDATED enum value to the response property for the response status
- warning
  added the new MXN enum value to the response property for the response status
- warning
  added the new OTHER enum value to the response property for the response status
- warning
  added the new OTHERS enum value to the response property for the response status
- warning
  added the new REFUNDED enum value to the response property for the response status
- warning
  added the new REJECTED enum value to the response property for the response status
- warning
  added the new SPEI_CREDIT enum value to the response property for the response status
- warning
  added the new SPEI_DEBIT enum value to the response property for the response status
- warning
  added the new SPEI_REFUNDED enum value to the response property for the response status
- warning
  added the new SPEI_REFUNDED_CREDIT enum value to the response property for the response status
- warning
  added the new SPEI_REFUNDED_DEBIT enum value to the response property for the response status
- info
  api tag Transactions added
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response's property pattern ^[0-9]+\.[0-9]{2}$ was added for the status

Operation history