payeasy 收银台模式
POST
/cashier功能说明
时序图
sequenceDiagram
Customer->>Merchant: 点击支付
Merchant->>UseePay Server: 调用/cashier接口
UseePay Server->>Merchant: Response[redirectUrl(收银台)]
Merchant->>Customer: 展示收银台页面
Customer->>UseePay收银台: 使用konbin进行支付
UseePay收银台 ->> UseePay Server: 请求支付
UseePay Server->>UseePay收银台: 展示支付结果
UseePay收银台->>Merchant: 展示支付结果,并同步通知/cashier接口传输redirectUrl页面
UseePay Server-->>Merchant: 异步通知notifyUrl接口
请求对象参数说明
PayerInfo 请求参数说明
参数 | 必选 | 类型 | 说明 |
---|---|---|---|
paymentMethod | Y | String | 目前固定为 payeasy |
billingAddress | Y | Json String | 账单信息 |
billingAddress Object
参数 | 必选 | 类型 | 说明 |
---|---|---|---|
firstName | Y | string | 收货人名 |
lastName | Y | string | 收货人姓 |
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 |
orderInfo 订单信息
参数 | 必选 | 类型 | 说明 |
---|---|---|---|
subject | Y | string | 订单标题 |
goodsInfo | N | array | 商品信息, 请参考 goodsInfo |
shippingAddress | N | object | 收货地址, 请参考 shippingAddress |
请求参数
Header 参数
Content-Type
string
必需
示例值:
application/x-www-form-urlencoded
Body 参数application/x-www-form-urlencoded
amount
string
必需
支付金额,单位为对应币种的最小货币单位(详见 ISO 4217)(12)
示例值:
100
appId
string
必需
max=128 网站域名
示例值:
www.pay.com
autoRedirect
string
可选
是否302跳转 true/ false 默认 true
示例值:
false
country
string
可选
示例值:
JP
echoParam
string
可选
回声参数,响应报文会原样返回(256)
示例值:
echoParam
merchantNo
string
必需
merchantNo
示例值:
500000000007362
notifyUrl
string
异步通知(512)
示例值:
http://gatewaytest.useepay.com/notifyV2u0
orderInfo
string
必需
订单信息, 请参考上方文档参数描述
示例值:
{"subject":"order title","goodsInfo":[{"id":"商品编号","name":"商品名称","body":"商品描述","category":"商品类目","categoryTree":"商品类目树,不同级别类目使用”|”分割","brand":"商品品牌","quantity":1,"price":1234,"url":"商品url","sku":"商品sku","image":"商品图片url"}],"shippingAddress":{"email":"haile1y@useepay.com","phoneNo":"123123","firstName":"Victor","lastName":"Yang","street":"Heathcoat House, 20 Savile Row","postalCode":"W1S 3PR","city":"London","state":"LND","country":"GB"}}
payerInfo
string
必需
Json格式的String 付款方信息, 请下方
示例值:
{"paymentMethod":"payeasy","billingAddress":{"houseNo":"El Gallo Giro(https://gallogiro.com/)","email":"hai1ley@useepay.com","phoneNo":"1235854433","firstName":"amber","lastName":"Yang","stlogreet":"7148 Pacific Blvd, Huntington Park, CA","postalCode":"90225","city":"Huntington Park","state":"CA","country":"MX","street":"street"}}
redirectUrl
string
必需
跳转商户地址(512)
示例值:
http://192.168.1.56:8005/redirectV2u0
sign
string
可选
示例值:
9ee208a2dcdd4bbc9ba0a99be4b6b0d8
signType
string
必需
max=16 商户生成签名字符串所使用的签名算法类型 RSA/MD5
示例值:
MD5
terminalType
string
可选
示例值:
WEB
transactionExpirationTime
string
可选
maxlength=6 过期时间,本地化过期时间建议7天以上
示例值:
1880
transactionId
string
必需
max=64 商户订单号,建议每次请求的 transactionId 唯一,有利于后续订单查询和对账。
示例值:
490f9dc6-59c9-49b5-8c88-2a948f1b4d3b
transactionType
string
必需
交易类型 : pay
示例值:
pay
userInfo
string
必需
示例值:
{"userId":"victor1","ip":"103.25.65.178","email":"useepay@useepay.com"}
version
string
必需
max=5 调用的接口版本,固定为:1.0
示例值:
1.0
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
amount
string
金额
redirectUrl
string
收银台地址
当resultCode=received时存在
resultCode
string
业务返回码
判断交易是否成功 received 表示收银台请求被成功接受,可以返回redirectUrl给消费者
sign
string
签名
验证签名
errorCode
string
错误返回码
用于展示给消费者具体的错误信息,可参考错误码页面
transactionId
string
商户订单号
errorMsg
string
错误返回信息
token
string
token
当resultCode=received时存在
transactionType
string
交易类型
pay/authorization
reference
string
业务流水号
UseePay的业务流水号
echoParam
string
可选
signType
string
签名类型
currency
string
币种
merchantNo
string
商户号
示例
成功示例
{
"amount": "100",
"redirectUrl": "https://checkout1.uat.useepay.com/v2?accessToken=eAFlVVtvG0UU_ivR9NV29mo7-0TiNrQoSY2SUlVNhWZ3xutRdmeW2dm4qxAJXkojpUoRl5cKibciISHgBQSF_hdU17zxFzhn12svIVGszLl-55zvHJ8RzfMiMSQ4IxOhc3NAU04CQtOQa9IhCV2JHlAZgySjJdd35EShS6QKaXQJDu-Na13KpdnnZqoYCNGW5iU575CYGj6j5aEqdIQJ7h3eujXefnDdKSfBQwhLNTsqM16_DPzXDvaoQ2SNUslESP5hSOWJAHDnoFGareGFIgGD-CbPIy0yozSEiQvICQm0ADsEOZvNegC0F6kUNYXWXEZ1SQgvVorldb3k4dkxESmN-TEJjsn8qyfzLz6dv_hzcfFZoZNj0jkmHxVUGmFKMLDhmWkR1ca243qVBUJvuz9_tnj5Y6URrCVfvPp6fvVLJY-gdbHS5ZHmbc_FT78vXvzw9tvP_3l1-ebXZ_Pnl4vfXs6ffl_L3_zxevHld3998s3H8Dd_-mR-8XMVLFQMwTXo315d_f26Tt-kaWnrUJVfflK0FNUL6gs1lW3U0I_FxWXlUHVklad6nT9q-rlkWTWsDehXwkGTch1NoX13qxHiaFyPDpgdsi7zBrzrTZxBNwyZ3XXCiUv71LKsiQeO9czRwbagz5bvDB3H9_rDLdvdAr0BlPl2CiQHA6sRIMFAklNIDgQV-YjK9wsRnYwpTr8E9gHbp0ryA-A6gcD-0Pc81wUxT6lIQDilwk54-U6Rc77mEE2SkZITETdrQhnNDOxTQCzEGypjVHofYIPkkAPl-MYIKL8BmXF_wAQbEfM9-CiAbpgehZrTmsRCCrTisKWMcbabxBgbJZIdiZSPVFKR_cburudVJcepGaE7RzWQ03egSZ7tD6GJQPLU7CsmJuVS2x-4W67r-57vD6A1gNPGDh1O1WyEK8_UTC4zJmuMXAIC6Iw8gqaB-oZtD5ybCCtFpPW61c960tX-tQVLXlQixAM7CnEoS4XchjDQ4h3z_-goLqClciwecxiLA5bQCNj8sUoSLAkOid-BU8eE5hGW2rQ0h4q2s2yH6ts-ZMIur0XjqCXagVsCT4SGFvi8floa7532fBsHHPBUJWx5ulbi09NWkl2lap40od7F68PgfrVSV7JrYfZUjCRtolYrhGNbVXSfh7kwq7IN1eY_RPG28ReLK-WBMtB6uAdCydUtx9CGp1kCHMK5ee76vRzbAZ_dVrnhbMnjMVJ3bXVPYwM3Tx2U4UoiAFXgWjrDYRVfl3sqok2fYav2lzfhsMZukXNY1WaOdcCpMVmwuWlvOT27P-zZPb8fAKv9zcbsA6fA4M15qUjnA-2XPwO3j4jwO-dA7RVTOZry6IQEE5rkvENoliUcCmqQ3GGwoQ0zm5j45dHL4RaG6nFveQywSnUCOxGQVGVBSjMRIKQ8GDAvYgPL6k5Yf9C1bc66NORhl1k-t0Lq0S3qkvN_AWRYn1g%3D",
"resultCode": "received",
"sign": "d182d2f36e48fed0578c00c5f6ada73b",
"errorCode": "0000",
"transactionId": "34a7d1bd-d47e-4f27-bbd1-2bf3a6a000f4",
"errorMsg": "Approved or completed successfully",
"token": "mop:mapi:redis:7d4cd700-fd67-11ed-abeb-d05e0ba4a9a3",
"transactionType": "pay",
"reference": "1012305282254689139",
"echoParam": "echoParam",
"signType": "MD5",
"currency": "JPY",
"merchantNo": "500000000007362"
}
最后修改时间: 1 年前