BETA
Implementa tu flujo de pagos desde tu app mobile con Bold
Para integrar el flujo de pagos de Bold con tu sistema, Bold ha diseñado una integración que te permitirá integrar tu aplicación móvil con la app de pagos de Bold llamada Applink.
¿Qué es el Applink?
Applink es un tipo de integración móvil que permite iniciar el flujo de pago de Bold desde tu aplicación móvil, permitiendo así enviar el monto y enlazar una referencia propia de tu comercio a una transacción de pago de Bold.
¿Cómo funciona?
Applink es un enlace URL que contiene la información del pago que deseas realizar. Para comenzar la transacción desde tu aplicación móvil o web móvil, simplemente dirige al usuario a este enlace. Esto abrirá automáticamente la aplicación de Bold con el monto preconfigurado y la referencia asociada a la transacción que enviaste.
¿Cómo lo integro?
Para usar Applink en la versión Beta, ten en cuenta las siguientes consideraciones:
- Applink solo está disponible para dispositivos Android.
- Debes haber iniciado sesión previamente en la aplicación de Bold con tu correo y contraseña.
- Applink te permite iniciar pagos con tarjeta utilizando datáfonos.
- Actualmente es compatible con datáfonos NEO.
A continuación, te guiaré para configurar un Applink:
1. Configura la URL de applink:
URL base de Applink Bold: https://bold.co/deeplink
2. Configura los parámetros (query params) del pago dentro del enlace:
| Nombre | Descripción | Longitud |
|---|---|---|
| action | Indicador de la acción o pantalla a mostrar al momento de navegar en el app Bold. | start_payment |
| value_to_collect | El monto que se desea cobrar en el app Bold. Contiene la propina e impuestos. | 11 dígitos en total: 9 enteros 2 decimales |
| merchant_id | Es el identificador único de tu comercio. | |
| reference | En este campo puedes enviar una referencia asociada a tu sistema | 24 caracteres |
| description | En este campo puedes enviar una referencia asociada a tu sistema | 20 caracteres |
Ejemplo de configuración del Applink:
https://bold.co/deeplink?action=start_payment&value_to_collect=65400&description=orden_de_pago_1&merchant_id=CKKA859CGE&reference=id_mi_orden_de_pago_1
Una vez que hayas configurado el Applink, simplemente intégralo en tu aplicación. Al redirigir a este enlace, la aplicación de Bold se abrirá automáticamente e iniciará un pago con el monto especificado en el campo value_to_collect. La referencia proporcionada se almacenará en la transacción de Bold.
Seguimiento de la transacción
Con el Webhook de Bold, puedes recibir actualizaciones sobre el estado del pago iniciado mediante Applink y acceder al valor de referencia asociado. Esto te permite seguir el flujo completo del pago, desde su inicio hasta conocer el estado de la transacción y tomar acciones correspondientes dentro de tu sistema en función de estos estados.