- Pautas de integración
- Características soportadas (métodos de pago)
- Implementación de una integración de pago mediante explorador
- Pagos con Alipay
Alipay
Alipay es una billetera electrónica utilizada en China, que permite a los clientes comprar productos en línea mediante su saldo de Alipay o al seleccionar un método de pago de la billetera.
Alipay es un método de pago mediante explorador compatible en el Mastercard Gateway. Esta página describe los detalles de la integración específicos de Alipay. Se recomienda que lea las pautas de integración para los pagos mediante explorador, antes de crear una integración de Alipay.
Los pagos mediante explorador de Alipay se admiten para transacciones en las siguientes monedas: AUD, CAD, EUR, GBP, HKD, SGD, USD, CHF, JPY, NZD y CNY.
Tenga en cuenta que el motor de pagos solo admite Alipay para los negocios transfronterizos, es decir, los negocios internacionales que ingresan al mercado chino y los turistas chinos en el extranjero que quieren pagar con Alipay. El motor de pagos no permite procesar CNY de forma nativa para los negocios con domicilio en China.
En el caso de los negocios transfronterizos:
- El monto del pedido se presentará al pagador (mediante el motor de pagos) en la moneda de procesamiento (por ejemplo, EUR).
- Alipay le debitará al pagador en CNY y a este se le cobrará por la conversión de moneda.
- El proveedor de servicios de pago mediante explorador liquidará el negocio en EUR.
Prerrequisitos
Para ofrecer Alipay como un método de pago mediante el Mastercard 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 Alipay
Con las integraciones de Hosted Checkout versión 51 y posteriores, Alipay 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 Hosted Checkout.
La integración de Direct Payment le permite ofrecer el método de pago de Alipay en su propia página de pago.
Realice una solicitud Initiate Browser Payment donde sourceOfFunds.type = ALIPAY y browserPayment.operation = PAY (Alipay no admite la operación Authorize). Para los campos estándar, consulte Pagos mediante explorador a través de la integración de Direct Payment.
Idioma preferido
Para configurar el idioma que prefiere que Alipay 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 Alipay lo admite.
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"browserPayment":{
"operation":"PAY",
"returnUrl":"https://<return_url>"
},
"order":{
"amount":"10.00",
"currency":"GBP"
},
"sourceOfFunds":{"type":"ALIPAY"
}
}
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 Alipay.
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=PENDINGresult=PENDING |
El Mastercard Gateway está esperando una notificación del adquirente sobre el resultado del pago. Pruebe RETRIEVE_TRANSACTION nuevamente más tarde o escuche las notificaciones del motor de pagos. |
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 Mastercard 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 Alipay en forma parcial o completa. Debe estar configurado para reembolsos en el Mastercard Gateway y en su cuenta de negocio en su proveedor de servicios de pagos mediante explorador.
Prueba de su integración
El Mastercard Gateway proporciona un emulador de pagos mediante explorador que le permite probar su integración con Alipay.