- Pautas de integración
- Características soportadas (métodos de pago)
- Implementación de una integración de pago mediante explorador
- Pagos de UnionPay SecurePay
UnionPay SecurePay
UnionPay International a través de UnionPay Online Payment (UPOP), un sistema de pago global para transacciones de comercio electrónico, ofrece UnionPay SecurePay como un servicio que permite a los pagadores comprar en línea usando su cuenta SecurePay de UPOP en el sitio web de UnionPay SecurePay.
UnionPay SecurePay es un método de pago mediante explorador compatible en el Mastercard Gateway. Esta página describe detalles de integración específicos de UnionPay SecurePay. Se recomienda que lea las pautas de integración para los pagos mediante explorador, antes de crear una integración de UnionPay SecurePay.
Prerrequisitos
Para ofrecer UnionPay SecurePay como un método de pago mediante el Mastercard Gateway:
- Debes estar registrado en UPOP a través de your payment service provider.
- Una vez configurado con UPOP, your payment service provider debe configurar su perfil del negocio en el Mastercard Gateway usando los detalles de su cuenta con UPOP.
- Sus páginas de pago deben cumplir con los requisitos de marca de UnionPay SecurePay. Consulte Guía de aceptación internacional de UnionPay para negocios de comercio electrónico.
Integración de UnionPay SecurePay
Con las integraciones de Hosted Checkout versión 34 y posteriores, UnionPay SecurePay está disponible automáticamente cuando your payment service provider ha configurado el vínculo de adquirente para UnionPay SecurePay.
interaction.timeout para limitar el tiempo que un pagador tiene para finalizar su pedido, cuando el tiempo que queda antes del vencimiento del pago sea inferior a 900 segundos, ya no se ofrecerá al pagador la posibilidad de seleccionar UnionPay SecurePay como método de pago en Hosted Checkout. Para conocer más detalles, consulte Pagos mediante explorador a través de la integración de Hosted Checkout.
Elija la integración de Direct Payment si desea ofrecer el método de pago de UnionPay SecurePay en su propia página de pago.
Realice una solicitud de Initiate Browser Payment, donde sourceOfFunds.type = UNION_PAY. Para conocer otros detalles, consulte Pagos mediante explorador a través de la integración de Direct Payment.
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 mediante explorador de UnionPay SecurePay.
| Escenario | Respuesta de Retrieve Transaction/Retrieve Order |
|---|---|
| TRANSACTION SUCCESSFUL | |
| El pago se realizó correctamente. | browserPayment.interaction.status=COMPLETEDresponse.gatewayCode=APPROVED |
| TRANSACTION NOT SUCCESSFUL | |
| El pago fue rechazado por el adquirente. | browserPayment.interaction.status=COMPLETEDresponse.gatewayCode=DECLINED |
| El pago no se concretó, porque el adquirente no pudo procesarlo. | browserPayment.interaction.status=COMPLETEDresponse.gatewayCode=ACQUIRER_SYSTEM_ERROR |
| El Mastercard Gateway no pudo iniciar correctamente el pago de UnionPay SecurePay. | browserPayment.interaction.status=N/Aresponse.gatewayCode=SYSTEM_ERROR |
| El Mastercard Gateway ha recibido el explorador del pagador y lo redirigió a UnionPay SecurePay. No se ha producido ningún pago en 2 horas. Todas las solicitudes de redirección para este pago son rechazadas por el Mastercard Gateway. |
browserPayment.interaction.status=REDIRECTED_TO_PROVIDERresponse.gatewayCode=DECLINED |
| El Mastercard Gateway no recibió una redirección del explorador del pagador del negocio en un plazo de 24 horas. No se ha producido ningún pago y las solicitudes de redirección para este pago son rechazadas por el Mastercard Gateway. |
browserPayment.interaction.status=INITIATEDresponse.gatewayCode=TIMED_OUT |
| RESULTADO DE LA TRANSACCIÓN AUN DESCONOCIDO (EN CURSO) | |
| La transacción se ha iniciado correctamente en el motor de pagos. El motor de pagos aún no ha recibido el explorador del pagador del negocio para la redirección a UnionPay SecurePay. Aún no se ha producido ningún pago. | browserPayment.interaction.status=INITIATEDresponse.gatewayCode=SUBMITTED |
| El motor de pagos recibió el explorador del pagador y lo redirigió a UnionPay SecurePay. Aún no se ha producido ningún pago. |
browserPayment.interaction.status=REDIRECTED_TO_PROVIDERresponse.gatewayCode=SUBMITTED |
| El motor de pagos devolvió el explorador del pagador al negocio. Actualmente, el motor de pagos está intentando averiguar si el pago se realizó correctamente o no. |
browserPayment.interaction.status=RETURNED_TO_MERCHANTresponse.gatewayCode=SUBMITTED |
| El motor de pagos no pudo averiguar si el pago se realizó correctamente o no. El motor de pagos todavía puede averiguar y actualizar la transacción. Puede hacer un seguimiento con una solicitud de Retrieve Transaction (dado que el motor de pagos puede haber averiguado el resultado) o utilizar las notificaciones de webhook del motor de pagos (si está suscrito). |
browserPayment.interaction.status=RETURNED_TO_MERCHANTresponse.gatewayCode=UNKNOWN |
| ESTADO DESCONOCIDO DE LA TRANSACCIÓN | |
| El motor de pagos no pudo averiguar si el pago se realizó correctamente o no. El motor de pagos ya no intentará averiguarlo. Debe ponerse en contacto con el adquirente para averiguar el resultado. |
browserPayment.interaction.status=N/Aresponse.gatewayCode=UNKNOWN |
Capturas y reembolsos
Puede realizar capturas o reembolsos posteriores en pedidos de UnionPay SecurePay mediante operaciones Capture/Refund de DirectAPIo mediante Merchant Administration.
Anulaciones
Puede realizar transacciones Void en pedidos de UnionPay SecurePay utilizando la operación Void de DirectAPI o mediante Merchant Administration. Solo se admiten las transacciones Authorize, Capture y Pay para las anulaciones.
Prueba de su integración
El Mastercard Gateway proporciona un emulador de UnionPay SecurePay que le permite probar su integración de UnionPay SecurePay.
Solución de problemas y preguntas frecuentes
Retrieve Transaction respuesta?Su cuenta de negocio en UPOP se puede configurar para que no devuelva el número de tarjeta. En este caso, no verá un número de tarjeta en la respuesta de Retrieve Transaction. Contacte con your payment service provider si desea cambiar esta configuración en UPOP.
Si el Mastercard Gateway no pudo identificar el esquema de tarjeta ni la marca de tarjeta asociada con la tarjeta del pagador, entonces Retrieve Transaction devuelve sourceOfFunds.provided.card.scheme=OTHER y sourceOfFunds.provided.card.brand=UNKNOWN.