Saltar al contenido principal
POST
Create Customer Session
Crea una sesión de cliente para inscribir y gestionar métodos de pago. Úsala para guardar tarjetas, billeteras y otros métodos de pago para uso futuro. Requiere un customer_id de Crear cliente.

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
account_id
string
requerido

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

country
enum<string>
requerido

El país del cliente (MAX 2; MIN 2; ISO 3166-1).

Opciones disponibles:
AR,
BO,
BR,
CL,
CO,
CR,
EC,
SV,
GT,
HN,
MX,
NI,
PA,
PY,
PE,
US,
UY
customer_id
string
requerido

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

callback_url
string

La URL a la que se redirige a tu cliente después de realizar la inscripción en el entorno del proveedor (MAX 526; MIN 3).

checkout_id
string

El identificador único (UUID) del Custom Checkout que se usará para esta sesión de inscripción. Opcional. Si se omite, la sesión usa el checkout predeterminado de la cuenta.

metadata
object[]

Etiquetas personalizadas opcionales de clave y valor para el método de pago inscrito con esta sesión. Se comportan como el metadata de una inscripción directa: se almacenan con el método de pago inscrito, se devuelven cuando lo recuperas y en el webhook enrollment.enroll, y se envían a la integración del proveedor junto con la inscripción, excepto la entrada reservada gateway_options, que se almacena y se devuelve, pero no se reenvía. Hasta 120 elementos y 75000 caracteres en total, contando cada clave y cada valor.

Respuesta

201

customer_session
string
Ejemplo:

"7dd71f21-9e4c-439a-9c6d-58f240bd28df"

customer_id
string
Ejemplo:

"ae106483-65ee-463b-8782-9794022b3112"

country
string
Ejemplo:

"US"

callback_url
string
Ejemplo:

"https://www.google.com/?customerSession=7dd71f21-9e4c-439a-9c6d-58f240bd28df"

created_at
string
Ejemplo:

"2025-05-07T20:00:18.721786Z"

checkout_id
string
Ejemplo:

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

metadata
array