app支付接口2.0
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/alipay/trade/app/pay
错误码
公共错误码
业务错误码
| 状态码 | 错误码 | 错误描述 | 解决方案 |
|---|---|---|---|
| 400 | ACQ.SYSTEM_ERROR | 接口返回错误 | 请立即调用查询订单API，查询当前订单的状态，并根据订单状态决定下一步的操作 |
| 400 | ACQ.ACCESS_FORBIDDEN | 无权限使用接口 | 联系支付宝小二签约 |
| 400 | ACQ.EXIST_FORBIDDEN_WORD | 订单信息中包含违禁词 | 修改订单信息后，重新发起请求 |
| 400 | ACQ.PARTNER_ERROR | 应用APP_ID填写错误 | 联系支付宝小 二，确认APP_ID的状态 |
| 400 | ACQ.TOTAL_FEE_EXCEED | 订单总金额不在允许范围内 | 修改订单金额再发起请求 |
| 400 | ACQ.BUYER_SELLER_EQUAL | 买卖家不能相同 | 更换买家重新付款 |
| 400 | ACQ.BUYER_ENABLE_STATUS_FORBID | 买家状态非法 | 用户联系支付宝小二，确认买家状态为什么非法 |
| 400 | ACQ.SELLER_BEEN_BLOCKED | 商家账号被冻结 | 联系支付宝小二，解冻账号 |
| 400 | ACQ.INVALID_PARAMETER | 参数无效 | 若存在参数无效具体错误信息描述，请参考描述检查请求参数后，重新发起 |
| 400 | ACQ.TRADE_HAS_CLOSE | 交易已经关闭 | 确认该笔交易信息是否为当前买家的已存订单，如果是则认为交易已经关闭，如果不是则更换商家订单号后，重新发起请求 |
| 400 | ACQ.CONTEXT_INCONSISTENT | 交易信息被篡改 | 确认该笔交易信息是否为当前买家的已存订单，如果是则认为本次请求参数与已存交易不一致，如果不是则更换商家订单号后，重新发起请求 |
| 400 | ACQ.TRADE_BUYER_NOT_MATCH | 交易买家不匹配 | 该笔交易已经在支付宝端创建，但请求买家与已存交易中的买家不一致。请商户确认本次请求是否与已存交易有关，若为同一笔交易，则只能用原 始买家付款，若无关更换商家订单号后，重新发起请求 |
| 400 | ACQ.TRADE_HAS_SUCCESS | 交易已被支付 | 确认该笔交易信息是否为当前买家的，如果是则认为交易付款成功，如果不是则更换商家订单号后，重新发起请求 |
| 400 | ACQ.RISK_MERCHANT_IP_NOT_EXIST | 当前交易未传入IP信息，创单失败，请传入IP后再发起支付 | 检查请求参数是否已经传入用户IP信息 |
关联异步通知
触发通知类型
| 通知类型 | 描述 | 默认开启 |
|---|---|---|
| tradeStatus.TRADE_CLOSED | 交易关闭 | 1 |
| tradeStatus.TRADE_FINISHED | 交易完结 | 1 |
| tradeStatus.TRADE_SUCCESS | 支付成功 | 1 |
| tradeStatus.WAIT_BUYER_PAY | 交易创建 | 0 |
触发通知示例
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/trade/app/pay' \
--header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \
--header 'alipay-request-id: $requestid' \
--header 'Content-Type: application/json' \
--data-raw '{
"notify_url":"http://api.test.alipay.net/atinterface/receive_notify.htm",
"out_trade_no":"70501111111S001111119",
"total_amount":"9.00",
"subject":"大乐透",
"product_code":"QUICK_MSECURITY_PAY",
"time_expire":"2016-12-31 10:05:00",
"agreement_sign_params":{
"product_code":"GENERAL_WITHHOLDING",
"personal_product_code":"CYCLE_PAY_AUTH_P",
"sign_scene":"INDUSTRY|DIGITAL_MEDIA",
"external_agreement_no":"test20190701",
"external_logon_id":"13888888888",
"access_params":{
"channel":"ALIPAYAPP"
},
"period_rule_params":{
"period_type":"DAY",
"period":3,
"execute_time":"2019-01-23",
"single_amount":10.99,
"total_amount":600,
"total_payments":12
},
"sign_notify_url":"http://www.merchant.com/receiveSignNotify"
}
}'响应示例响应示例
200 - 成功示例
{
"out_trade_no":"70501111111S001111119",
"trade_no":"2014112400001000340011111118",
"total_amount":"9.00",
"merchant_order_no":"20161008001"
}请求参数
Header 参数
authorization
string
必需
示例值:
ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign
alipay-request-id
string
可选
示例值:
$requestid
Content-Type
string
可选
示例值:
application/json
Body 参数application/json
返回响应
修改于 2023-11-20 06:31:41