Emite un reembolso total o parcial

POST

payment

{id}

refund

curl -X POST https://api.therius.io/v1/payment/9f8b2c1e-4d5a-6b7c-8d9e-0f1a2b3c4d5e/refund \
  -H "Authorization: Bearer prv_production_your_key_here" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantCode": "MERCHANT_001",
    "amount": { "currency": "USD", "value": 4999, "exponent": 2 }
  }'

{
  "id": "9f8b2c1e-4d5a-6b7c-8d9e-0f1a2b3c4d5e",
  "status": "refunded",
  "paymentCode": "PC-1234567890",
  "orderCode": "ORDER-20240101-001",
  "merchantCode": "MERCHANT_001",
  "amount": { "currency": "USD", "value": 4999, "exponent": 2 }
}

Usa POST /payment/{id}/refund para devolver fondos a un titular de tarjeta después de que un pago ha sido capturado y liquidado. Puedes emitir un solo reembolso total o varios reembolsos parciales — siempre que el monto acumulado reembolsado no exceda el total capturado originalmente. Los reembolsos suelen aparecer en el estado de cuenta del titular de la tarjeta dentro de 5–10 días hábiles, según su banco.

Identificar el pago

{id} es el id de pago de Therius devuelto por POST /payment/authorization y POST /payment/purchase. orderCode y paymentCode son tus propios campos de referencia y no se aceptan aquí. Un id desconocido o no propio devuelve 404.

Ejemplos

Reembolso total

curl -X POST https://api.therius.io/v1/payment/9f8b2c1e-4d5a-6b7c-8d9e-0f1a2b3c4d5e/refund \
  -H "Authorization: Bearer prv_production_your_key_here" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantCode": "MERCHANT_001",
    "amount": { "currency": "USD", "value": 4999, "exponent": 2 }
  }'

{
  "id": "9f8b2c1e-4d5a-6b7c-8d9e-0f1a2b3c4d5e",
  "status": "refunded",
  "paymentCode": "PC-1234567890",
  "orderCode": "ORDER-20240101-001",
  "merchantCode": "MERCHANT_001",
  "amount": { "currency": "USD", "value": 4999, "exponent": 2 }
}

Reembolso parcial

Reembolsar solo parte de un pedido — por ejemplo, un solo artículo devuelto de una compra de varios artículos:

curl -X POST https://api.therius.io/v1/payment/9f8b2c1e-4d5a-6b7c-8d9e-0f1a2b3c4d5e/refund \
  -H "Authorization: Bearer prv_production_your_key_here" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantCode": "MERCHANT_001",
    "reference": "RETURN-98765",
    "amount": { "currency": "USD", "value": 1999, "exponent": 2 }
  }'

{
  "id": "9f8b2c1e-4d5a-6b7c-8d9e-0f1a2b3c4d5e",
  "status": "refunded",
  "paymentCode": "PC-1234567890",
  "orderCode": "ORDER-20240101-001",
  "merchantCode": "MERCHANT_001",
  "amount": { "currency": "USD", "value": 1999, "exponent": 2 }
}

No puedes reembolsar un pago que está en el estado authorized (aún no capturado). Para liberar una autorización que no se ha capturado, usa Cancel en su lugar. Intentar reembolsar un pago no capturado devuelve un error.

Se permiten varios reembolsos parciales. Puedes llamar a este endpoint varias veces contra el mismo id de pago, siempre que el monto acumulado de reembolso no exceda el monto capturado original. Cada llamada debe usar un Idempotency-Key distinto.

Si no estás seguro de si un pago está en el estado authorized o captured, usa Cancel or Refund en su lugar — detecta el estado automáticamente y toma la acción apropiada.

Autorizaciones

Authorization

string

header

requerido

Your secret API key: Bearer prv_production_xxx (production) or Bearer prv_sandbox_xxx (sandbox).

Encabezados

Idempotency-Key

string<uuid>

A UUID you generate per operation. Required in production. Retrying with the same key returns the original response.

Parámetros de ruta

string<uuid>

requerido

The Therius payment id returned by POST /payment/authorization or POST /payment/purchase.

Cuerpo

application/json

merchantCode

string

requerido

Your merchant account identifier. Validated against the Bearer key's merchant; required if the key maps to more than one merchant account.

amount

object

requerido

Show child attributes

reference

string

Optional internal reference for this refund operation.

Respuesta

200 - application/json

Refund result

Result of a capture, refund, cancel or cancel_or_refund.

string

The Therius payment id.

merchantCode

string

orderCode

string

paymentCode

string

Therius receipt ID.

amount

object

Show child attributes

status

enum<string>

Outcome of the operation.

Opciones disponibles:

captured,

refunded,

cancelled,

failed

curl -X POST https://api.therius.io/v1/payment/9f8b2c1e-4d5a-6b7c-8d9e-0f1a2b3c4d5e/refund \
  -H "Authorization: Bearer prv_production_your_key_here" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantCode": "MERCHANT_001",
    "amount": { "currency": "USD", "value": 4999, "exponent": 2 }
  }'

{
  "id": "9f8b2c1e-4d5a-6b7c-8d9e-0f1a2b3c4d5e",
  "status": "refunded",
  "paymentCode": "PC-1234567890",
  "orderCode": "ORDER-20240101-001",
  "merchantCode": "MERCHANT_001",
  "amount": { "currency": "USD", "value": 4999, "exponent": 2 }
}

Pagos

Tokenización

Suscripciones

Planes

Sesión del SDK

Emite un reembolso total o parcial

Identificar el pago

Ejemplos

Reembolso total

Reembolso parcial

Autorizaciones

Encabezados

Parámetros de ruta

Cuerpo

Respuesta

​Identificar el pago

​Ejemplos

​Reembolso total

​Reembolso parcial

Autorizaciones

Encabezados

Parámetros de ruta

Cuerpo

Respuesta

Identificar el pago

Ejemplos

Reembolso total

Reembolso parcial