Skip to main content
POST
Refund a payment

Authorizations

x-api-key
string
header
required

Path Parameters

id
string<uuid>
required

The unique identifier of the payment method

paymentId
string<uuid>
required

The unique identifier of the payment to refund

Body

application/json

Request body for refunding a payment. Refunds are always for the full charge amount.

reason
string

Reason for the refund. Useful for accounting and auditing purposes.

Example:

"Customer requested cancellation"

Response

Payment refunded successfully

Response after refunding a payment

id
string<uuid>
required

Unique identifier of the payment

Example:

"11111111-2222-3333-4444-555555555555"

status
enum<string>
required

Payment status after refund

Available options:
REFUNDED
amount
number<decimal>
required

The refunded amount

currency
string
required
Example:

"MXN"

externalId
string | null

The idempotency key supplied when the payment was created, echoed back so you can map this payment id to your own order reference. Null when none was supplied. Not to be confused with the payment method externalId, which identifies the saved card.

Example:

"invoice-2025-01-8842"