Saltar al contenido principal
POST
Esta solicitud crea una sesión de checkout con el identificador único que se generó al crear el recurso customer.
Si tu workflow requiere enviar el objeto additional_data, puedes enviarlo como parte de la sesión de checkout.

Autorizaciones

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

Cuerpo

application/json
merchant_order_id
string
requerido

El identificador único del pedido del cliente (MAX 255; MIN 3).

payment_description
string
requerido

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

country
string
requerido

País donde se debe procesar la transacción (MAX 2; MIN 2; ISO 3166-1).

account_id
string
requerido

El identificador único de la cuenta. Encuentras este dato en el dashboard de Yuno (UUID, 36 caracteres).

customer_id
string

El identificador único del cliente, creado con el endpoint Create Customer (UUID, 36 caracteres).

callback_url
string

La URL a la que redirigimos a tu cliente después de la compra. Es obligatoria en los métodos de pago alternativos con redirección. (MAX 526; MIN 3)

amount
object

Indica el objeto del monto del pago, con el valor y la moneda.

alternative_amount
object

Representación del monto de la transacción en una moneda alternativa.

shipping_methods
object[]

Opciones de entrega que el cliente puede elegir dentro del widget de una billetera (Fast Checkout). El primer método viene preseleccionado. La moneda de cada monto debe coincidir con la moneda de la sesión.

metadata
object[]

Indica una lista de objetos de metadata. Puedes agregar hasta 120 objetos de metadata.

workflow
enum<string>

Tipo de workflow del checkout.

Opciones disponibles:
SDK_CHECKOUT,
CHECKOUT,
SDK_SEAMLESS
installments
object

El objeto para enviar el plan de cuotas creado en Yuno que se les muestra a tus clientes para que elijan. Este campo opcional se usa cuando la sesión necesita un plan de cuotas en particular. Si no se envía, se muestra el plan de cuotas creado para la cuenta en cada caso, si existe.

recurring_payment
object

Objeto opcional para habilitar y configurar pagos recurrentes (suscripciones).

checkout_id
string

El identificador único (UUID) del Custom Checkout que se usa en esta sesión. Opcional. Si se omite, la sesión usa el checkout predeterminado de la cuenta. El checkout debe ser una configuración de checkout publicada en la misma cuenta que la sesión; si no, la API rechaza la solicitud con 400 INVALID_CHECKOUT_CODE.

wallet_card_acceptance
object

Opcional. Limita las tarjetas que el cliente puede elegir en la hoja de pago de Apple Pay. Las tarjetas que no coinciden se muestran en gris. Todos los campos son opcionales; un campo que no se envía mantiene el comportamiento predeterminado. Los valores deben ir en mayúsculas, y una lista vacía se rechaza con 400 INVALID_PARAMETERS. Solo se puede definir al crear la sesión.

summary_items
object[]

Desglose del pedido que muestra la hoja de la billetera (al menos un elemento; el último es el total general). La moneda de cada monto debe coincidir con la moneda de la sesión. Cuando también se envía shipping_methods, Apple Pay usa en su lugar los summary_items del primer método; Google Pay hace lo mismo solo cuando está registrado el handler de la dirección de envío.

Respuesta

200

merchant_order_id
string
Ejemplo:

"1717681150"

checkout_session
string
Ejemplo:

"c437f4cc-7d66-40e6-a8df-7c3cde1ddca7"

country
string
Ejemplo:

"US"

payment_description
string
Ejemplo:

"Test Cards"

customer_id
string
Ejemplo:

"55006822-7c79-490b-bea1-81798b9afc74"

callback_url
string | null
Ejemplo:

"https://www.example.com/?checkoutSession=c437f4cc-7d66-40e6-a8df-7c3cde1ddca7"

amount
object
created_at
string
Ejemplo:

"2023-07-20T17:06:17.232130Z"

metadata
object[] | null
workflow
string
Ejemplo:

"SDK_CHECKOUT"

installments
object
checkout_id
string
Ejemplo:

"6822f80c-684e-41a3-8628-78963d3d60f7"

used
boolean

Usado.

Ejemplo:

false