- Pautas de integración
- Características soportadas (métodos de pago)
- Implementación de una integración de pago mediante explorador
- Pagos con WeChat Pay
WeChat Pay
WeChat Pay es un sistema de pago de comercio electrónico utilizado en China, que permite a los pagadores comprar mediante transferencias directas en línea desde su cuenta de WeChat Pay. Los pagadores son redirigidos a su cuenta de WeChat Pay, donde pueden iniciar un pago instantáneo.
WeChat Pay 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 WeChat Pay. Se recomienda que lea las pautas de integración para los pagos mediante explorador, antes de crear una integración de WeChat Pay.
Los pagos mediante explorador de WeChat Pay solo se admiten para transacciones en las monedas EUR, USD, GBP, CNY y CHF.
Prerrequisitos
Para ofrecer WeChat Pay 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.
Tenga en cuenta que el motor de pagos solo admite WeChat Pay 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 WeChat Pay. 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).
- WeChat Pay 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.
Integración de WeChat Pay
Pronto estará disponible WeChat Pay mediante Hosted Checkout. Póngase en contacto con your payment service provider para obtener más información.
La integración de Direct Payment le permite ofrecer el método de pago de WeChat Pay 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:
sourceOfFunds.type=WECHAT_PAYbrowserPayment.operation=PAY(WeChat Pay no admite la operación Authorize).sourceOfFunds.provided.weChatPay.accountHolder: el nombre del titular de la cuenta para la cuenta de WeChat Pay del pagador.
Idioma preferido
Para configurar el idioma que prefiere que WeChat Pay 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 WeChat Pay lo admite.
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"browserPayment":{
"operation":"PAY",
"returnUrl":"https://<return_url>"
},
"order": {
"amount": "10.00",
"currency": "EUR"
},
"sourceOfFunds": {
"type": "WECHAT_PAY",
"provided": {
"weChatPay": {
"accountHolder": "John Smith"
}
}
}
}
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 WeChat Pay.
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.weChatPay.accountHolder
|
El pago se realizó correctamente. |
response.gatewayCode=PENDINGresult=PENDING |
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 de Mastercard Gateway. |
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á todo lo posible para asegurarse de que la transacción no se pudo realizar o revertirá la transacción. |
Reembolsos
Puede reembolsar los pagos de WeChat Pay 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 WeChat Pay.