B2BROKER
B2CORE
B2CORE IB
B2TRADER
B2CONNECT
B2TRANSLATE
B2BROKERCómo integrar 1-2-Pay
Aprenda a integrar 1-2-Pay con B2CORE mediante PSS, incluyendo la configuración de conexiones y la adición de métodos de depósito y retiro con divisas compatibles
1-2-Pay se puede conectar a B2CORE a través de PSS. Admite depósitos mediante códigos QR y retiros a cuentas bancarias, procesados en THB.
Siga las instrucciones a continuación para configurar las conexiones de 1-2-Pay y establecer los métodos de depósito y retiro en el Back Office de B2CORE. Estas instrucciones corresponden al Procedimiento general para añadir métodos de sistemas de pago compatibles con PSS, pero incluyen detalles específicos de 1-2-Pay.
Antes de continuar con las instrucciones, debe haberse registrado en 1-2-Pay y tener una cuenta activa.
Todos los datos necesarios para configurar conexiones con 1-2-Pay, incluidas la URL base de inicio de API, la URL base de sincronización de API y otras credenciales, deben solicitarse al soporte de 1-2-Pay.
Configurar conexiones con 1-2-Pay
Si planea utilizar 1-2-Pay tanto para depósitos como para retiros, debe configurar dos conexiones independientes: una para depósitos y otra para retiros.
Para configurar una conexión con 1-2-Pay:
En el Back Office de B2CORE, vaya a Sistema > Conexiones externas.
Haga clic en +Crear en la esquina superior derecha de la página.
En la página Crear conexión, complete los siguientes campos:
-
En el campo Nombre, 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_1-2-PayoWithdrawals_1-2-Pay). -
En el campo Título, introduzca un título que se aplicará a la conexión en el Back Office.
-
En la lista desplegable Proveedor, seleccione:
- PaymentSystemDeposit — para añadir una conexión que se utilizará para un método de depósito.
- PaymentSystemWithdrawal — para añadir una conexión que se utilizará para un método de retiro.
En la lista desplegable Controlador que aparece, seleccione 1-2-PAY.
En la sección Credenciales que aparece, configure los ajustes específicos de 1-2-Pay:
-
En la lista desplegable Sandbox, seleccione:
- Sí — para el entorno de pruebas sandbox
- No — para el entorno de producción
-
En el campo URL base de inicio de API, especifique la URL base para crear solicitudes de pago proporcionada por 1-2-Pay.
-
En el campo URL base de sincronización de API, especifique la URL base utilizada por B2CORE para recibir y validar devoluciones de llamada, también proporcionada por 1-2-Pay.
Puntos clave sobre las URL
-
La URL base de inicio de API y la URL base de sincronización de API son endpoints diferentes y deben solicitarse directamente a 1-2-Pay.
-
Asegúrese de utilizar siempre HTTPS, por ejemplo:
- URL base de inicio de API:
https://api.example.com/ - URL base de sincronización de API:
https://inquiry.example.com/
- URL base de inicio de API:
-
1-2-Pay proporciona URL específicas para cada entorno. Las URL para sandbox son diferentes de las de producción, así que asegúrese de solicitar ambos conjuntos y utilizar los adecuados para su configuración.
- En el campo Canal, introduzca el canal asignado a su integración por 1-2-Pay.
- En el campo Código de socio, introduzca el código de socio asignado a su empresa por 1-2-Pay.
- En el campo Clave de autenticación, introduzca la clave de API para firmar solicitudes proporcionada por 1-2-Pay.
Haga clic en Guardar para crear la conexión.
La conexión 1-2-Pay aparecerá en la lista de conexiones externas.
Compruebe el estado de la conexión.
Si la conexión está inactiva (se muestra No en la columna Habilitado), haga clic en el botón Editar para abrir los detalles de la conexión y establezca la lista desplegable Habilitado en Sí.
Haga clic en Guardar para aplicar los cambios.
Si necesita admitir tanto depósitos como retiros mediante 1-2-Pay, siga las mismas instrucciones para crear una nueva conexión para la otra operación.
Añadir un método de depósito mediante 1-2-Pay
Para añadir y configurar un método para realizar depósitos mediante 1-2-Pay:
En el Back Office de B2CORE, vaya a Sistema > Sistema de depósitos > Métodos de depósito.
Haga clic en +Crear en la esquina superior derecha de la página.
En la página Crear un método de depósito, complete los siguientes campos:
- En el campo Nombre, 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 Título, 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 B2CORE.
- En la lista desplegable Proveedor, seleccione PaymentSystemDeposit.
Después de seleccionar PaymentSystemDeposit, aparecen los siguientes campos:
- En la lista desplegable Divisas de cuenta disponibles, seleccione una o varias divisas. Los depósitos mediante 1-2-Pay estarán disponibles para cuentas denominadas en las divisas seleccionadas. Para estas divisas, deben configurarse tipos de conversión para
THB. - En la lista desplegable Controlador, seleccione 1-2-PAY.
- En la lista desplegable Conexión, seleccione la conexión de 1-2-Pay configurada anteriormente.
Omita la sección Configuración, ya que no se requieren ajustes para el método de depósito de 1-2-Pay.
Haga clic en Guardar para crear el método de depósito.
El método de depósito 1-2-Pay aparecerá en la lista de métodos de depósito.
Haga clic en Editar para acceder a los detalles del método y complete los siguientes campos:
-
En la pestaña Ajustes, utilice la lista desplegable Grupo para seleccionar uno o varios grupos en los que debe incluirse el método.
-
En el campo Icono, especifique
paymethod-12paypara mostrar el icono predefinido del método de depósito 1-2-Pay en la interfaz de B2CORE. Para utilizar un icono personalizado, especifique la URL de la imagen que se mostrará. -
Compruebe el estado del método.
Si el método está inactivo (se muestra No en el campo Habilitado), actívelo estableciendo la lista desplegable Habilitado en Sí.
-
En la pestaña Divisas de PS, añada
THB. -
Si es necesario, configure las comisiones del método en la pestaña Comisiones (para más detalles, consulte Cómo configurar comisiones para métodos de depósito y retiro).
Haga clic en Probar configuración para validar los ajustes de conexión del método de depósito.
El resultado de la prueba se mostrará en la página.
Después de validar correctamente la configuración, haga clic en Guardar.
El método de depósito 1-2-Pay ya está configurado en el Back Office de B2CORE.
Añadir un método de retiro mediante 1-2-Pay
Para añadir y configurar un método para realizar retiros mediante 1-2-Pay:
En el Back Office de B2CORE, vaya a Sistema > Sistema de pagos > Métodos de pago.
Haga clic en +Crear en la esquina superior derecha de la página.
En la página Crear un método de pago, complete los siguientes campos:
- En el campo Nombre, 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 Título, 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 B2CORE.
- En la lista desplegable Proveedor, seleccione PaymentSystemWithdrawal.
Después de seleccionar PaymentSystemWithdrawal, aparecen los siguientes campos:
- En la lista desplegable Divisas de cuenta disponibles, seleccione una o varias divisas. Los retiros mediante 1-2-Pay estarán disponibles desde cuentas denominadas en las divisas seleccionadas. Para estas divisas, deben configurarse tipos de conversión para
THB. - En la lista desplegable Controlador, seleccione 1-2-PAY.
- En la lista desplegable Conexión, seleccione la conexión de 1-2-Pay para retiros configurada anteriormente.
Omita la sección Configuración, ya que no se requieren ajustes para el método de retiro de 1-2-Pay.
Haga clic en Guardar para crear el método de retiro.
El método de retiro 1-2-Pay aparecerá en la lista de métodos de retiro.
Haga clic en Editar para acceder a los detalles del método y complete los siguientes campos:
-
En la pestaña Ajustes, utilice la lista desplegable Grupo para seleccionar uno o varios grupos en los que debe incluirse el método.
-
En el campo Icono, especifique
paymethod-12paypara mostrar el icono predefinido del método de retiro 1-2-Pay en la interfaz de B2CORE. Para utilizar un icono personalizado, especifique la URL de la imagen que se mostrará. -
Compruebe el estado del método.
Si el método está inactivo (se muestra No en el campo Habilitado), actívelo estableciendo la lista desplegable Habilitado en Sí.
-
En la pestaña Divisas de PS, añada
THB. -
Si es necesario, configure las comisiones del método en la pestaña Comisiones (para más detalles, consulte Cómo configurar comisiones para métodos de depósito y retiro).
Haga clic en Probar configuración para validar los ajustes de conexión del método de retiro.
El resultado de la prueba se mostrará en la página.
Después de validar correctamente la configuración, haga clic en Guardar.
El método de retiro 1-2-Pay ya está configurado en el Back Office de B2CORE.
Configurar webhooks en 1-2-Pay
Para recibir actualizaciones de estado de depósitos y retiros en B2CORE, deben configurarse webhooks de notificación en 1-2-Pay.
Copiar las URL de webhook desde el Back Office de B2CORE
Necesitará URL de webhook independientes para los métodos de depósito y retiro.
En el Back Office de B2CORE, vaya a:
- Sistema > Sistema de depósitos > Métodos de depósito
- Sistema > Sistema de pagos > Métodos de pago
Busque el método de depósito o retiro 1-2-Pay configurado y haga clic en Editar para abrir sus detalles.
Vaya a la pestaña Webhooks.
Copie la URL mostrada en el campo URL de notificación.
Proporcionar las URL a 1-2-Pay
Envíe las URL de webhook copiadas (tanto para depósitos como para retiros) al soporte de 1-2-Pay para que las configuren en su lado.
Última actualización