Saltar al contenido principal
POST
Esta solicitud crea un pago financiado por exactamente dos tarjetas. Cada tarjeta paga su parte de amount, y las dos partes deben sumar amount.value. La URL base es https://api-sandbox.y.uno/v2 en sandbox y https://api.y.uno/v2 en producción. Lee Pay with two cards antes de integrar.
  • DIRECT o REDIRECT: envía payment_method.payment_methods con exactamente dos elementos, ambos con type: CARD. Cada elemento tiene su amount y detail.card o un vaulted_token.
  • SDK_CHECKOUT: envía checkout.session y el payment_method.token compuesto del headless Web SDK. No envíes payment_methods.
payment_method.capture se aplica a ambas tarjetas y por defecto es true. No envíes capture dentro de detail.card: la solicitud se rechaza. La respuesta tiene la misma estructura que Retrieve Payment (two cards).
Todo o nadaSi una tarjeta falla, Yuno revierte la otra tarjeta antes de responder esta solicitud, por lo que la respuesta ya muestra el resultado final. Consulta All or nothing.
HabilitaciónEn producción, los pagos con dos tarjetas se habilitan por organización. Hasta entonces, esta solicitud devuelve 403 PRODUCT_NOT_ENABLED. En sandbox están habilitados para todas las organizaciones.
split_marketplace, external_subscription y amount.currency_conversion no están permitidos con dos tarjetas, y no se aceptan cotizaciones de promociones. 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."

Cuerpo

application/json
account_id
string<uuid>
requerido

El id de tu cuenta de Yuno.

merchant_order_id
string
requerido

El id de tu orden (MIN 3; MAX 255).

description
string
requerido

Descripción del pago (MIN 3; MAX 255).

country
string
requerido

Código de país ISO 3166-1 alpha-2.

amount
object
requerido

Total del pago. Debe ser igual a la suma de los montos de las dos tarjetas. No se permite amount.currency_conversion.

workflow
enum<string>
requerido

DIRECT o REDIRECT con payment_method.payment_methods, o SDK_CHECKOUT con checkout.session y el payment_method.token compuesto.

Opciones disponibles:
DIRECT,
REDIRECT,
SDK_CHECKOUT
payment_method
object
requerido
customer_payer
object
requerido

Obligatorio. El pagador, compartido por ambas tarjetas. Mismos campos que en Crear pago.

merchant_reference
string

Tu referencia del pago (MIN 3; MAX 255).

checkout
object

Obligatorio para SDK_CHECKOUT.

callback_url
string

Opcional. Dónde se devuelve al cliente después de un desafío 3DS o una redirección.

additional_data
object

Opcional, como en v1.

metadata
object[]

Respuesta

Pago creado. Lee status y sub_status, y luego las transactions de cada tarjeta.

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