- Pautas de integración
- Características soportadas (métodos de pago)
- Implementación de una integración de pago mediante explorador
- Pagos con Giropay
Giropay
Giropay es un sistema de pago de comercio electrónico utilizado en Alemania, que permite a los pagadores comprar mediante transferencias directas en línea desde su cuenta bancaria. Los pagadores son redirigidos al sitio web de banca en línea de su banco, donde inician una transferencia bancaria instantánea.
Giropay es un método de pago mediante explorador admitido en el QNB ALAHLI. Esta página describe los detalles de la integración específicos de Giropay. Se recomienda que lea las pautas de integración para los pagos mediante explorador, antes de crear una integración de Giropay.
Los pagos mediante explorador de Giropay solo se admiten para transacciones en la moneda EUR.
Prerrequisitos
Para ofrecer Giropay como un método de pago mediante el QNB ALAHLI:
- Usted debe estar registrado con su proveedor de servicios de pago mediante explorador.
- Su perfil de negocio en el motor de pagos se debe configurar usando los detalles de su cuenta con el proveedor de servicios de pago mediante explorador.
- Debe tener una cuenta bancaria en una de las monedas soportadas registrada en su cuenta de negocio en su proveedor de servicios de pago mediante explorador.
Integración de Giropay
Con las integraciones de <<checkout>> versión 50 y posteriores, Giropay está disponible automáticamente para sus pagadores cuando your payment service provider lo habilita y configura para disponer del servicio.
Para conocer más detalles, consulte Pagos mediante explorador a través de la integración de <<checkout>>.
La integración de <<directPayment>> le permite ofrecer el método de pago de Giropay en su propia página de pago.
Además de los campos estándar obligatorios en una solicitud de pago mediante explorador, debe completar los siguientes campos en la solicitud Initiate Browser Payment para el procesamiento de los pagos con Giropay.
sourceOfFunds.type = GIROPAYbrowserPayment.operation = PAY(Giropay no admite la operación Authorize).sourceOfFunds.provided.giropay.bankIdentifier: (opcional) proporcione el identificador del banco alemán (Bankleitzahl) de la cuenta bancaria del pagador.sourceOfFunds.provided.giropay.bic: el código identificador comercial (BIC) internacional de la cuenta bancaria del pagador. Para mejorar la experiencia del pagador, se recomienda que complete este campo. Así, el pagador no recibirá el formulario de selección de banco, sino que será redirigido automáticamente a su banco.
Idioma preferido
Para configurar el idioma que prefiere que Giropay utilice para las páginas que se muestran al pagador, complete el campo browserPayment.preferredLanguage en la solicitud de Initiate Browser Payment. Sin embargo, el idioma se usará solo si Giropay lo admite.
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"browserPayment":{
"operation":"PAY",
"returnUrl":"https://<return_url>"
},
"order":{
"amount":"10.00",
"currency":"EUR"
},
"sourceOfFunds":{
"type":"GIROPAY"
}
}
Cómo interpretar el resultado de la transacción
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 con Giropay.
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=SUCCESSsourceOfFunds.provided.giropay.bankIdentifiersourceOfFunds.provided.giropay.bic
|
El pago se realizó correctamente. |
response.gatewayCode=PENDINGresult=PENDING |
QNB ALAHLI está esperando una notificación del adquirente sobre el resultado del pago. Pruebe RETRIEVE_TRANSACTION nuevamente más tarde o escuche las notificaciones de QNB ALAHLI. |
response.gatewayCode=CANCELLEDresult=FAILURE |
El pagador canceló la interacción para este pago. Ofrezca al pagador la opción de probar otro método de pago. |
response.gatewayCode=DECLINED or ACQUIRER_SYSTEM_ERRORresult=FAILURE |
El pago fue rechazado. Ofrezca al pagador la opción de probar otro método de pago. En caso de un ACQUIRER_SYSTEM_ERROR, puede consultar con el adquirente el motivo del error del pago, o bien puede intentar RETRIEVE_TRANSACTION de nuevo. |
response.gatewayCode=TIMED_OUTresult=FAILURE |
Trate esto como un pago rechazado. El QNB ALAHLI hará lo posible para asegurarse de que la transacción no se puede realizar o revertirá la transacción. |
Reembolsos
Puede reembolsar los pagos de Giropay en forma parcial o completa. Debe estar configurado para reembolsos en el QNB ALAHLI y en su cuenta de negocio en su proveedor de servicios de pagos mediante explorador.
Prueba de su integración
El QNB ALAHLI proporciona un emulador de pagos mediante explorador que le permite probar su integración con Giropay.