Refund

The refund process allows you to return funds to the customer after a successful payment. A refund can only be initiated for a completed payin transaction. To find out in which solutions a refund is available, please check with your account manager.

Important

Refund is available only for orders with status completed.

The refund amount must not exceed the original order amount.

Partial refunds are allowed — the amount can be less than the original payment.

The refund flow is asynchronous and depends on whether the refund is full or partial:

For full refunds, the transaction starts in status new and transitions directly to a final status: completed or rejected.

For partial refunds, the transaction starts in status new, transitions to processing, and then to a final status: completed or rejected.

API

Request

{
  "amount": "10",
  "refundReason": "Test",
  "id": "50f86dd8-85b3-4172-9fde-b67f3ae7991f",
  "merchantOrderId": "merchant-id-111"
}

Response

{
  "error": {
    "code": "",
    "validationErrors": [
      {
        "field": "",
        "message": ""
      }
    ]
  },
  "data": {
    "id": "50f86dd8-85b3-4172-9fde-b67f3ae7991f",
    "merchantOrderId": "1753791234",
    "type": "payin",
    "createdAt": "2025-07-30T12:22:10Z",

    // Status of order
    "status": "completed",
    
    "refundTransaction": {
      "id": "83e7994a-25d3-4e3a-90c7-cc71c0fd6612",
      "status": "new",
      "type": "refund",
      "amount": {
        "amount": "10.23",
        "currency": "clp"
      },
      "createdAt": "2025-07-30T12:25:44Z"
    }
  }
}