文档

Pay now with Klarna

即时支付，消费者在购买时立即支付全部金额，通常通过银行转账或借记卡。适合希望即时完成交易并且不需要延迟支付的消费者。

Suggest Edits




支付方式属性

属性内容
可用国家代码瑞典 (SE), 挪威 (NO), 丹麦 (DK), 芬兰 (FI), 德国 (DE), 奥地利 (AT), 荷兰 (NL), 英国 (GB), 比利时 (BE), 瑞士 (CH), 意大利 (IT), 西班牙 (ES), 法国 (FR), 葡萄牙 (PT), 波兰 (PL)
消费者货币瑞典克朗 (SEK), 挪威克朗 (NOK), 丹麦克朗 (DKK), 欧元 (EUR), 英镑 (GBP), 瑞士法郎 (CHF), 波兰兹罗提 (PLN)
处理货币瑞典克朗 (SEK), 挪威克朗 (NOK), 丹麦克朗 (DKK), 欧元 (EUR), 英镑 (GBP), 瑞士法郎 (CHF), 波兰兹罗提 (PLN)
结算货币瑞典克朗 (SEK), 挪威克朗 (NOK), 丹麦克朗 (DKK), 欧元 (EUR), 英镑 (GBP), 瑞士法郎 (CHF), 波兰兹罗提 (PLN)
类型 I先买后付 (buyNowPayLater)
类型 IIpaynowklarna
最小交易金额0 EUR, 0 SEK 或 0 CHF
最大交易金额15,000 EUR, 150,000 SEK 或 15,000 CHF
会话超时48小时
退款支持全额退款、部分退款和多次部分退款
退款有效期365 天
拒付支持
集成类型异步

交易流程

  1. 消费者在商家结账时选择使用 Klarna(Pay now) 支付。
  2. 商户系统将付款请求转发给 Future Pay。
  3. Future Pay在 Klarna 创建订单会话以创建 Klarna HPP。
  4. 在Klarna响应后，Future Pay将响应转发给商户。
  5. 商家将消费者重定向到 Klarna HPP 页面，消费者继续支付流程。
  6. 消费者确认付款后，消费者将被重定向到商家的成功页面。

集成

交易调用的特定输入参数

字段名称是否必填类型描述
billingAddress.cityMstring账单地址的城市
billingAddress.postalCodeMstring账单地址的邮政编码
billingAddress.streetMstring账单地址的街道信息
billingAddress.countryMstring账单地址的国家代码（ISO 3166-1 标准）
paymentMethod.holderNameMstring付款人姓名
paymentMethod.shopperEmailMstring付款人电子邮件地址
paymentMethod.telephoneNumberMstring付款人电话号码
countryCodeMstring国家代码（ISO 3166-1 标准）
referenceMstring交易参考号或订单号
returnUrlMstring支付完成后的返回URL
shopperLocaleMstring购物者的语言或地区设置（ISO格式）
taxAmountMstring税费金额

交易调用输入

{
    "lineItems": [
        {
            "unitPrice": 1200,
            "totalAmount": 1200,
            "quantity": 1,
            "taxPercentage": 0,
            "name": "n***1",
            "sku": "sku001"
        },
        {
            "unitPrice": 44,
            "totalAmount": 44,
            "quantity": 1,
            "taxPercentage": 0,
            "name": "n***2",
            "sku": "sku002"
        }
    ],
    "reference": "FAC66BF2F7DA4C23B0E2A0D0D4FB90EF",
    "amount": {
        "currency": "EUR",
        "value": 1244
    },
    "countryCode": "DE",
    "origin": "fffmall.com",
    "paymentMethod": {
        "holderName": "John Doe",
        "telephoneNumber": "0176875508",
        "payerID": "123456",
        "shopperEmail": "[email protected]",
        "type": "paynowklarna"
    },
    "billingAddress": {
        "country": "DE",
        "stateOrProvince": "North Rhine-Westphalia",
        "city": "Bonn",
        "street": "Endenicher Str. 48",
        "postalCode": "30586"
    },
    "returnUrl": "https://ss-dev.natapp4.cc/TestReturn/AReturn",
    "taxAmount": "0",
    "shopperReference": "123456"
}

交易调用输出

{
    "code": "0",
    "msg": "success",
    "serverTime": 1728634467377,
    "data": {
        "action": {
            "paymentMethodType": "paynowklarna",
            "url": "https://r2.girogate.de/klarna/T971/I?tx=2334596569&rs=hjRA8rlvNzKQzVNQMNkTbSNjkr8JIB99&cs=7b6c3c978dab1c386215bd4dcc4fddf830525886680a3c76ba4f87f09e71b1f9",
            "method": "Get",
            "type": "redirect"
        },
        "amount": {
            "currency": "EUR",
            "value": 1244
        },
        "merchantReference": "FAC66BF2F7DA4C23B0E2A0D0D4FB90EF",
        "pspReference": "1844652764534276096",
        "resultCode": "PENDING"
    },
    "success": true
}

附加信息

测试和集成

如果你希望给商户提供访问生产环境的实时测试权限，请遵循以下建议：

  • 提供真实的消费者数据：真实姓名、个人邮箱、个人手机号码、家庭和账单地址。使用测试数据会干扰Klarna在每笔交易中进行的信用/风险检查。
  • 不要提供公司地址作为账单地址。
  • 选择符合Klarna最低要求的商品。Klarna可以拒绝一个请求，如果商品价格过高且消费者没有足够的交易历史。
  • 不要在短时间内从同一设备或IP地址进行多次测试，这会触发速度限制检查，导致交易被Klarna ID拒绝。
  • 重定向消费者：如果你收到一个包含 REDIRECTURL 的 PENDING 响应，将消费者重定向到该URL。在会话或持久存储中存储 REDIRECTSECRET，以便能够在稍后验证响应。

消费者样本数据

点此查看不同国家的消费者样本数据。

Klarna电话号码格式标准

查看Klarna 支持的国家/地区的电话号码格式，确保使用E.164格式标准。

国家代码/货币组合

Klarna 适用的国家代码及其货币组合

  • SE/SEK（瑞典/瑞典克朗）
  • NO/NOK（挪威/挪威克朗）
  • DK/DKK（丹麦/丹麦克朗）
  • FI/EUR（芬兰/欧元）
  • DE/EUR（德国/欧元）
  • AT/EUR（奥地利/欧元）
  • NL/EUR（荷兰/欧元）
  • GB/GBP（英国/英镑）
  • BE/EUR（比利时/欧元）
  • CH/CHF（瑞士/瑞士法郎）
  • IT/EUR（意大利/欧元）
  • ES/EUR（西班牙/欧元）
  • FR/EUR（法国/欧元）
  • PT/EUR（葡萄牙/欧元）
  • PL/PLN（波兰/波兰兹罗提）

品牌指南

有关品牌指南的信息，请参阅Klarna官方网站。

Updated 2 months ago