Compra Redirect

La Compra Redirect corresponde al flujo utilizado por los comercios donde el cliente debe ser redirigido a una página externa para completar el pago.

Diagrama de flujo

PrintScreen

Descripción del flujo

Descripción/EndPoint o Actor
1El comercio envía el request de la compra con el PaymentMediaId del medio de pago correspondiente./purchase
2Bamboo retorna la compra (Purchase) con estado Pending for Redirection y un objeto CommerceAction con una URL externa. ActionReason = REDIRECTION_NEEDED_EXTERNAL_SERVICE/purchase response
3El comercio debe redirigir al cliente a la URL externa que se encuentra en el objeto CommerceAction.Commerce Site/Client browser
4Bamboo redirige automáticamente al cliente al procesador de pagos externo para completar el pago.Bamboo Site/Customer browser
5El cliente sigue los pasos mostrados en el sitio web del adquirente para finalizar el pago.External Payment Site/Client
6Bamboo recibe la respuesta, luego procesa y actualiza el estado de la transacción (según el estado recibido)./paymentCallback
7Bamboo recibe una notificación asíncrona de parte del adquirente y notifica al webhook del comercio (se actualiza el estado de la compra)./webhook (Merchant)

URLS del response

Como resultado de la transacción, esta puede estar en cualquiera de los siguientes estados.

EstadoDescripción
ApprovedCompra aprobada. No se requiere verificación.
RejectedCompra rechazada.
CanceledLa compra fue cancelada por el cliente o un proceso automático.
PendingLa compra se encuentra pendiente para ser pagada en una red de pago en efectivo o debe ser confirmada por el procesador del medio de pago.

Por lo tanto, se definen las siguientes URL que se enviarán en la compra cuando se cree el mismo host-to-host antes de la redirección:

  • Url_Approved → se notifica a esta URL cuando el estado de la compra es Approved
  • Url_Rejected → se notifica a esta URL cuando el estado de la compra es Rejected
  • Url_Canceled → se notifica a esta URL cuando el estado de la compra es Canceled
  • Url_Pending → se notifica a esta URL cuando el estado de la compra es Pending
  • Url_Notify → URL del Webhook de notificación. Se notifica a esta URL el estado de la compra una vez que el procesador del medio de pago notifica a Bamboo. La notificación a esta URL es un POST REST con payload en JSON y no una redirección. Puede ser estática y configurada por el equipo de soporte.

Ejemplo de compra con flujo Redirect

{
    "TrxToken":"OT__Kg1JdcN4Fz6g7RUCF_xdtbR5n0FVX4IctD__P3BSApY_",
    "Capture":"true",
    "Amount":10000000,
    "Installments":1,
    "Currency": "CLP",,
    "TargetCountryISO": "CL",
    "PaymentMediaId":106,
    "Redirection" : {
      "Url_Approved": "https://dummystore.com/checkout/approved",
      "Url_Rejected": "https://dummystore.com/checkout/rejected",
      "Url_Canceled": "https://dummystore.com/checkout/canceled",
      "Url_Pending": "https://dummystore.com/checkout/pending",
      "Url_Notify": "https://dummystore.com/checkout/notifications"
    }
}

Los campos PaymentMediaId y TrxToken son opcionales, pero es obligatorio enviar uno dependiendo del flujo que quiere utilizar.

  • PaymentMediaId: Identificador de medio de pago alternativo (transferencia, efectivo y procesamiento que requiere redirección del cliente). Puede obtener este identificador consultando la sección Medios de pago por país.
  • TrxToken: Puede generar el token y transaccionar enviándolo en este campo.

Contenido de la respuesta de Redirect

El contenido de la respuesta tiene los parámetros PurchaseID y Status, así como el campo FORM (input data).

<form method="post" action="https://dummystore.com/checkout/approved">
  <input type="hidden" id="PurchaseId" name="PurchaseId" value="198742" />
  <input type="hidden" id="Status" name="Status" value="approved" />
</form>
footer
Última modificación 22 de noviembre de 2024

© Bamboo | All rights reserved 2024