Iniciar una solicitud de pago Alma
El sitio web comercial inicia una solicitud de pago con una llamada al Web Service Charge/CreatePayment.
Como respuesta, el servidor del sitio web comercial recupera un formToken, que es un objeto cifrado que permite iniciar el formulario inteligente (smartForm) con la información de la transacción y la información necesaria para configurar la tienda.
Para forzar los modos de pago, utilice los campos paymentMethodsal crear el formToken.
Ejemplos :
- Si desea mostrar solamente el medio de pago Alma en 2 plazos:
"paymentMethods": ["ALMA_2X"]
- Si desea mostrar el medio de pago Alma en 2 plazos, Alma en 3 plazos y el pago con tarjeta:
"paymentMethods": ["ALMA_2X","ALMA_3X", "CARDS"]
- Si desea mostrar el medio de pago Alma en 2 plazos, Alma en 3 plazos, Alma en 4 plazos, Alma en 10 plazos, Alma en 12 plazos y el pago con tarjeta:
"paymentMethods": ["ALMA_2X","ALMA_3X","ALMA_4X","ALMA_10X","ALMA_12X","CARDS"]
Microsoft ha dejado Internet Explorer 11 obsoleto desde junio de 2022.
La integración del formulario inteligente (smartForm) no es compatible con este navegador.
Utilice los siguientes campos para hacer la solicitud:
Nombre del campo | Descripción | Obligatorio |
---|---|---|
formAction | Tipo de comportamiento que desea al crear la transacción. Su valor debe ser PAYMENT. El formulario inteligente (smartForm) es compatible con un wallet (al integrar el campo formAction con el valor CUSTOMER_WALLET) solo en "Modo lista" o en "Modo pop-in". | No |
amount | Monto a pagar, expresado en su unidad monetaria más pequeña (el centavo para el euro). | Sí |
currency | Moneda del pago. Código ISO 4217 alpha-3. Ejemplo: "EUR" para el euro | Sí |
orderId | Referencia del pedido. | No |
ipnTargetUrl | Permite sobrecargar la URL de notificación instantánea (también llamada IPN) en el formulario. | No |
paymentMethods | Lista de medios de pago para ofrecer al comprador | No |
customer.email | Dirección de e-mail para el envío del recibo de pago al comprador. | No |
transactionOptions.cardOptions.captureDelay | Plazo de captura. | No |
customer.reference | Identificador del comprador en el sitio web comercial | No |
customer.billingDetails.firstName | Nombre del comprador. | No |
customer.billingDetails.lastName | Apellido del comprador. | No |
customer.billingDetails.phoneNumber | Número de teléfono del comprador. | No |
customer.billingDetails.address | Dirección del comprador. | No |
customer.billingDetails.zipCode | Código postal | No |
customer.billingDetails.city | Ciudad | No |
Para una descripción más completa de los campos que debe utilizar, testee el Web Service Charge/CreatePayment desde nuestro playground.
Ejemplo de solicitud
https://api.lyra.com/api-payment/V4/Charge/CreatePayment
{ "amount": "6000", "currency": "EUR", "orderId": "demo-6336a0db503c6", "paymentMethods":[ "ALMA_2X","ALMA_3X","ALMA_4X","CARDS"], "customer": { "reference": "My-Reference", "email": "main@example.com", "billingDetails": { "title": "M.", "category": "PRIVATE", "firstName": "ALFRED", "lastName": "DUBOIS", "phoneNumber": "0673567800", "streetNumber": "3", "address": "rue du Gorp", "district": "Saint-Michel", "zipCode": "31000", "city": Toulouse }, "formTokenVersion": 4 }