Klarna direct

支持的国家	币种
AT, DE, FI, AT,NL,DE	EUR
NO	NOK
SE	SEK
GB	GBP
CH	CHF
DK	DKK

参数	必选	类型	说明
paymentMethod	Y	String	目前固定为 konbini
countryCode	Y	String	参考上述支持国家
billingAddress	Y	Json String	账单信息

参数	必选	类型	说明
firstName	Y	string	收货人名
lastName	Y	string	收货人姓
email	Y	string	收货邮箱
phoneNo	Y	string	收货手机号
street	N	string	收货街道地址
houseNo	N	string	收货街道地址和门牌号当street存在时可以不填
postalCode	N	string	邮编，如果该国家或地区由邮编必须传，否则可以不传
city	N	string	城市
state	N	string	省/州/地区, 需满足 ISO 3166-2
country	N	string	国家，ISO 两位大写英文国家代码, 需满足 ISO 3166-1

参数	必选	类型	说明
subject	Y	string	订单标题
goodsInfo	Y	array	商品信息, 请参考 goodsInfo
shippingAddress	N	object	收货地址, 请参考 shippingAddress

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/x-www-form-urlencoded

Body 参数application/x-www-form-urlencoded

transactionType

string

必需

交易类型 : pay

示例值:

pay

version

string

必需

目前固定为 1.0 (5)

示例值:

1.0

signType

string

必需

商户生成签名字符串所使用的签名算法类型，目前支持:RSA/MD5

示例值:

MD5

merchantNo

string

商户号

必需

示例值:

500000000007362

transactionId

string

商户订单号

必需

示例值:

202212070142347

transactionExpirationTime

string

可选

过期时间本地化支付，建议时间设长一些

示例值:

10

appId

string

网站域名

必需

示例值:

www.pay.com

amount

string

必需

支付金额，单位为对应币种的最小货币单位(详见 ISO 4217)

示例值:

123

redirectUrl

string

跳转商户地址

可选

示例值:

https://gatewaytest.useepay.com/gateway-test/redirectV2u0

currency

string

必需

3 位 ISO 大写字母货币代码(详见 ISO 4217) 目前仅支持EUR

示例值:

USD

notifyUrl

string

异步通知

必需

示例值:

https://gatewaytest.useepay.com/gateway-test/notifyV2u0

echoParam

string

可选

回声参数，响应报文会原样返回

示例值:

echoParam

payerInfo

string

必需

Json格式的String付款方信息,请下方

示例值:

{"paymentMethod":"klarna","countryCode":"DE","billingAddress":{"houseNo":"El Gallo Giro(https://gallogiro.com/)","email":"amber.lei@useepay.com","phoneNo":"1235854433","firstName":"amber","lastName":"Yang","stlogreet":"7148 Pacific Blvd, Huntington Park, CA","postalCode":"90225","city":"Huntington Park","state":"CA","country":"DE","street":"street"}}

orderInfo

string

可选

json string,订单信息,请参考下方

示例值:

{"subject":"description","goodsInfo":[{"name":"商品名称","body":"商品描述","category":"商品类目","categoryTree":"商品类目树，不同级别类目使用”|”分割","brand":"商品品牌","quantity":1,"price":1234,"url":"商品url","sku":"商品sku","image":"商品图片url"}],"shippingAddress":{"email":"amber.lei@useepay.com","phoneNo":"123123","firstName":"Victor","lastName":"Yang","street":"Heathcoat House, 20 Savile Row","postalCode":"W1S 3PR","city":"London","state":"LND","country":"DE"}}

userInfo

string

必需

json string,消费者信息,请参考消费者信息

示例值:

{ "userId": "victor007", "ip": "103.25.65.178", "email": "victor.yang@useepay.com", "phoneNo": "(323) 585-4433", "createTime": "20200520131400"}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://pay-gateway1.uat.useepay.com/api' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'transactionType=pay' \
--data-urlencode 'version=1.0' \
--data-urlencode 'signType=MD5' \
--data-urlencode 'merchantNo=500000000007362' \
--data-urlencode 'transactionId=202212070142347' \
--data-urlencode 'transactionExpirationTime=10' \
--data-urlencode 'appId=www.pay.com' \
--data-urlencode 'amount=123' \
--data-urlencode 'redirectUrl=https://gatewaytest.useepay.com/gateway-test/redirectV2u0' \
--data-urlencode 'currency=USD' \
--data-urlencode 'notifyUrl=https://gatewaytest.useepay.com/gateway-test/notifyV2u0' \
--data-urlencode 'echoParam=echoParam' \
--data-urlencode 'payerInfo={"paymentMethod":"klarna","countryCode":"DE","billingAddress":{"houseNo":"El Gallo Giro(https://gallogiro.com/)","email":"amber.lei@useepay.com","phoneNo":"1235854433","firstName":"amber","lastName":"Yang","stlogreet":"7148 Pacific Blvd, Huntington Park, CA","postalCode":"90225","city":"Huntington Park","state":"CA","country":"DE","street":"street"}}' \
--data-urlencode 'orderInfo={"subject":"description","goodsInfo":[{"name":"商品名称","body":"商品描述","category":"商品类目","categoryTree":"商品类目树，不同级别类目使用”|”分割","brand":"商品品牌","quantity":1,"price":1234,"url":"商品url","sku":"商品sku","image":"商品图片url"}],"shippingAddress":{"email":"amber.lei@useepay.com","phoneNo":"123123","firstName":"Victor","lastName":"Yang","street":"Heathcoat House, 20 Savile Row","postalCode":"W1S 3PR","city":"London","state":"LND","country":"DE"}}' \
--data-urlencode 'userInfo={  "userId": "victor007",  "ip": "103.25.65.178",  "email": "victor.yang@useepay.com",  "phoneNo": "(323) 585-4433",  "createTime": "20200520131400"}'

返回响应

🟢200成功

application/json

Body

amount

string

金额

必需

redirectUrl

string

收银台地址

可选

当resultCode=challenge时存在

resultCode

string

业务返回码

必需

判断交易是否成功 challenge表示收银台请求被成功接受，可以返回redirectUrl给消费者

sign

string

签名

必需

验证签名

errorCode

string

错误返回码

可选

用于展示给消费者具体的错误信息，可参考错误码页面

transactionId

string

商户订单号

必需

errorMsg

string

错误返回信息

可选

transactionType

string

交易类型

必需

pay

reference

string

业务流水号

可选

UseePay的业务流水号

echoParam

string

必需

max=256 回声参数，响应报文会原样返回

signType

string

签名类型

必需

currency

string

币种

可选

merchantNo

string

商户号

必需

商户号

redirectMethod

string

可选

重定向请求方法：get\post

redirectParam

string

可选

重定向请求所需携带的参数。当业务结果码=Challenge 时返回

示例

{
    "amount": "10000",
    "redirectUrl": "https://r2.girogate.de/klarna/T971/I?tx=2082117755&rs=VafOZYt1r63slNyIy9M7kn9W3kON7Z82&cs=ef46cd83ca104e56e7087f55a6e8a58563c852989272642e3d0737256d785ad0",
    "resultCode": "challenge",
    "sign": "eede407042a59a90dd891e2a0146fecd",
    "errorCode": "3200",
    "transactionId": "202305291225132",
    "errorMsg": "Transaction is pending",
    "transactionType": "pay",
    "reference": "1012305290025689145",
    "redirectMethod": "POST",
    "echoParam": "echoParam",
    "redirectParam": "{}",
    "reserved": "",
    "signType": "MD5",
    "currency": "EUR",
    "merchantNo": "500000000007362"
}

产品描述

时序图

klarna支持的国家

Request 对象参数说明

PayerInfo Object

billingAddress Object

orderInfo 订单信息

请求参数

示例代码

返回响应

Klarna direct

产品描述#

时序图#

klarna支持的国家#

Request 对象参数说明#

PayerInfo Object#

billingAddress Object#

orderInfo 订单信息#

请求参数

示例代码

返回响应

产品描述

时序图

klarna支持的国家

Request 对象参数说明

PayerInfo Object

billingAddress Object

orderInfo 订单信息