Integración a través de redirección

La integración a través de redirección es un proceso simple y seguro que utiliza la página de pago del lado de la pasarela de pago. La principal ventaja es que no necesita recopilar y procesar datos de tarjetas en su sitio web. En este caso, la API se utiliza mínimamente, por lo que este método no requiere mucha experiencia de desarrollo.

1. El cliente selecciona un producto en la tienda online y hace clic en el botón Comprar.

2. El servidor de la tienda online recibe la solicitud de compra.

3. El servidor de la tienda online solicita el registro del pedido, enviando una llamada API register.do a la pasarela de pago. Esta solicitud debe contener el parámetro amount (monto del pago en unidades mínimas de la moneda) y el parámetro returnUrl (dirección a la que será redirigido el cliente después del pago exitoso en el paso 9). Más detalles sobre la redirección después del pago aquí aquí.

   Ejemplo de solicitud:

   curl --request POST \
   --url https://dev.bpcbt.com/payment/rest/register.do \
   --header 'content-type: application/x-www-form-urlencoded' \
   --data amount=2000 \
   --data currency=978 \
   --data userName=test_user \
   --data password=test_user_password \
   --data returnUrl=https://mybestmerchantreturnurl.com \
   --data description=my_first_order \
   --data language=en

   También puede retener el monto en la cuenta hasta el débito de fondos con la llamada registerPreAuth.do. Para saber más sobre retención y finalización, haga clic aquí.

4. El servidor de la pasarela de pago registra el pedido y envía una respuesta al servidor de la tienda online. La respuesta contiene el parámetro formUrl (URL de pago al que la tienda online debe redirigir al comprador en el paso 5) y el parámetro orderId (número único del pedido en el sistema de la pasarela de pago, se utilizará en el paso 10).

   Ejemplo de respuesta:

   {
   "orderId": "01491d0b-c848-7dd6-a20d-e96900a7d8c0",
   "formUrl": "https://dev.bpcbt.com/payment/merchants/payment_en.html?mdOrder=01491d0b-c848-7dd6-a20d-e96900a7d8c0"
   }

5. La tienda online redirige al comprador a la URL obtenida en el parámetro formUrl. La redirección puede hacerse en la misma ventana o en una nueva ventana.

6. La pasarela de pago abre el enlace de pago.

7. El cliente introduce el número de su tarjeta, su fecha de vencimiento y CVV/CVC y hace clic en Pagar.

   Como alternativa, se pueden usar pagos tokenizados a través de billeteras Apple Pay, Samsung Pay o Google Pay. En este caso, el comprador selecciona la opción correspondiente. Aprenda más sobre el uso de pagos tokenizados aquí.

8. La pasarela de pago procesa la solicitud de pago.

9. El comprador es redirigido a la página de la tienda online especificada en el parámetro returnUrl (se especifica en el paso 3).
   

10. La tienda online envía una solicitud getOrderStatusExtended.do a la pasarela de pagos para verificar el estado del pedido y asegurarse de que el pedido realmente esté pagado. La solicitud contiene el parámetro orderId, obtenido en el paso 4. En la respuesta, la pasarela de pagos devuelve el estado del pedido en el parámetro orderStatus. El estado 2 significa un pago exitoso. Adicionalmente se devuelve el parámetro actionCode — contiene el código de respuesta del procesamiento del banco. Ver la lista de códigos de respuesta aquí.
    Para información adicional, consulte la sección Obtención del estado del pedido.