Integration Types
Otras características
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
El vínculo de pago es un método seguro para recibir pagos a través de una URL de vínculo de pago simple. Le permite proporcionar un modo adicional de aceptar un pago que implica generar una dirección URL de enlace de pago y luego compartirla con el pagador a través de varios canales de comunicación, como correo electrónico, mensaje de texto y código QR. Cuando un pagador hace clic en la URL del vínculo de pago, se le redirige a la página de pago, donde puede seleccionar el método de pago para completar la transacción.
Los beneficios clave del vínculo de pago son los siguientes:
Cuando los pagadores reciben una URL de vínculo de pago única para el pago, pueden hacer clic en el vínculo y completar el pago.
Este diagrama muestra los diferentes pasos para completar una transacción utilizando un vínculo de pago.
Antes de iniciar una operación Initiate Checkout, asegúrese de tener establecidos los atributos siguientes para los enlaces de pago:
Si se especifica y se produce un error, el motor de pagos proporcionará el código de error (errorCode
) y la descripción (errorDescription
) como parámetros de cadena de consulta. El motor de pagos también conservará cualquier parámetro de cadena de consulta que haya incluido en errorUrl.
Por ejemplo, si especifica paymentLink.errorUrl como https://merchant.com/myPaymentLinkErrorPage.html, en caso de error, este errorUrl recibiría los siguientes parámetros de cadena de consulta del motor de pagos: https://merchant.com/myPaymentLinkErrorPage.html?errorCode=ERROR_CODE&errorDescription=Error+message. Consulte la sección Códigos de error y descripciones para obtener más información.
Para crear una URL de vínculo de pago, debe solicitar una operación Initiate Checkout
con el modo payment link
. Este es un fragmento de muestra para la operación Initiate Checkout
.
{ "apiOperation": "INITIATE_CHECKOUT", "checkoutMode": "PAYMENT_LINK", "interaction": { "operation": "AUTHORIZE", "merchant": { "name": "<your_merchant_name>", "url": "<website_url>" } }, "order": { "currency": "USD", "amount": 1234, "id": "<order_ID>", "description": "Ordered goods" }, "paymentLink": { "expiryDateTime": "2021-12-10T02:16:00.993Z", "numberOfAllowedAttempts": "3" } }
Referencia de API de Initiate Checkout [REST][NVP]
Una respuesta correcta a esta operación contiene los parámetros URL del vínculo de pago e ID del vínculo de pago, que se pueden compartir con el cliente para realizar el pago.
{ "checkoutMode": "PAYMENT_LINK", "merchant": "<your_merchant_id>", "paymentLink": { "expiryDateTime": "2021-12-10T02:16:00.993Z", "id": "PAYLINK0001060519617G19059484L2", "numberOfAllowedAttempts": 3, "url": https://evopaymentsmexico.gateway.mastercard.com/pbl/PAYLINK0001060519617G19059484L2 }, "result": "SUCCESS", "successIndicator": "c89f62baad174e12" }
El negocio comparte el enlace de pago con el pagador a través de varios canales de comunicación, como correo electrónico, mensaje de texto y códigos QR. El pagador hace clic en el vínculo de pago que lo redirige a la página de pago de Hosted Checkout en un navegador y completa la transacción usando uno de los métodos de pago disponibles.
La operación Delete Payment Link le permite eliminar o invalidar explícitamente el vínculo de pago si el pagador ya realizó el pago fuera de línea o si el pago ya no es necesario.
URL | https://evopaymentsmexico.gateway.mastercard.com/api/rest/version/64/merchant/{merchantId}/link/{linkId} |
Método HTTP | DELETE |
Referencia de API de Delete Payment Link [REST][NVP]
La sesión en el motor de pagos vence automáticamente si:
Una vez que haya configurado la cuenta y creado su integración, debe probar el vínculo de pago con el perfil de pruebas del negocio (su ID de negocio comienza con "TEST"). El motor de pagos proporciona una página de Hosted Checkout de prueba para verificar el enlace de pago.
Se recomienda que opte por el servicio de notificaciones para recibir notificaciones webhook si el pago se realiza correctamente. Para obtener información adicional sobre las notificaciones y la configuración de webhook, consulte Notificaciones de webhook.
Esta tabla describe la lista de códigos de error con sus descripciones.
Código de error | Descripción |
---|---|
EXPIRED | El enlace de pago venció. Comuníquese con el solicitante del pago. |
PAID | El pedido asociado con este enlace de pago ya se pagó. Comuníquese con el solicitante del pago. |
USAGE_COUNT_EXCEEDED | Se excedió el máximo de intentos permitidos. Comuníquese con el solicitante del pago. |
DOES_NOT_EXIST | Este enlace de pago no es válido. Comuníquese con el solicitante del pago. |
UNEXPECTED_ERROR | Se produjo un error inesperado. Comuníquese con el solicitante del pago. |
DELETED | Este enlace de pago se eliminó. Comuníquese con el solicitante del pago. |