n1coePayDocs Referencia del API

Cobra con tarjeta sin tocar los datos de la tarjeta

Tu servidor llama al API de ePay y tu página muestra el formulario de n1co.js. El número de la tarjeta nunca pasa por ninguno de los dos.

EmpezarReferencia del API

Dos superficies de integración#

API de ePay, en tu servidor#

Usa tu llave secreta sk_…. Crea sesiones de tarjeta y payment intents, lee pagos y reembolsos, y recibe webhooks firmados.

n1co.js, en tu página#

Usa tu llave pública pk_…. Muestra el card element en un iframe de n1co, guarda tarjetas y confirma pagos con 3D Secure.

No hay un recurso de clientes: el cliente viaja dentro de cada solicitud, con tu propio id, su nombre, correo y teléfono.

Cómo fluye un pago#

Flujo de un pago con n1co ePay Tu servidor crea un payment intent con la llave secreta, con el monto, la moneda y el cliente, y entrega el client secret a tu página. La página llama a confirmPayment de n1co.js. El frame de n1co.js, en el origen de n1co, envía la tarjeta tokenizada al API y resuelve 3D Secure si el banco lo pide. El API avisa a tu servidor con el webhook payment_intent.succeeded. origen de n1co Tu página llave pública pk_ n1co.js iframe de tarjeta Tu servidor llave secreta sk_ API de ePay n1co 1 POST /v1/payment_intents monto · moneda · cliente 2 id + client_secret 3 client_secret 4 confirmPayment() 5 tarjeta tokenizada · 3D Secure si el banco lo pide 6 payment_intent.succeeded webhook firmado
Las flechas siguen un pago con tarjeta nueva. Con una tarjeta guardada, tu servidor la adjunta en el paso 1.
  1. Tu servidor crea un payment intent con el monto, la moneda y el cliente.
  2. El API responde con el intent y su client_secret.
  3. Tu servidor entrega el client_secret a tu página.
  4. Tu página llama a confirmPayment() de n1co.js.
  5. n1co.js envía la tarjeta tokenizada y muestra 3D Secure si el banco lo pide.
  6. Un webhook avisa a tu servidor, que entrega el pedido.

Guías#