Liquida una autorización previa

POST

payment

{id}

capture

curl -X POST https://api.therius.io/v1/payment/9f8b2c1e-4d5a-6b7c-8d9e-0f1a2b3c4d5e/capture \
  -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": 9900, "exponent": 2 }
  }'

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

Llama a POST /payment/{id}/capture para liquidar fondos de un POST /payment/authorization anterior. Puedes capturar menos que el monto total autorizado — una captura parcial — y la retención restante se libera automáticamente. Debes llamar a este endpoint dentro de la ventana de autorización del adquirente (normalmente 7 días) o la retención expirará y necesitarás volver a autorizar.

Identificar el pago

{id} es el id de pago de Therius devuelto en la respuesta a POST /payment/authorization (y POST /payment/purchase). Guárdalo cuando creas el pago. orderCode y paymentCode son tus propios campos de referencia — no se aceptan como forma de direccionar el pago para captura, reembolso o cancelación. Un id que no existe, o que pertenece a otro comercio, devuelve 404.

Ejemplo

Captura total

curl -X POST https://api.therius.io/v1/payment/9f8b2c1e-4d5a-6b7c-8d9e-0f1a2b3c4d5e/capture \
  -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": 9900, "exponent": 2 }
  }'

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

Captura parcial

curl -X POST https://api.therius.io/v1/payment/9f8b2c1e-4d5a-6b7c-8d9e-0f1a2b3c4d5e/capture \
  -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": 7500, "exponent": 2 }
  }'

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

Cuando realizas una captura parcial, Therius libera automáticamente la retención restante ($24.00 en el ejemplo anterior). No necesitas enviar una solicitud de cancelación separada para la porción no capturada.

Solo puedes capturar un pago autorizado una vez. Si necesitas capturar un monto diferente después de que ya se procesó una captura parcial, necesitarás crear una nueva autorización.

Pasa siempre un Idempotency-Key en la captura. Si tu servidor agota el tiempo de espera y reintentas, la misma clave garantiza que no liquidarás dos veces la misma autorización.

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 capture operation.

commercialData

object

Level 2/3 card data for this capture. Send it when the data was not sent with the authorization or when the captured amount or lines differ from it. Validated against this capture amount.

Show child attributes

lineItems

object[]

Line items for the Level 3 breakdown of this capture. Used only when commercialData is also sent.

Show child attributes

Respuesta

200 - application/json

Capture 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,

canceled,

failed

curl -X POST https://api.therius.io/v1/payment/9f8b2c1e-4d5a-6b7c-8d9e-0f1a2b3c4d5e/capture \
  -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": 9900, "exponent": 2 }
  }'

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

Pagos

Enlaces de pago

Tokenización

Suscripciones

Subscription Plans

Sesión del SDK

Liquida una autorización previa

Identificar el pago

Ejemplo

Captura total

Captura parcial

Autorizaciones

Encabezados

Parámetros de ruta

Cuerpo

Respuesta

​Identificar el pago

​Ejemplo

​Captura total

​Captura parcial

Autorizaciones

Encabezados

Parámetros de ruta

Cuerpo

Respuesta

Identificar el pago

Ejemplo

Captura total

Captura parcial