Saltar al contenido principal
POST
Esta solicitud inscribe un método de pago para un cliente. Con la información que Yuno proporciona después de que el cliente selecciona el método de pago a inscribir, podrás guardarlo para compras futuras en el objeto de método de pago creado. Ten en cuenta que esta solicitud requiere un X-Idempotency-Key. Consulta Authentication.
WebhooksRecomendamos escuchar Webhooks para mantenerte al día con el estado de los métodos de pago inscritos de tus clientes.
Si un cliente inscribe la misma tarjeta dos veces pero con una nueva fecha de vencimiento o con otros datos del titular de la tarjeta, daremos de baja la inscripción de la tarjeta inscrita anteriormente y conservaremos la nueva.

Métodos de pago disponibles para la inscripción

Los siguientes métodos de pago pueden inscribirse usando este endpoint:
Disponibilidad de métodos de pagoCuando obtienes los métodos de pago disponibles para inscribir, solo estarán presentes los que hayas conectado, para los que hayas creado una ruta y que hayas agregado a tu checkout. Para más información sobre los flujos de inscripción, consulta la guía Enroll Payment Methods.

Autorizaciones

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

Parámetros de ruta

customer_session
string
requerido

La sesión de cliente creada para la inscripción mediante el endpoint Create Customer Session (UUID, 36 caracteres).

Cuerpo

application/json
account_id
string
requerido

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

payment_method_type
enum<string>
requerido

El tipo de método de pago (MAX 255; MIN 3; Lista de tipos de pago).

Opciones disponibles:
CARD,
MERCADO_PAGO_WALLET,
NEQUI,
BANCOLOMBIA_TOKENBOX,
NU_PAY_ENROLLMENT
country
enum<string>
requerido

El código de país de la transacción (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
account_updater
boolean

Control por tarjeta para Card Account Updater. Cuando se define en false, esta tarjeta se excluye de Card Account Updater y no recibirá actualizaciones automáticas de los datos de la tarjeta. Cuando se omite, la tarjeta sigue la configuración de Account Updater de tu cuenta. Se aplica en la inscripción.

payment_method
object

Opciones de inscripción opcionales para el método de pago.

verify
object

Indica si se debe verificar el pago con una transacción de verificación o no. Necesitas tener un proveedor definido en tu ruta CARD. False por defecto. Accede a la página Verificación de tarjetas para más detalles.

Respuesta

201

id
string
Ejemplo:

"0395199e-a99c-4a85-acac-6c916f43fa74"

account_id
string
Ejemplo:

"493e9374-510a-4201-9e09-de669d75f256"

name
string
Ejemplo:

"Visa Credit Card"

description
string
Ejemplo:

"Visa Credit Card"

type
string
Ejemplo:

"VISA"

category
string
Ejemplo:

"CARD"

country
string
Ejemplo:

"US"

status
string
Ejemplo:

"READY_TO_ENROLL"

created_at
string
Ejemplo:

"2024-06-06T13:14:18.799434Z"

updated_at
string
Ejemplo:

"2024-06-06T13:14:18.799437Z"

enrollment
object
provider
object
customer_payer
object
verify
object
preferred
any