payeasy api 模式
POST
/api时序图
sequenceDiagram
Customer->>Merchant: 点击支付
Merchant->>UseePay Server: 调用/cashier接口
UseePay Server->>Merchant: Response[resultCode=challenge]
Merchant->>Customer: 展示response[redirectUrl]
Customer->>payeasy Server: 进行支付
payeasy Server ->> UseePay Server: 同步通知支付结果
payeasy Server -->> UseePay Server: 异步支付结果
UseePay Server->>Merchant: 展示支付结果
Merchant->>Customer: 展示支付结果通知请求支付时传输的redirectUrl页面
UseePay Server-->>Merchant: 异步通知notifyUrl接口
请求参数
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
商户号(16)
示例值:
500000000007362
transactionId
string
商户订单号(64)
示例值:
202212070142347
transactionExpirationTime
string
可选
过期时间 (分钟)(6)
示例值:
1880
appId
string
网站域名(128)
示例值:
www.pay.com
amount
string
必需
支付金额,单位为对应币种的最小货币单位(详见 ISO 4217)(12)
示例值:
123
redirectUrl
string
可选
跳转商户地址(512)
示例值:
https://gatewaytest.useepay.com/gateway-test/redirectV2u0
currency
string
必需
3 位 ISO 大写字母货币代码(详见 ISO 4217) 目前仅支持EUR(3)
示例值:
JPY
notifyUrl
string
异步通知(512)
示例值:
https://gatewaytest.useepay.com/gateway-test/notifyV2u0
echoParam
string
可选
回声参数,响应报文会原样返回(256)
示例值:
echoParam
payerInfo
string
必需
Json格式的String 付款方信息, 请下方
示例值:
{
"paymentMethod": "payeasy",
"billingAddress": {
"houseNo": "El Gallo Giro(https://gallogiro.com/)",
"email": "victor.yang@useepay.com",
"phoneNo": "(323) 585-4433",
"firstName": "Victor",
"lastName": "Yang",
"street": "7148 Pacific Blvd, Huntington Park, CA 90255",
"postalCode": "90225",
"city": "Huntington Park",
"state": "CA",
"country": "US"
}
}
orderInfo
string
可选
json string, 订单信息, 请参考下方
示例值:
{ "subject": "订单标题", "goodsInfo": [ { "id": "商品编号", "name": "商品名称", "body": "商品描述", "category": "商品类目", "categoryTree": "商品类目树,不同级别类目使用”|”分割", "brand": "商品品牌", "quantity": 1, "price": 1234, "url": "商品url", "sku": "商品sku", "image": "商品图片url" } ], "deliveryMethod": "logistics", "deliveryTime": "", "shippingAddress": { "email": "victor.yang@useepay.com", "phoneNo": "+44 20 7734 9638", "firstName": "Victor", "lastName": "Yang", "street": "Heathcoat House, 20 Savile Row", "postalCode": "W1S 3PR", "city": "London", "state": "LND", "country": "GB" }}
userInfo
string
必需
json string, 消费者信息,请参考消费者信息
示例值:
{ "userId": "victor007", "ip": "103.25.65.178", "email": "victor.yang@useepay.com", "phoneNo": "(323) 585-4433", "createTime": "20200520131400"}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
object {0}
示例
{}
最后修改时间: 1 年前