二,商户下单
1.基本信息
POST {请求地址}/pay/payment/v1/pay
2.请求参数
{ "outTradeNo": "202401021538", "amount": 0.01, "currency": "USD", "tradeType": "WEB", "notifyUrl": "https://acc.d-pay.online/hwpayment/pay/notify/payment", "productInfo": [ { "amount": 0.01, "description": "測試商品111111", "name": "測試商品111111111", "quantity": 1 } ], "settleCurrency": "USD", "walletBrand": "ALIPAY_CN", "remark": "測試商品"}
| 名称 |
位置 |
类型 |
必选 |
说明 |
| outTradeNo |
body |
string |
是 |
订单号(商户自身平台交易唯一, 长度 0 ~ 64) |
| amount |
body |
BigDecimal |
是 |
订单金额 |
| currency |
body |
String |
是 |
订单币种 |
| tradeType |
body |
String |
是 |
支付方式 |
| osType |
body |
String |
否 |
终端类型 支付方式 非 WEB, NATIVE_ENTYR_CODE, NATIVE, MICROPAY 时,必填 * 选填,可选项: IOS, ANDROID |
| authCode |
body |
String |
否 |
支付授权码,反扫时必填 |
| productInfo |
body |
|
是 |
商品信息 |
| settleCurrency |
body |
String |
是 |
结算币种 |
| notifyUrl |
body |
String |
是 |
通知地址 |
| returnUrl |
body |
String |
否 |
回调地址 |
| remark |
body |
String |
否 |
备注 |
| walletBrand |
body |
String |
否 |
钱包名称,默认CONNECT_WALLET |
3.请求参数(productInfo,商品信息)
| 参数名称 |
位置 |
类型& 长度 |
必选 |
参数说明 |
| name |
body |
String |
是 |
商品名称,需传递真实产品名称。 |
| quantity |
body |
Long |
是 |
商品数量 |
| amount |
body |
BigDecimal |
是 |
格式与总金额保持一致,此项为单个商品的价格。 |
| description |
body |
String |
否 |
商品描述 |
|
|
|
|
订单金额=商品数量*商品单价,订单金额一定要和商品总金额保持一致,如果有其他费用也要按照商品的格式传入为新的一列商品。 |
3.返回参数
{ "code": 200, "msg": "操作成功", "data": { "paymentNo": "P8000002620240104155722Y6UH", "outTradeNo": "202401021538", "tradeType": "WEB", "paymentUrl": "https://open-sea.alipayplus.com/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=281666040090ciFY8XpSl49BbQzTURqv4717", "scanCode": null, "walletBrand": "ALIPAY_CN", "orderStatus": "PROCESSING", "remark": "測試商品", "timeStamp": 1704355045829, "nonceStr": null, "paySign": null, "prepayId": null, "prepayParams": null }}