Saltar al contenido principal
POST
Cancelar pago (dos tarjetas)
Esta solicitud cancela una tarjeta autorizada de un pago creado con Create Payment (two cards). La cancelación es por tarjeta: envía el id de la transacción AUTHORIZE de esa tarjeta en payment_method.payment_methods[].transactions. Para cancelar el pago completo en una sola solicitud, usa Cancel or Refund a Payment (two cards). 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 cancelación 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).

description
string

Descripción de la cancelación. (MAX 255; MIN 3)

reason
enum<string>

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

Opciones disponibles:
DUPLICATE,
FRAUDULENT,
REQUESTED_BY_CUSTOMER

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[]