🚧
Esta funcionalidad se encuentra en estado Beta. Si desea acceso anticipado, póngase en contacto con nosotros.

Para realizar la devolución de una transacción pagada con tarjetas, necesita tener al alcance el identificador de la transacción, el monto a reembolsar, y el detalle de las deudas a reembolsar (identificador y monto) si aplica.

A continuación se muestran algunos ejemplos de peticiones de devoluciones. Para más detalles, refiera a la documentación de la API.

Devolución de pagos on-demand

POST /refund/transaction

{
  "id_transaction": "trs_id123456abcdefg",
  "reason": "refund reason",
  "refund_amount": 2000
}

Devolución de pagos delegados

POST /refund/transaction

Existen campos opcionales para el manejo de invoices en modo delegado. Si no se especifican, se asumirá la devolución total de de las invoices (pagado por la transacción a reembolsar) y el valor por defecto de las configuraciones. Refiera a la documentación de la API para más detalles.

{
  "id_transaction": "trs_id123456abcdefg",
  "reason": "refund reason",
  "refund_amount": 500,
  "void_invoices": false,
  "disable_automatic_payments": false, 
  "mark_invoices_as_unpaid": true,
  "invoice_refund_details": [
    {
      "id_invoice": "in_id123456abcdefg",
      "refund_amount": 500
    }
  ]
}

Devolución parcial de invoice

Si desea realizar una devolución parcial de una invoice, debe indicar el detalle a través del campo invoice_refund_details, y además debe anular la invoices a través del campo void_invoices.

Desactivar cobro automático

Si desea que no se cobre automáticamente una invoice luego de realizar un reembolso, debe configurar el campo disable_automatic_paymentscomo true. Sin embargo, el cliente podría volver a pagar la invoice de forma manual a través del portal. Para evitar esto, debe anular la invoice mediante el campo void_invoices.

Devoluciones por invoice

Alternativamente, es posible realizar una devolución indicando el identificador de la invoice a reembolsar. Refiera a la documentación de la API para más detalles.

{
    "id_invoice": "in_iAJmTQp-l7Xeb0rcVKTBvLGMNlcwCtL5",
    "reason": "test refund",
    "refund_amount": 1012
}

Respuesta

Exito

{
  "id": "trs_refund_123",
  "success": true,
  "error": null,
  "receipt_url": "https://url-comprobante-devolucion",
  "additional_data": {
    "provider_external_id": "trs_gateway_id",
    "response_code": "gateway_response_code"
  }
}

ℹ️
La devolución podría no verse reflejada inmediatamente, dependiendo del banco del cliente.

Error

{
  "id": "trs_refund_123",
  "success": false,
  "error": "Tarjeta Rechazada",
  "receipt_url": null,
  "additional_data": {
    "provider_external_id": "trs_gateway_id",
    "response_code": "gateway_response_code"
  }
}