Iniciar: pago simple
Se requieren 3 etapas para integrar un formulario de pago en el sitio web comercial:
- Inicialización del formulario incrustado.
- Visualización del formulario incrustado
- Verificación del estado de la transacción al final del pago.
El esquema siguiente detalla las interacciones entre los diferentes actores (formulario incrustado, servidor del vendedor, plataforma de pago) para cada una de estas etapas:
Servidor Vendedor
Formulaire JavaScript (Navigateur)
Servidor de la Plataforma de Pago.
1. Inicializar el formulario
Antes de visualizar un nuevo formulario de pago en el sitio web comercial, debe inicializar el formulario generando un token del formulario (o formToken) que resume todas las opciones ligadas al pago.
Para crear un formToken, debe llamar al Web Service REST Charge/CreatePayment desde su servidor:
| Etapa | Descripción |
|---|---|
| 1 | Llamado del Web Service REST Charge/CreatePayment desde los servidores del vendedor. |
| 2 | Recepción del resultado que contiene el formToken. |
El formToken es válido durante 15 minutos.
Consulte la lista de los casos de uso para ayudarle a inicializar su formulario.
2. Mostrar el formulario
Para mostrar el formulario de pago, debe incluir nuestra biblioteca de JavaScript en el encabezado de su página de pago.
Es imprescindible que la biblioteca principal se cargue rápidamente, mucho antes que las otras bibliotecas JS utilizadas en su página.
El formToken se debe agregar al código de integración. La biblioteca JavaScript lo usa para mostrar el formulario a partir del formToken definido en la etapa anterior:
| Etapa | Descripción |
|---|---|
| 3 | Descarga de la biblioteca JavaScript. Solicitud realizada desde el navegador del comprador. |
| 4 | Recuperación de JavaScript, enseguida visualización de la página que contiene el formulario de pago. |
Una vez que se muestra el formulario, el comprador puede introducir sus datos bancarios. Si el pago es rechazado, el comprador no sale del sitio web comercial. Si el pago es aceptado, la información de la transacción se envía por el servidor del vendedor.
3. Verificar el estado de la transacción
Una vez aceptada la transacción o cuando se ha alcanzado el número de máximo de intentos, el cliente JavaScript realiza un POST del formulario de pago. Se desarrolla exactamente como si se tratara de un formulario HTML clásico. Usted recupera la información de pago en los parámetros POST enviados a su servidor.
| Etapa | DESCRIPCIÓN |
|---|---|
| 5 | El comprador ha hecho clic en el botón "pagar": envío del formulario desde el navegador del comprador a nuestros servidores. Esta llamada es realizada automáticamente por nuestro cliente JavaScript. |
| 6 | Una vez que la transacción ha sido procesada, hacemos una llamada desde nuestros servidores a una URL que usted ha determinado. El objeto Transacción completo se envía para que actualice su sistema de información antes del retorno al navegador. Se trata de la IPN (Notificación de pago instantánea). |
| 7 | Nuestros servidores reenviarán el resultado del pago al cliente JavaScript. |
| 8 | El cliente JavaScript publicará el formulario de pago en sus servidores. |
Tratar la IPN le permite actualizar su sistema de información de forma más segura y le garantiza no perder ningún pago si el comprador perdiera su conexión a Internet. Para más información, consulte el artículo dedicado a la IPN, aquí: Ipn: Presentación
¡Aquí vamos!
Après cet entremet théorique, il est temps de passer aux choses concrètes : undefined