Klarna Redirect

参数	必选	类型	说明
paymentMethod	Y	String	目前固定为 klarna
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	Y	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

可选

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

示例值:

2880

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","billingAddress":{"houseNo":"El Gallo Giro(https: //gallogiro.com/)","email":"dynamic_3d@useepay.com","phoneNo":"1235854433","firstName":"amber","lastName":"lei","street":"7148 Pacific Blvd, Huntington Park, CA","postalCode":"90225","city":"Guatemala","state":"GU","country":"GT"}}

orderInfo

string

可选

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

示例值:

{"subject":"order title","shippingAddress":{"email":"dynami1c_3d@useepay.com","phoneNo":"123123","firstName":"amber","lastName":"lei","street":"Heathcoat House, 20 Savile Row","postalCode":"W1S 3PR","city":"Guatemala","state":"GU","country":"GT"}}

userInfo

string

必需

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

示例值:

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

autoRedirect

string

可选

默认true, 是否302跳转到收银台页面

示例值:

false

示例代码

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/cashier' \
--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=2880' \
--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","billingAddress":{"houseNo":"El Gallo Giro(https: //gallogiro.com/)","email":"dynamic_3d@useepay.com","phoneNo":"1235854433","firstName":"amber","lastName":"lei","street":"7148 Pacific Blvd, Huntington Park, CA","postalCode":"90225","city":"Guatemala","state":"GU","country":"GT"}}' \
--data-urlencode 'orderInfo={"subject":"order title","shippingAddress":{"email":"dynami1c_3d@useepay.com","phoneNo":"123123","firstName":"amber","lastName":"lei","street":"Heathcoat House, 20 Savile Row","postalCode":"W1S 3PR","city":"Guatemala","state":"GU","country":"GT"}}' \
--data-urlencode 'userInfo={  "userId": "victor007",  "ip": "103.25.65.178",  "email": "victor.yang@useepay.com",  "phoneNo": "(323) 585-4433"}' \
--data-urlencode 'autoRedirect=false'

返回响应

🟢200成功

application/json

Body

amount

string

金额

必需

redirectUrl

string

收银台地址

可选

当resultCode=received 时存在

resultCode

string

业务返回码

必需

判断请求是否成功

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": "100",
  "redirectUrl": "https://checkout1.uat.useepay.com/v2?accessToken=eAG1Vs1uI0UQfhU0yBKgtT09v7ZPOI69ySqbdTYJASEU9Uy3Pb2e6R5198Q7rCIhxAGJMxcegCsXEA-EtOxjUDU_iVm0R8ayM1NdXf1V1ffV5I2jualy68zeODk19pwW3Jk5ORfOE6cyXF-pHZencqOc2ddvnJRqdg63TuC5cH3WXHgH3rh2mWa8CXAnDO1sTYRmC3G9gBASBi6JgnA6jf0wIhG4FVynGZX2lIFfiPHaK_YnBJY13wpjub4GPI3LnUit0sS5_-aJI8yCyotKpLs1rWF7zQ1sKTMleYOUeH44CYPA98G8EfohR1okXKMrrSFskyEkqCppNcZ5tm7XCi7tc24zhdh2OdWSOvdPnC21fE_rS1XpFCt2fblcrudfvb_HPJTtqi4BGRbRwt1BLMhBtlVXMheS3yZU7oTcNtkpzQ7AUa1FV4L9fj8C5KNUFXBmWmnNZYq4l9cvwbBVipmumU2Mj6ywOYeVvtYvmsiYFPGmaURcf-hNXDYMIjcZUhZNhxFjgc8TOqG-BxtbKM0GF4pKPM8joUdi148nuG41lWZeAJUc0hCiMWDaYDEUDoey8YKKHJ5ZDTmL9NZnnwPL-GMmNM8XSm7Etu8IZbSE3sMeN4BTkCdbfgY_Fd1iZCQIh1Yyxtkq36IfWiS7EgVfqFzh1o9XqyBoQG0Lu9AcmofLzoxE0zj0Y8jAj3woW2GfKyY2dbcau15EJj7wNpgA1SB5QgIPSXeZqf0CycLUXnYw8kdUXAIIyFVeAQ8RACGxd4zICgTb0hjKhBcJIuRm35gPiKBfPlNbFGBmbWlm43HGvKHJhpYbO1LGDFMJj4Ajo2JEc1FXMjVIknFRmhIcxu3545SaDLg0fk9t452l9uWNp_Wri5N1qL-cg6LjuX-8W0evLkUW3Q6W4eBoOZgvB8tgcLQazAlapkdoXMaDyXQwiW89FwjiEvj6keeNSmDzY4IdLStq__7lh7d__PTut5_f_f7r2x__RB-sPuCCDCkrhJyDDchxZP9bSDRX1iq5Fq85cAraUkLbQTlrlefYQJBbCEYt7mhag1Gk9bVG9qF4LFUJVZ1-NGdC8xSb33PKQIPnZXlE9UkIW5Bmj6Z1emA6EjkGxeaiBz4CiGNuUi1KmFOHrgoAFzcgpQPjAgZnpnLWTYH-pMXd3YHTSqlWBf3yU1Q4g0MOjm5sXZgeTseX_rGRPRL5IaMbnhhhH9K2VNt_SSeY4weTq-W5stCelFqh5MNQxNCWJv8zMZ9mwlsF_oW_P7abeLWYixs_WzzNXq1Pkm8X-vXthsJrQclPyKcj-NtiumqG3gymBk93qrJo5UWZg_5RZgFIvn_uWHnO9ycKXjZsTWsc_WucMo9eLX_Gd83A47owLzYwrpjAgjxw66_vvk-oYFVHrnYOAh8RwMzxJpOmYro-UyntmQNT8Hn3Frxsu-E69zAwe2a2wVH1IHoy9UYkmozIKIxmE9cNx73bF16FwSXn7KLiul5QSN2ZWV3xRwF-YMK0L_ezKpMLLBdA3dDcYPa0LHMOBekRnjKoTK_TfjBhtiNDJUvU61E31LFy-A8ExCpUOStoKWYI1cwS6vkxd90hdad0SAjnw2QT0GFK4pDGQRLH08C5_wf88L5k",
  "resultCode": "received",
  "sign": "224dc8307601f20c3e1adcdbef69f158",
  "errorCode": "0000",
  "transactionId": "129c6103-280d-460b-ad69-6dd43eba8a32",
  "errorMsg": "Successful payment",
  "token": "mop:mapi:redis:ba237e00-a09a-11ee-bf4a-c175a74b7794",
  "transactionType": "pay",
  "reference": "1012312221521703782",
  "echoParam": "echoParam",
  "signType": "MD5",
  "currency": "EUR",
  "merchantNo": "500000000007381"
}

Klarna Redirect

产品描述

时序图

Request 对象参数说明

PayerInfo Object

billingAddress Object

orderInfo 订单信息

请求参数

示例代码

返回响应

Klarna Redirect

产品描述#

时序图#

Request 对象参数说明#

PayerInfo Object#

billingAddress Object#

orderInfo 订单信息#

请求参数

示例代码

返回响应

产品描述

时序图

Request 对象参数说明

PayerInfo Object

billingAddress Object

orderInfo 订单信息