Pagos con iDEAL

iDEAL es un sistema de pago de comercio electrónico utilizado en los Países Bajos, 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 pueden iniciar una transferencia bancaria instantánea.

iDEAL es un método de pago mediante explorador compatible en el Mastercard Payment Gateway. Esta página describe los detalles de la integración específicos de iDEAL. Se recomienda que lea las pautas de integración para los pagos mediante explorador, antes de crear una integración de iDEAL.

Los pagos mediante explorador de iDEAL solo se admiten para transacciones en la moneda EUR.

Prerrequisitos

Para ofrecer iDEAL como un método de pago mediante el Mastercard Payment Gateway:

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 iDEAL

iDEAL mediante Hosted Checkout

Con las integraciones de Hosted Checkout versión 50 y posteriores, iDEAL está disponible automáticamente para sus pagadores cuando su proveedor de servicios de pago 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 Hosted Checkout.

iDEAL mediante Direct Payment

La integración de Direct Payment le permite ofrecer el método de pago de iDEAL en su propia página de pago.

iDEAL se admite desde API versión 45 en adelante.

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 iDEAL.

sourceOfFunds.type = IDEAL
browserPayment.operation = PAY (iDEAL no admite la operación Authorize).
sourceOfFunds.provided.ideal.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 iDEAL 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 iDEAL lo admite.

Código de muestra para iniciar el pago con iDEAL

{
   "apiOperation":"INITIATE_BROWSER_PAYMENT",
   "browserPayment":{
      "operation":"PAY",
      "returnUrl":"https://<return_url>"
   },
   "order":{
      "amount":"10.00",
      "currency":"EUR"
   },
   "sourceOfFunds":{
      "type":"IDEAL"
   }
}

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 iDEAL.

Respuesta de Initiate Browser Payment	Qué significa esto...
`response.gatewayCode=SUBMITTED` `result=SUCCESS`	Redirigir al pagador utilizando la URL proporcionada en la respuesta.
Respuesta de Retrieve Transaction/Retrieve Order	Qué significa esto...
`response.gatewayCode=APPROVED` `result=SUCCESS` `sourceOfFunds.provided.ideal.bankAccountHolder` `sourceOfFunds.provided.ideal.bic` (si se proporciona en la solicitud)	El pago se realizó correctamente.
`response.gatewayCode=PENDING` `result=PENDING`	Mastercard Payment Gateway está esperando una notificación del adquirente sobre el resultado del pago. Pruebe `RETRIEVE_TRANSACTION` nuevamente más tarde o escuche las notificaciones de Mastercard Payment Gateway.
`response.gatewayCode=CANCELLED` `result=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_ERROR` `result=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_OUT` `result=FAILURE`	Trate esto como un pago rechazado. El Mastercard Payment Gateway 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 iDEAL en forma parcial o completa. Debe estar configurado para reembolsos en el Mastercard Payment Gateway y en su cuenta de negocio en su proveedor de servicios de pagos mediante explorador.

Prueba de su integración

El Mastercard Payment Gateway proporciona un emulador de pagos mediante explorador que le permite probar su integración con iDEAL.