Saltar al contenido principal
POST
Capturar autorización (dos tarjetas)
Esta solicitud captura una tarjeta de un pago creado con capture: false en Create Payment (two cards). La captura es por tarjeta: llámala una vez por cada tarjeta, con el id de la transacción AUTHORIZE de esa tarjeta en payment_method.payment_methods[].transactions. Después de la primera captura, el pago queda en SUCCEEDED / PARTIALLY_CAPTURED. Después de ambas, queda en SUCCEEDED / CAPTURED. La respuesta es 201 con el pago en el formato v2.
Mientras el pago está en REFUND_RETRY_IN_PROCESS o CANCEL_RETRY_IN_PROCESS, una captura es rechazada. Consulta Pay with two cards.
Esta solicitud requiere un X-Idempotency-Key. Consulta Authentication para obtener más detalles.

Autorizaciones

public-api-key
string
header
predeterminado:<Your public-api-key>
requerido
private-secret-key
string
header
predeterminado:<Your private-secret-key>
requerido

Encabezados

X-Idempotency-Key
string<uuid>
requerido

Clave única de esta solicitud. Obligatoria en cada solicitud de pago v2. Si el resultado no es claro, reintenta con la misma clave. Sin ella, la solicitud se rechaza con 400 INVALID_PARAMETERS: "The header 'x-idempotency-key' is required."

Parámetros de ruta

payment_id
string<uuid>
requerido

El id del pago devuelto por POST /v2/payments.

transaction_id
string<uuid>
requerido

El id de la transacción de la tarjeta sobre la que operar, de payment_method.payment_methods[].transactions[].

Cuerpo

application/json
merchant_reference
string
requerido

Identificación de la transacción de pago definida por el comercio (MAX 255; MIN 3)

reason
enum<string>
requerido

Motivo de la operación. Los valores posibles son DUPLICATE, FRAUDULENT y REQUESTED_BY_CUSTOMER.

Opciones disponibles:
DUPLICATE,
FRAUDULENT,
REQUESTED_BY_CUSTOMER
amount
object

Opcional. Monto a capturar en esta tarjeta. Si lo omites, se captura el monto autorizado completo de la tarjeta.

additional_data
object

Datos adicionales para complementar la captura del pago

Respuesta

El pago después de la operación, con la estructura v2

Un pago financiado con dos tarjetas.

id
string<uuid>
account_id
string<uuid>
description
string
country
string
status
string

Estado agregado del pago. Consulta Pagar con dos tarjetas.

sub_status
string

Subestado agregado, por ejemplo APPROVED, AUTHORIZED, PARTIALLY_CAPTURED, PARTIALLY_REFUNDED, REFUND_RETRY_IN_PROCESS o CANCEL_RETRY_IN_PROCESS.

merchant_order_id
string
merchant_reference
string
created_at
string<date-time>
updated_at
string<date-time>
split_payment_methods
boolean

true para un pago financiado con dos tarjetas.

payment_methods_count
integer

Número de tarjetas que financian el pago: 2.

sdk_action_required
boolean

true cuando el SDK debe continuar el pago, por ejemplo para ejecutar un desafío 3DS.

amount
object

Total del pago.

checkout
object
payment_method
object
customer_payer
object

El pagador, tal como se envió en la solicitud.

additional_data
object | null
callback_url
string
workflow
enum<string>
Opciones disponibles:
DIRECT,
REDIRECT,
SDK_CHECKOUT
metadata
object[]