Integration Types
Otras características
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
Klarna Pay Now es un método de pago inmediato proporcionado por Klarna AB, un popular banco sueco, a los pagadores en Europa. Los pagadores pueden pagar a través de una transferencia bancaria, un débito directo o cualquier tarjeta.
Klarna Pay Now se admite en el Mastercard Gateway. Esta página describe los detalles de la integración específicos de Klarna Pay Now. Se recomienda que lea las pautas de integración para los pagos mediante explorador, antes de crear una integración de Klarna Pay Now.
Para ofrecer Klarna Pay Now mediante el Mastercard Gateway:
Klarna Pay Now admite transacciones que se originan en varios países con sus monedas correspondientes.
País | Moneda |
---|---|
Austria (AUT) | EUR |
Bélgica (BEL) | EUR |
Alemania (DEU) | EUR |
Italia (ITA) | EUR |
Países Bajos (NLD) | EUR |
Suecia (SWE) | SEK |
España (ESP) | EUR |
Suiza (CHE) | CHF |
La integración de Hosted Checkout le permite recopilar detalles de pago del pagador a través de una interacción que el motor de pagos hospeda y muestra.
Desde la API versión 65 en adelante, Klarna Pay Now está disponible automáticamente como método de pago una vez que your payment service provider lo habilita y configura para este método de pago.
Para conocer más detalles, consulte Pagos mediante explorador a través de la integración de Hosted Checkout.
La integración de Direct Payment le permite ofrecer Klarna Pay Now en su propia página de pago.
Klarna Pay Now es compatible con API de la versión 63 en adelante.
Realice una solicitud Initiate Browser Payment
donde sourceOfFunds.type = KLARNA_PAY_NOW
y browserPayment.operation = PAY
(Klarna Pay Now no admite la operación Authorize).
A partir de la versión 65 de API, utilice el campo bankAccountCountryCode
. Este campo especifica el país donde los pagadores tienen sus cuentas bancarias.
{ "apiOperation":"INITIATE_BROWSER_PAYMENT", "billing":{ "address":{ "city":"Edinburgh", "company":"MPGS", "country":"DEU", "postcodeZip":"EH123AB", "stateProvince":"Scotland", "street":"OceanPoint", "street2":"OceanDrive" } }, "browserPayment":{ "operation":"PAY", "returnUrl":"<your_merchant_URL>" }, "customer":{ "account":{ "id":"custoAccount" }, "dateOfBirth":"1999-12-31", "email":"john.smith@example.com", "firstName":"John", "lastName":"Smith", "mobilePhone":"01234567890", "nationalId":"X4RTBPFW4" }, "order":{ "amount":"154.16", "currency":"EUR", "item":[ { "name":"Diesel Jeans", "quantity":"1", "unitPrice":"70.83" }, { "name":"Adidas Trainers", "quantity":"1", "unitPrice":"83.33" } ] }, "shipping":{ "address":{ "city":"Shipsville", "country":"GBR", "postcodeZip":"EH67DX", "stateProvince":"Scotland", "street":"2ShippingHeights", "street2":"ShipsDrive" }, "contact":{ "email":"john.smith@example.com", "firstName":"John", "lastName":"Smith" } }, "sourceOfFunds":{ "type":"KLARNA_PAY_NOW", "provided":{ "klarnaPayNow":{ "bankAccountCountryCode":"GBR" } } } }
Además de los campos estándar obligatorios en una solicitud de pago mediante explorador, proporcione la siguiente información obligatoria para el procesamiento de Klarna Pay Now.
Estos campos son obligatorios, a menos que se indique lo contrario, y son necesarios para respaldar los procesos de evaluación de riesgos y verificación de crédito de Klarna Pay Now. La información de contacto del pagador se utiliza para comunicarse con el pagador y para entregar las facturas electrónicas y las notificaciones de pago.
billing.address.city
billing.address.country
billing.address.postcodeZip
billing.address.street
customer.email
customer.firstName
customer.lastName
customer.mobilePhone
: este campo es obligatorio cuando no se proporciona customer.phone
. customer.phone
: este campo es obligatorio cuando no se proporciona customer.mobilePhone
. customer.nationalId
: este campo es opcional.Estos campos son obligatorios cuando se proporciona un valor para cualquier campo shipping.address.*
o shipping.contact.*
.
shipping.address.city
shipping.address.country
shipping.address.postcodeZip
shipping.address.street
shipping.contact.email
shipping.contact.firstName
shipping.contact.lastName
Proporcione todos los detalles sobre cada artículo del pedido que se compró, para que Klarna Pay Now pueda validar y mostrar correctamente esta información a los pagadores y para respaldar los procesos de verificación de riesgo y crédito de Klarna Pay Now.
order.item[n].name
order.item[n].quantity
: el valor de este campo debe ser un entero.order.item[n].unitPrice
order.item[n].unitDiscountAmount
: este campo es obligatorio cuando se ha aplicado un descuento al artículo y debe proporcionarse si se ingresa un valor en el campo order.discount.amount
.order.item[n].unitTaxAmount
: este campo es obligatorio cuando un pagador tiene que pagar impuestos sobre el artículo.order.item[n].detail.unitTaxRate
: este campo es obligatorio cuando se ha proporcionado un valor para el monto del impuesto unitario.Debe proporcionar el código de país de la cuenta bancaria del pagador en el campo sourceOfFunds.provided.klarnaPayNow.bankAccountCountryCode.
El monto total del impuesto que se debe pagar por el pedido se muestra a los pagadores durante el flujo de pago. Si el monto que se debe pagar por el transporte y envío incluye el impuesto, debe crear una línea de pedido para representar el transporte y envío, de modo que se pueda proporcionar el monto del impuesto discreto. Si no se aplica el impuesto, el monto de transporte y envío se puede proporcionar en el campo order.shippingAndHandlingAmount
.
Para configurar el idioma que prefiere que Klarna Pay Now utilice para las páginas que se muestran a los pagadores, complete el campo browserPayment.preferredLanguage
en la solicitud de Initiate Browser Payment. Sin embargo, Klarna Pay Now solo admite el idioma nacional principal del billing.address.country
o inglés.
Los pagos de Klarna Pay Now conllevan el riesgo de contracargos. Si los pagadores disputan con éxito un pago con Klarna Pay Now, se creará una transacción de contracargo en el pedido. Para obtener más información, consulte transacción de contracargo.
La tabla siguiente muestra los códigos de respuesta de transacción para los posibles escenarios que puede encontrar después de iniciar Klarna Pay Now.
Respuesta de Initiate Browser Payment |
Qué significa esto... |
---|---|
response.gatewayCode=SUBMITTED result=SUCCESS |
Redirigir al pagador utilizando la URL proporcionada en la respuesta. |
Respuesta de Retrieve Transaction/Retrieve Order |
Qué significa esto... |
response.gatewayCode=APPROVED result=SUCCESS |
El pago se realizó correctamente. |
response.gatewayCode= PENDING result=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= CANCELLED result=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_ERROR result=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_OUT result=FAILURE |
Trate esto como un pago rechazado. El Mastercard Gateway hará lo posible para asegurarse de que la transacción no se puede realizar o revertirá la transacción. |
Para los pagos aprobados, el Mastercard Gateway le proporcionará el ID que Klarna Pay Now asignó a este pedido en el campo transaction.acquirer.additionalResponseData
. Esta información puede ser útil para las comunicaciones que pueda tener directamente con Klarna Pay Now.
Si está suscrito a las notificaciones de webhook del Mastercard Gateway, puede que reciba notificaciones adicionales sobre actualizaciones del estado de financiamiento y contracargos.
El Mastercard Gateway proporciona un emulador de pagos mediante explorador que le permite probar su integración con Klarna Pay Now.