- Pautas de integración
- Características soportadas (métodos de pago)
- Implementación de una integración de pago mediante explorador
- Pagos con BancaNet Directo
BancaNet Directo
BancaNet Directo es una solución de banca en línea de Banamex. Cuando los pagadores seleccionan BancaNet Directo como método de pago, se les redirige a su sitio de banca en línea de BancaNet Directo, donde pueden transferir el dinero a la cuenta del negocio. La transferencia es inmediata y no se admiten operaciones posteriores como, por ejemplo, Void, Refund, etc.
BancaNet es un método de pago mediante explorador compatible. En esta página se describen los detalles de integración específicos de BancaNet Directo, incluido el modo de configurar una cuenta con BancaNet Directo. Para ver una descripción general de los pagos mediante explorador y cómo integrar un método de pago mediante explorador con el QNB ALAHLI, consulte Implementación de una integración de pago mediante explorador.
Prerrequisitos
Para usar BancaNet Directo como método de pago:
- Debe tener una cuenta bancaria en una moneda admitida por el motor de pagos de BancaNet Directo — MXN o USD.
- Debe registrarse con Banamex y firmar el contrato de BancaNet Directo. El pagador debe tener una cuenta bancaria en línea con BancaNet Directo.
Registro con BancaNet Directo
Durante el registro, debe especificar los siguientes datos, los que deben concordar con el QNB ALAHLI.
Merchant Domain URL: esta es la dirección URL de origen que se usó para redirigir el explorador del pagador al sitio Web del banco en línea de BancaNet Directo. Use https://qnbalahli.test.gateway.mastercard.com/api/bpui/bn/out/Merchant Destination URL: esta es la dirección URL de destino a la que se redirige el explorador del pagador después de completar correctamente el pago en el sitio Web del banco en línea de BancaNet Directo. Use https://qnbalahli.test.gateway.mastercard.com/api/bpui/bn/in/
Después de registrarse en BancaNet, debe proporcionar los siguientes detalles de la cuenta de BancaNet Directo a your payment service provider:
- El ID del adquirente del negocio es el ID de banca electrónica de Banamex que especificó al firmar el contrato de BancaNet Directo
- Los detalles de la cuenta bancaria de la cuenta a la que se transfieren los fondos desde la cuenta del pagador.
- Identificador de la cuenta bancaria
- Número de cuenta de la cuenta bancaria
- Moneda configurada para la cuenta bancaria
- Tipo de referencia de pago es el formato de la referencia de pago que especificó al firmar el contrato de BancaNet Directo. Por ejemplo, numérico, alfanumérico, etc.
- Número comercial (solo requerido si el tipo de referencia de pago es "Línea de captura B")
- Secuencia de depósito según se especificó al firmar el contrato de BancaNet Directo.
Usando estos detalles, your payment service provider completará la configuración en Merchant Manager.
Adición de BancaNet Directo a su integración
Puede añadir BancaNet Directo a su integración utilizando las siguientes opciones de integración.
Si utiliza la página de pago del motor de pagos (Hosted Checkout), BancaNet Directo se ofrecerá automáticamente como opción de pago a sus pagadores si:
- your payment service provider ha configurado el vínculo de adquirente de BancaNet en su perfil del negocio.
- usted utiliza la versión de la API 11 o superior.
Para conocer más detalles, consulte Pagos mediante explorador a través de la integración de <<checkout>>.
Sin embargo, si desea admitir el tipo de referencia de pago "Línea de captura A", debe proporcionar los campos de BancaNet al enviar la solicitud Create Checkout Session al motor de pagos. Tenga en cuenta que debe utilizar la versión de API 59 o superior cuando envíe esta solicitud.
Ejemplo de solicitud Create Checkout Session
| URL | https://qnbalahli.test.gateway.mastercard.com/api/rest/version/72/merchant/{merchantId}/session |
| Método HTTP | POST |
{
"apiOperation": "CREATE_CHECKOUT_SESSION",
"interaction" : {
"operation" : "AUTHORIZE",
"merchant" : {
"url" : "https://example.com",
"name" : "CaptureLine_A_Test"
}
},
"order" : {
"id": "test1239089",
"currency" : "USD"
},
"transaction":
{
"bancanet":
{
"merchantPaymentReference":"Testing",
"paymentDueDate":"2022-01-30",
"paymentReason": "pay@test"
}
}
}
La integración de <<directPayment>> le permite ofrecer el método de pago de BancaNet Directo en su propia página de pago si utiliza <<webServicesIntegration>> versión 11 o superior.
Para agregar BancaNet Directo a su integración de <<directPayment>>, proporcione los siguientes campos en la solicitud Initiate Browser Payment además de los campos estándar necesarios para una integración de pagos mediante explorador<<directPayment>>.
sourceOfFunds.type=BANCANET- Consulte Campos de BancaNet Directo
Campos de BancaNet Directo
transaction.bancanet.paymentDueDate: (opcional) la fecha en que el pagador debe realizar el pago.transaction.bancanet.paymentReason: (opcional) el motivo para el pago, por ejemplo, "Pago de tarjeta". El motivo se muestra al pagador en el sitio Web de BancaNet Directo.transaction.bancanet.merchantPaymentReference: (opcional) la referencia de pago para el pago. El motor de pagos genera la referencia de pago basada en el tipo de referencia de pago de BancaNet configurado en su perfil de negocio; no obstante, con algunas condiciones.
Tipo de referencia de pago Referencia de pago del negocio Condición 1 - Numérico El motor de pagos usa el algoritmo MOD-97 para generar la referencia de pago. El algoritmo MOD-97 usa los siguientes datos para calcular la referencia:
- El identificador bancario configurado en su perfil de negocio del motor de pagos
- El número de cuenta bancaria configurado en su perfil de negocio del motor de pagos
- Una referencia numérica generada automáticamente
- Una referencia alfanumérica generada automáticamente
- Dígito de comprobación
Debe estar configurado en BancaNet para el algoritmo MOD-97. De lo contrario, BancaNet no acepta la referencia de pago enviada por el motor de pagos como una referencia válida y se rechaza el pago. 2 - Alfanumérico 3 - Numérico y alfanumérico 4 - Línea de captura A El motor de pagos no admite la generación de la referencia de pago. Si no proporciona un valor, el motor de pagos rechaza el pago. - 5 - Línea de captura B El motor de pagos usa el algoritmo Type Zero para generar la referencia de pago de negocio. El algoritmo Type Zero utiliza los siguientes datos para calcular la referencia:
- El número comercial configurado en su perfil de negocio del motor de pagos
- El valor de
transaction.referenceproporcionado por usted - Dígito de comprobación
Si no proporciona un valor para el campo "transaction.reference" y/o si no está configurado en BancaNet para el algoritmo Type Zero, el motor de pagos rechaza el pago.
Ejemplo de solicitud Initiate Browser Payment
| URL | https://qnbalahli.test.gateway.mastercard.com/api/rest/version/72/merchant/{merchantId}/order/{orderid}/transaction/{transactionid} |
| Método HTTP | PUT |
{
"apiOperation" : "INITIATE_BROWSER_PAYMENT",
"browserPayment" : {
"operation" : "PAY",
"returnUrl" : "<returnURL>"
},
"order" : {
"amount" : "399",
"currency" : "MXN"
},
"sourceOfFunds" : {
"type" : "BANCANET"
},
"transaction" : {
"reference": null,
"bancanet" : {
"merchantPaymentReference" : "131234345",
"paymentReason" : "test"
}
}
}
Cómo interpretar el resultado de la transacción
BancaNet Directo redirige el explorador del pagador a la dirección URL de retorno (que usted proporcionó al iniciar el pago) solo cuando el pago finaliza correctamente en el sitio Web de BancaNet Directo. En otro caso (por ejemplo, el pago se cancela o se pierde la conexión con el explorador después de completar el pago), BancaNet Directo no devuelve el explorador a su sitio Web.
La tabla siguiente muestra los códigos de respuesta de transacción para los posibles escenarios que puede encontrar después de iniciar un pago mediante explorador.
| Respuesta de Initiate Browser Payment | Qué significa esto... |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
Redirigir al pagador utilizando la URL proporcionada en la respuesta. |
| Respuesta de Retrieve Transaction/Retrieve Order | Qué significa esto... |
response.gatewayCode=APPROVEDresult=SUCCESS |
El pago se realizó correctamente. |
response.gatewayCode=UNKNOWNresult=FAILURE |
El motor de pagos no pudo averiguar si el pago se realizó correctamente o no. |