- Pautas de integración
- Características soportadas (métodos de pago)
- Implementación de una integración de pago mediante explorador
- Probar una integración de pago mediante explorador
Probar una integración de pago mediante explorador
Una vez que haya configurado la cuenta con el proveedor del sitio web de pago y creado su integración, debe probar la integración con el perfil de pruebas del negocio (su ID de negocio comienza con “TEST”). Mastercard Gateway proporciona un simulador para simular el sitio web del proveedor de pago.
Prueba de la llamada Initiate Browser Payment
Puede usar el campo order.reference cuando realice una solicitud de Initiate Browser Payment para iniciar diferentes valores para response.gatewayCode.
Para una transacción Void, debe usar el campo
transaction.reference.El envío de '.FAIL<code>' en order.reference devuelve:
- El
response.gatewayCode=<code> si <code> es un valor válido pararesponse.gatewayCode. - El
response.gatewayCode=UNKNOWNsi <code> no es un valor válido pararesponse.gatewayCode.
Para otros pagos mediante explorador (Alipay, Boleto Bancário, Bancontact, Giropay, GrabPay, iDEAL, Klarna Financing, Klarna Pay Later, Klarna Pay Now, Multibanco, OXXO, POLi, SEPA, Sofortbanking, WeChat Pay)
Puede utilizar los siguientes valores (SIN el prefijo ".FAIL") en el campo order.reference cuando realice una solicitud de Initiate Browser Payment para activar valores diferentes para response.gatewayCode.
| order.reference | response.gatewayCode | Comportamiento |
|---|---|---|
| TEST-SUCCEED | APPROVED | La transacción se llevará a cabo inmediatamente. |
| TEST-FAIL-NOTFOUND | DECLINED | La transacción será rechazada inmediatamente. |
| TEST-FAIL-DECLINE | DECLINED | La transacción será rechazada inmediatamente. |
| TEST-PENDING | SUBMITTED | La transacción permanecerá pendiente indefinidamente. |
| TEST-FAIL-THEN-SUCCESS | SUBMITTED, luego DECLINED, luego APPROVED |
Después de 30 segundos, el simulador enviará una notificación y hará fallar la transacción. 60 segundos más tarde, el simulador enviará otra notificación y la transacción se realizará con éxito. |
| TEST-FAIL-INIT | SUBMITTED, luego DECLINED |
Después de 30 segundos, el simulador enviará una notificación y hará fallar la transacción. |
| TEST-SUCCESS-INIT | SUBMITTED, luego APPROVED |
Después de 30 segundos el simulador enviará una notificación y la transacción se realizará con éxito. |
| TEST-TIMEOUT-THEN-SUCCESS | SUBMITTED, luego ACQUIRER_SYSTEM_ERROR, luego APPROVED |
Después de 30 segundos el simulador enviará una notificación y marcará que la transacción agotó el tiempo de espera. 60 segundos más tarde, el simulador enviará una notificación y la transacción se realizará con éxito. |
| TEST-QUICK-TIMEOUT-THEN-SUCCESS | SUBMITTED, luego ACQUIRER_SYSTEM_ERROR, luego APPROVED |
Después de 5 segundos el simulador enviará una notificación y marcará que la transacción agotó el tiempo de espera. 5 segundos más tarde, el simulador enviará una notificación y la transacción se realizará con éxito. |
| TEST-FAIL-TIMEOUT | SUBMITTED, luego ACQUIRER_SYSTEM_ERROR |
Después de 30 segundos el simulador enviará una notificación y marcará que la transacción agotó el tiempo de espera. |
| TEST-TIMEOUT | TIMED_OUT | El simulador imita un escenario de tiempo de espera agotado. La transacción falla después de un retraso de 31 segundos. |
| TEST-NO-RESPONSE | UNSPECIFIED_FAILURE | El simulador imita un escenario donde la transacción no se pudo procesar. |
Simulación de los resultados de un proveedor de sitio web de pagos
El simulador de pago mediante explorador:
- Tiene una marca básica del proveedor del sitio web de pago.
- Solo está disponible en inglés.
Para pagos con PayPal
Una vez que se haya incorporado, el ID de sandbox de PayPal se establece en un valor ficticio para que pueda probar su integración con su perfil de prueba. Una vez que se le conceda el permiso de terceros, el valor ficticio se reemplazará con el ID de la cuenta de PayPal real.
- Se muestran los detalles de pago proporcionados en la solicitud de Initiate Browser Payment.
- Usted debe seleccionar un resultado de pago de PayPal:
SUCCESSPENDINGCANCELUNKNOWNERRORTIMED_OUT- Para resultados pendientes, usted puede similar la obtención de una notificación al configurar la demora antes de recibir la notificación y el resultado deseado de la notificación.
- Después de hacer clic en "Pagar ahora" o "Continuar", el explorador es redirigido de regreso a la URL proporcionada en la solicitud de Initiate Browser Payment.
- Utilice los siguientes valores del campo
order.referenceotransaction.referencecuando realice una solicitud de Initiate Browser Payment para iniciar diferentes valores pararesponse.gatewayCode.Order.Reference o transaction.reference response.gatewayCode Estado del pedido Comportamiento PP.400.BADREQUEST DECLINED FAILED La transacción será rechazada inmediatamente. PP.PENDING.AUTHORIZATION APPROVED CAPTURED La transacción se llevará a cabo inmediatamente. PP.PENDING.NONE PENDING CAPTURED La transacción permanecerá pendiente indefinidamente. PPP.400.CAPTURE_AMOUNT_LIMIT_EXCEEDED DECLINED FAILED La transacción será rechazada inmediatamente. PP.400.TIMEOUT DECLINED FAILED El simulador imita un escenario de tiempo de espera agotado. La transacción falla inmediatamente. PP.400.INVALID_REQUEST DECLINED FAILED La transacción será rechazada inmediatamente. PP.400.INSUFFICIENT_FUNDS INSUFFICIENT_FUNDS FAILED El simulador recrea un caso de fondos insuficientes. La transacción falla inmediatamente. PP.400.ORDER_VOIDED DECLINED FAILED La transacción será rechazada inmediatamente.
Si se está integrando con PayPal por primera vez, debe enviar los siguientes valores como parte del campo order.reference mientras prueba su integración
Utilice los siguientes valores en el campo order.reference cuando realice una solicitud de Initiate Browser Payment para iniciar diferentes valores para response.gatewayCode.
| Order.Reference | response.gatewayCode | Estado del pedido | Comportamiento |
|---|---|---|---|
| A_M | DECLINED | FAILED | La transacción se rechaza inmediatamente. |
| P_C | PENDING | CAPTURED | La transacción permanecerá pendiente indefinidamente. |
| I_D | DECLINED | FAILED | Este escenario es para simular una falla de financiamiento. Para obtener más información, consulte el tema Manejar las fallas de financiamiento. |
Para pagos con UnionPay SecurePay
- Se muestran los detalles de pago proporcionados en la solicitud de Initiate Browser Payment.
- Debe seleccionar un número de tarjeta para activar un resultado de pago UnionPay SecurePay.
Probar número de tarjeta Código del motor de pagos de respuesta de transacción 2223000000000007APPROVED 4005550000000019ACQUIRER_SYSTEM_ERROR 4508750015741019UNKNOWN 6011000991300009NOT_SUPPORTED 5149612222222229DECLINED 4012000033330026TIMED_OUT - Después de hacer clic en "Continuar", el explorador es redirigido de regreso a la URL proporcionada en la solicitud de Initiate Browser Payment.
Para otros pagos mediante explorador (Alipay, Boleto Bancário, Bancontact, Giropay, GrabPay, iDEAL, Klarna Financing, Klarna Pay Later, Klarna Pay Now, Multibanco, OXXO, POLi, SEPA, Sofortbanking, WeChat Pay)
- Se muestran los detalles de pago proporcionados en la solicitud de Initiate Browser Payment.
- Debe seleccionar un resultado de pago:
SUCCESSDECLINEBAD_REDIRECT_CHECKSUM(no se recomienda para pruebas)
- Para resultados pendientes, usted puede similar la obtención de una notificación al configurar la demora antes de recibir la notificación y el resultado deseado de la notificación.
- El proveedor de servicios de pago mediante explorador devolverá una URL de redirección que usted recibirá.
- A continuación, debe redirigir al pagador a la página específica de pago mediante explorador utilizando la URL proporcionada.
- Después de completar los detalles de pago, el proveedor de servicios de pago mediante explorador procesará la solicitud de transacción y Mastercard Gateway redirigirá al pagador de vuelta al sitio de usted.
Prueba de reglas de filtrado de transacciones para el rango de direcciones IP
Si configuró las reglas de Filtrado de transacciones para el rango de direcciones IP, puede simular el rechazo de una dirección IP prohibida configurando lo siguiente:
- Configure un rango de direcciones IP para rechazar en las reglas de rango de direcciones IP en Merchant Administration.
- Proporcione una dirección IP dentro de ese rango, en el campo
order.referencecuando envíe una solicitud deInitiate Browser Payment.- Para pagos mediante explorador, Alipay, Boleto Bancário, Bancontact, Giropay, GrabPay, iDEAL, Klarna Financing, Klarna Pay Later, Klarna Pay Now,, OXXO, POLi, SEPA, Sofortbanking, WeChat Pay, el valor se debe enviar en el formato "
TEST_IP_ADDRESS<nnn.nnn.nnn.nnn>".Esta prueba no se aplica al método de pago mediante explorador de Multibanco. Esto se debe a que el explorador del pagador no es redirigido al sitio web de Multibanco; por lo tanto, el motor de pagos no puede recuperar la dirección IP del pagador. - Para otros pagos mediante explorador, el valor se debe presentar en el formato "
.TEST_IP_ADDRESS<nnn.nnn.nnn.nnn>".
<nnn.nnn.nnn.nnn> representa un formato IPv4 válido que puede contener entre 7 y 15 caracteres. - Para pagos mediante explorador, Alipay, Boleto Bancário, Bancontact, Giropay, GrabPay, iDEAL, Klarna Financing, Klarna Pay Later, Klarna Pay Now,, OXXO, POLi, SEPA, Sofortbanking, WeChat Pay, el valor se debe enviar en el formato "
Si la dirección IP hace que la transacción sea rechazada, el risk.response.gatewayCode se devolverá como "REJECTED" en la operación Retrieve Transaction.
No existen pruebas específicas para simular un rechazo de países de la lista negra en las reglas de filtrado de transacciones de países de IP; sin embargo, puede simular este escenario al agregar todos los países a la lista de rechazos.