Saltar al contenido principal
POST
Cancelar o reembolsar un pago (dos tarjetas)
Esta solicitud cancela o reembolsa un pago creado con Create Payment (two cards). No se necesita transaction_id: Yuno cancela cada tarjeta que solo está autorizada y reembolsa cada tarjeta que fue cobrada.
Montos parcialesamount es opcional. Si lo omites, se cancela o reembolsa el pago completo. Si lo envías, Yuno lo reparte entre las tarjetas, empezando por la tarjeta con el mayor monto reembolsable. Un amount superior al monto reembolsable total del pago es rechazado.
La respuesta es 201 con el pago en el formato v2.
Mientras una tarjeta tiene un contracargo abierto, los reembolsos son rechazados con INVALID_STATUS.
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.

Cuerpo

application/json
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
description
string

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

merchant_reference
string

Identificación de la transacción de pago definida por el comercio. Si no se define merchant_reference, se asocia a la transacción el merchant_order_id del pago. (MAX 255; MIN 3).

amount
object

Opcional. Monto a reembolsar entre ambas tarjetas, empezando por la tarjeta con mayor monto reembolsable. Si supera el monto total reembolsable, la solicitud se rechaza. Si lo omites, el pago completo se cancela o se reembolsa.

customer_payer
object

Indica el objeto customer de los pagos.

payment_method
object

Especifica el objeto de método de pago para los pagos.

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