Saltar al contenido principal

Crear un Método de pago

POST 
/v1/payment-methods

Consultá la documentación de ONVO para ver detalles de integración y ejemplos.

Para evitar errores 400 de validación al enviar card, validá que card.holderName sea texto no vacío, card.number sea un string de dígitos sin espacios ni separadores y que pase Luhn, card.expMonth sea un entero entre 1 y 12, card.expYear sea un entero entre 2023 y 2100, y card.cvv sea un string de 3 o 4 dígitos cuando lo enviés.

Para cuentas de comercio creadas en Perú, el cliente asociado al método de pago debe tener correo electrónico al crear métodos de pago. Podés enviar customer.email en el payload para crear y asociar el cliente en la misma solicitud, o enviar customerId de un cliente creado previamente con el atributo email.

Cuando creás un método de pago de tipo card, ONVO tokeniza y verifica la tarjeta antes de crear el objeto. Si la tokenización falla por datos inválidos, el endpoint responde 400 con code: "cards.invalid_card_info" y no se crea ningún método de pago.

Solicitud​

Respuestas​

Respuesta exitosa