Pay over time with Klarna

支付方式属性

属性	内容
可用国家代码	瑞典 (SE), 挪威 (NO), 芬兰 (FI), 德国 (DE), 奥地利 (AT)
消费者货币	瑞典克朗 (SEK), 挪威克朗 (NOK), 欧元 (EUR)
处理货币	瑞典克朗 (SEK), 挪威克朗 (NOK), 欧元 (EUR)
结算货币	瑞典克朗 (SEK), 挪威克朗 (NOK), 欧元 (EUR)
类型 I	先买后付 (buyNowPayLater)
类型 II	`payovertimeklarna`
最小交易金额	由国家和时间段决定德国 (DE), 奥地利 (AT): 6个月 = 25 EUR, 12个月 = 120 EUR, 24个月 = 1,000 EUR, 36个月 = 1,500 EUR 芬兰 (FI): 6个月 = 25 EUR, 12个月 = 500 EUR, 24个月 = 1,000 EUR, 36个月 = 1,500 EUR 挪威 (NO): 6个月 = 250 NOK, 12个月 = 5,000 NOK, 24个月 = 10,000 NOK, 36个月 = 15,000 NOK 瑞典 (SE): 6个月 = 250 SEK, 12个月 = 5,000 SEK, 24个月 = 10,000 SEK, 36个月 = 15,000 SEK
最大交易金额	最大限额由Klarna设定
会话超时	48小时
退款	支持全额退款、部分退款和多次部分退款
退款有效期	365 天
拒付	支持
集成类型	异步

交易流程

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

集成

交易调用的特定输入参数

字段名称	是否必填	类型	描述
`billingAddress.city`	M	string	账单地址的城市
`billingAddress.postalCode`	M	string	账单地址的邮政编码
`billingAddress.street`	M	string	账单地址的街道信息
`billingAddress.country`	M	string	账单地址的国家代码（ISO 3166-1 标准）
`paymentMethod.holderName`	M	string	付款人姓名
`paymentMethod.shopperEmail`	M	string	付款人电子邮件地址
`paymentMethod.telephoneNumber`	M	string	付款人电话号码
`countryCode`	M	string	国家代码（ISO 3166-1 标准）
`reference`	M	string	交易参考号或订单号
`returnUrl`	M	string	支付完成后的返回URL
`shopperLocale`	M	string	购物者的语言或地区设置（ISO格式）
`taxAmount`	M	string	税费金额

交易调用输入

{
    "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": "Mooney Taito",
        "telephoneNumber": "0176-875508",
        "payerID": "[email protected]",
        "shopperEmail": "[email protected]",
        "type": "payovertimeklarna"
    },
    "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": "[email protected]"
}

交易调用输出

{
    "code": "0",
    "msg": "success",
    "serverTime": 1728634467377,
    "data": {
        "action": {
            "paymentMethodType": "payovertimeklarna",
            "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 适用的国家代码及其货币组合

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官方网站。