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",
"body":"Iphone6 16G",
"goods_detail":[
{
"goods_id":"apple-01",
"alipay_goods_id":"20010001",
"goods_name":"ipad",
"quantity":1,
"price":2000,
"goods_category":"34543238",
"categories_tree":"124868003|126232002|126252004",
"show_url":"http://www.alipay.com/xxx.jpg",
"out_item_id":"outItem_01",
"out_sku_id":"outSku_01"
}
],
"time_expire":"2016-12-31 10:05:00",
"timeout_express":"90m",
"extend_params":{
"sys_service_provider_id":"2088511833207846",
"hb_fq_num":"3",
"hb_fq_seller_percent":"100",
"industry_reflux_info":"{\\\"scene_code\\\":\\\"metro_tradeorder\\\",\\\"channel\\\":\\\"xxxx\\\",\\\"scene_data\\\":{\\\"asset_name\\\":\\\"ALIPAY\\\"}}",
"specified_seller_name":"XXX的跨境小铺",
"card_type":"S0JP0000",
"royalty_freeze":"true",
"trade_component_order_id":"2023060801502300000008810000005657"
},
"passback_params":"merchantBizType%3d3C%26merchantBizNo%3d2016010101111",
"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"
},
"sub_merchant":{
"sub_merchant_id":"2088123412341234",
"sub_merchant_name":"滴滴出行",
"sub_merchant_service_name":"滴滴出行免密支付",
"sub_merchant_service_description":"免密付车费，单次最高500"
},
"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",
"recommend_sort_channel_params":[
{
"inst_id":"INST_ALIPAY",
"asset_type_code":"ALICREDIT"
}
]
},
"enable_pay_channels":"pcredit,moneyFund,debitCardExpress",
"specified_channel":"pcredit",
"disable_pay_channels":"pcredit,moneyFund,debitCardExpress",
"merchant_order_no":"20161008001",
"ext_user_info":{
"name":"李明",
"mobile":"16587658765",
"cert_type":"IDENTITY_CARD",
"cert_no":"362334768769238881",
"min_age":"18",
"need_check_info":"F",
"identity_hash":"27bfcd1dee4f22c8fe8a2374af9b660419d1361b1c207e9b41a754a113f38fcc"
},
"query_options":[
"hyb_amount",
"enterprise_pay_info",
"medical_insurance_info",
"credit_pay_mode"
]
}'响应示例响应示例
{
"out_trade_no": "70501111111S001111119",
"trade_no": "2014112400001000340011111118",
"total_amount": "9.00",
"seller_id": "2088111111116894",
"merchant_order_no": "20161008001",
"credit_pay_mode": "creditAdvanceV2",
"credit_biz_order_id": "ZMCB99202103310000450000041833",
"credit_agreement_id": "ZMOP99202102250100450004619343"
}请求参数
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