Soluciones

El API de ZRU permite tres tipos de integraciones, cada una se adapta a diferentes necesidades permitiéndo que sea cual sea el escenario al que quieres llegar, lo puedas hacer a través del API.

Puedes ver un ejemplo de cada cada tipo de integración en la sección Nuestra solución de la web.

A través del Panel de ZRU también se pueden generar enlaces de pago para enviar al cliente y realizar cobros sin necesidad de utilizar el API.

Redirect

Esta sería la integración más sencilla de todas, después de unas pocas líneas ya estamos recibiendo pagos.

El flujo sería el siguiente:

1. El usuario solicita pagar el pedido.
2. Se crea la órden de pago a través del API de ZRU (utilizando la llave pública y privada obtenida en el Panel de ZRU).
3. El API de ZRU devuelve la información de la solicitud, y con ella creamos la url de redirección.
4. Se redirige al usuario a la url de redirección, que sería la pantalla de pago de ZRU.
5. El usuario regresa a la url de retorno enviada al crear la órden de pago en caso de que finalice el pago correctamente, en caso de que el usuario cancele el pago, regresará a la url de cancelación enviada igualmente al crear la órden de pago.

*. ZRU enviará una notificación confirmando el pago a la url de notificación enviada al crear la órden de pago. Igualmente, enviará notificaciones en caso de que se produzcan cambios relacionados con el pago, o error, o en caso de que sea una suscripción o autorización avisará de cada pago recibido.

iFrame

Es bastante similar a Redirect, la única diferencia es que el usuario nunca sale de tu dominio porque se utiliza un iframe para realizar el pago.

1. El usuario solicita pagar el pedido.
2. Se crea la órden de pago a través del API de ZRU (utilizando la llave pública y privada obtenida en el Panel de ZRU).
3. El API de ZRU devuelve la información de la solicitud, y con ella creamos la url de iframe.
4. Se crea un iframe en la interfaz de usuario con la url de iframe.
5. El usuario regresa a la url de retorno enviada al crear la órden de pago en caso de que finalice el pago correctamente, en caso de que el usuario cancele el pago, regresará a la url de cancelación enviada igualmente al crear la órden de pago. Ya estando en estas urls se podría cerrar el iframe.

*. ZRU enviará una notificación confirmando el pago a la url de notificación enviada al crear la órden de pago. Igualmente, enviará notificaciones en caso de que se produzcan cambios relacionados con el pago, o error, o en caso de que sea una suscripción o autorización avisará de cada pago recibido.

Custom

Esta forma de integrar ZRU permite que además de que todo se realice en tu dominio puedes personalizar cada detalle de la experiencia del usuario al pagar.

1. El usuario solicita pagar el pedido.
2. Se crea la órden de pago a través del API de ZRU (utilizando la llave pública y privada obtenida en el Panel de ZRU).
3. El API de ZRU devuelve la información de la solicitud, entre los datos que devuelve estará el token que utilizaremos en el resto de los pasos.
4. Se envía el token a la interfaz de usuario.
5. Se solicitan las pasarelas de pago disponibles para esa órden de pago a través del API de ZRU, utilizando el token y la llave pública.
6. El API de ZRU devuelve la información de las pasarelas y sus tipos.
7. En base al tipo de pasarela pueden ocurrir dos cosas:

• a. En el caso de las pasarelas de tipo card, se enviará la información de la tarjeta al API de ZRU.
• b. En el caso de las pasarelas tipo form, se debe enviar al usuario a la url https://pay.mychoice2pay.com/<token>/redirect/<gateway_code>. El usuario será redirigido entonces a la pasarela para finalizar el pago.

8. La respuesta varia en base a la manera usada entre 7.a y 7.b.

• a. El API de ZRU responde con la confirmación o no del pago. En caso de que sea afirmativo queda completado el pago.
• b. El usuario regresa a la url de retorno enviada al crear la órden de pago en caso de que finalice el pago correctamente, en caso de que el usuario cancele el pago, regresará a la url de cancelación enviada igualmente al crear la órden de pago.

*. ZRU enviará una notificación confirmando el pago a la url de notificación enviada al crear la órden de pago. Igualmente, enviará notificaciones en caso de que se produzcan cambios relacionados con el pago, o error, o en caso de que sea una suscripción o autorización avisará de cada pago recibido.