B2BROKER
B2CORE
B2CORE IB
B2TRADER
B2CONNECT
B2TRANSLATE
B2BROKERCómo integrar BridgerPay
Aprenda a integrar BridgerPay con B2CORE para depósitos, incluida la configuración de conexiones, la adición de métodos, la prueba de configuraciones y la configuración de webhooks y URL de redirección para transacciones fluidas
BridgerPay se puede conectar a B2CORE mediante PSS, con soporte únicamente para depósitos.
Siga las instrucciones a continuación para configurar la conexión de BridgerPay y establecer el método de depósito en el Back Office de B2CORE. Estas instrucciones corresponden al procedimiento general para añadir métodos para sistemas de pago compatibles con PSS, pero incluyen detalles específicos de BridgerPay.
Antes de continuar con las instrucciones, debe haberse registrado en BridgerPay y tener una cuenta activa.
Crear un enlace de pago en su cuenta de BridgerPay
Para crear un enlace de pago en BridgerPay, debe crear un checkout del tipo enlace de pago:
Inicie sesión en su cuenta de BridgerPay.
En el menú principal, vaya a Checkouts.
Haga clic en el icono plus para añadir un nuevo checkout y, a continuación, complete los siguientes campos:
- En el campo Title, introduzca un título para el checkout.
- En la lista desplegable Type, seleccione Payment link.
Haga clic en Create.
Una vez creado correctamente el checkout de tipo enlace de pago, estarán disponibles las credenciales necesarias para configurar el método de depósito en el Back Office de B2CORE.
Configurar una conexión con BridgerPay
Para configurar una conexión con BridgerPay para realizar depósitos:
En el Back Office de B2CORE, vaya a System > External connections.
Haga clic en +Create en la esquina superior derecha de la página.
En la página Create connection, complete los siguientes campos:
- En el campo Name, introduzca un nombre para la conexión. El nombre debe ser único y solo puede contener letras latinas, números, guiones y guiones bajos (por ejemplo,
Deposits_BridgerPay). - En el campo Caption, introduzca un título que se aplicará a la conexión en el Back Office.
- En la lista desplegable Provider, seleccione PaymentSystemDeposit.
En la lista desplegable Driver que aparece, seleccione BridgerPay.
En la sección Credentials que aparece, configure los ajustes específicos de BridgerPay:
- En el campo API base URL, especifique
https://api.bridgerpay.com. - En los campos API user name y API password, introduzca sus credenciales para acceder a la API de BridgerPay.
- En el campo API key, introduzca la clave API generada en su cuenta de BridgerPay.
Haga clic en Save para crear la conexión.
La conexión BridgerPay aparecerá en la lista de conexiones externas.
Compruebe el estado de la conexión.
Si la conexión está inactiva (No se muestra en la columna Enabled), haga clic en el botón Edit para abrir los detalles de la conexión y establezca la lista desplegable Enabled en Yes.
Haga clic en Save para aplicar los cambios.
Añadir un método de depósito mediante BridgerPay
Para añadir y configurar un método para realizar depósitos mediante BridgerPay:
En el Back Office de B2CORE, vaya a System > Deposit system > Deposit methods.
Haga clic en +Create en la esquina superior derecha de la página.
En la página Create a deposit method, complete los siguientes campos:
- En el campo Name, introduzca un nombre para el método. El nombre debe ser único y solo puede contener letras latinas, números, guiones y guiones bajos.
- En el campo Caption, introduzca un título para el método. Este título se asignará al método en el Back Office y será visible para los clientes en la interfaz de usuario de B2CORE.
- En la lista desplegable Provider, seleccione PaymentSystemDeposit.
Después de seleccionar PaymentSystemDeposit, aparecen los siguientes campos:
- En la lista desplegable Available account currencies, seleccione una o varias divisas. Los depósitos mediante BridgerPay estarán disponibles para las cuentas denominadas en las divisas seleccionadas.
- En la lista desplegable Driver, seleccione BridgerPay.
- En la lista desplegable Connection, seleccione la conexión de BridgerPay configurada previamente.
En la sección Configuration que aparece, complete el siguiente ajuste:
- En el campo Cashier key, especifique el identificador único proporcionado por BridgerPay.
Haga clic en Save para crear el método de depósito.
El método de depósito BridgerPay aparecerá en la lista de métodos de depósito.
Haga clic en Edit para acceder a los detalles del método y complete los siguientes campos:
-
En la pestaña Settings, use la lista desplegable Group para seleccionar uno o varios grupos en los que se debe incluir el método.
-
En el campo Icon, especifique
paymethod-bridgerpaypara mostrar el icono predefinido del método de depósito BridgerPay en la interfaz de usuario de B2CORE. Para usar un icono personalizado, especifique la URL de la imagen que se mostrará. -
Compruebe el estado del método.
Si el método está inactivo (No se muestra en el campo Enabled), actívelo estableciendo la lista desplegable Enabled en Yes.
-
Añada las divisas necesarias en la pestaña PS Currencies. Para permitir que el método procese depósitos en una divisa específica, asegúrese de que se añada en esta pestaña (para obtener una descripción de la pestaña, consulte Deposit methods).
-
Si es necesario, configure las comisiones del método en la pestaña Commissions (para obtener más información, consulte Cómo configurar comisiones para métodos de depósito y retiro).
Haga clic en Test configuration para validar los ajustes de conexión del método de depósito. La prueba se realiza según los ajustes especificados en el formulario del método y los datos proporcionados en la conexión externa seleccionada.
El resultado de la prueba se mostrará en la página.
Después de validar correctamente la configuración, haga clic en Save.
El método de depósito BridgerPay ya está configurado en el Back Office de B2CORE.
Configurar webhooks en su cuenta de BridgerPay
Para recibir actualizaciones de estado de los depósitos iniciados en B2CORE, debe configurar webhooks de notificación para los PSP en BridgerPay.
Copiar la URL del webhook desde el Back Office de B2CORE
En el Back Office de B2CORE, vaya a System > Deposit system > Deposit methods.
Busque el método de depósito BridgerPay configurado y haga clic en Edit para acceder a los detalles del método.
Vaya a la pestaña Webhooks.
Copie la URL que se muestra en el campo Notification URL.
Añadir la URL del webhook a los PSP en BridgerPay
Inicie sesión en su cuenta de BridgerPay.
En el menú principal, vaya a Checkouts.
Seleccione el PSP añadido y haga clic en él para abrir sus detalles.
En los detalles, haga clic en Settings.
Vaya a la pestaña URLs.
Pegue la URL del webhook copiada del Back Office de B2CORE en el campo Webhook Notification URL.
Guarde los cambios.
Repita estos pasos para cada PSP añadido y configurado en su cuenta de BridgerPay.
Especificar URL de redirección para los PSP en BridgerPay
Para garantizar una redirección correcta después de que un depósito se complete, falle o se cancele, configure las URL de redirección correspondientes para los PSP en BridgerPay.
Para configurar las URL de redirección:
En su cuenta de BridgerPay, vaya a Checkouts en el menú principal.
Seleccione el PSP añadido y haga clic en él para abrir sus detalles.
En los detalles, haga clic en Settings.
Vaya a la pestaña URLs.
Especifique las siguientes URL:
- En Success Redirect URL, especifique
https://{your-Front-Office-URL}/en/payment/success. - En los campos Failure Redirect URL y Cancel Redirect URL, especifique
https://{your-Front-Office-URL}/en/payment/failed.
Asegúrese de sustituir {your-Front-Office-URL} por el dominio de su interfaz de usuario de B2CORE.
Guarde los cambios.
Repita estos pasos para cada PSP añadido y configurado en su cuenta de BridgerPay.
Activar la opción 'Notify with original amount' para los PSP en BridgerPay
La opción Notify with original amount para los PSP en BridgerPay garantiza que las notificaciones de pago incluyan los importes de depósito originales, sin modificaciones ni cargos adicionales.
Para activar esta opción:
En su cuenta de BridgerPay, vaya a Checkouts en el menú principal.
Seleccione el PSP añadido y haga clic en él para abrir sus detalles.
En los detalles, haga clic en Settings.
En la sección denominada PSP Specific Settings, active la opción Notify with original amount.
Guarde los cambios.
Repita estos pasos para cada PSP añadido y configurado en su cuenta de BridgerPay.
El método de depósito BridgerPay ya está completamente configurado y disponible para que los clientes lo utilicen al realizar depósitos en la interfaz de usuario de B2CORE.
Última actualización