统一收单线下交易预创建
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/alipay/trade/precreate
注意:
预下单请求生成的二维码有效时间为2小时
错误码
公共错误码
业务错误码
| 状态码 | 错误码 | 错误描述 | 解决方案 |
|---|---|---|---|
| 400 | ACQ.SYSTEM_ERROR | 接口返回错误 | 请立即调用查询订单API，查询当前订单的状态，并根据订单状态决定下一步的操作 |
| 400 | ACQ.INVALID_PARAMETER | 参数无效 | 检查请求参数，修改后重新发起请求 |
| 400 | ACQ.ACCESS_FORBIDDEN | 无权限使用接口 | 联系支付宝小二签约 |
| 400 | ACQ.EXIST_FORBIDDEN_WORD | 订单信息中包含违禁词 | 修改订单信息后，重新发起请求 |
| 400 | ACQ.PARTNER_ERROR | 应用APP_ID填写错误 | 联系支付宝小二，确认APP_ID的状态 |
| 400 | ACQ.TOTAL_FEE_EXCEED | 订单总金额超过限额 | 修改订单金额再发起请求 |
| 400 | ACQ.CONTEXT_INCONSISTENT | 交易信息被篡改 | 更换商家订单号后，重新发 起请求 |
| 400 | ACQ.TRADE_HAS_SUCCESS | 交易已被支付 | 确认该笔交易信息是否为当前买家的，如果是则认为交易付款成功，如果不是则更换商家订单号后，重新发起请求 |
| 400 | ACQ.TRADE_HAS_CLOSE | 交易已经关闭 | 更换商家订单号后，重新发起请求 |
| 400 | ACQ.BUYER_SELLER_EQUAL | 买卖家不能相同 | 更换买家重新付款 |
| 400 | ACQ.TRADE_BUYER_NOT_MATCH | 交易买家不匹配 | 更换商家订单号后，重新发起请求 |
| 400 | ACQ.BUYER_ENABLE_STATUS_FORBID | 买家状态非法 | 用户联系支付宝小二，确认买家状态为什么非法 |
| 400 | ACQ.BUYER_PAYMENT_AMOUNT_DAY_LIMIT_ERROR | 买家付款日限额超限 | 更换买家进行支付 |
| 400 | ACQ.BEYOND_PAY_RESTRICTION | 商户收款额度超限 | 联系支付宝小二提高限额 |
| 400 | ACQ.BEYOND_PER_RECEIPT_RESTRICTION | 商户收款金额超过月限额 | 联系支付宝小二提高限额 |
| 400 | ACQ.BUYER_PAYMENT_AMOUNT_MONTH_LIMIT_ERROR | 买家付款月额度超限 | 让买家更换账号后，重新付款或者更换其它付款方式 |
| 400 | ACQ.SELLER_BEEN_BLOCKED | 商家账号被冻结 | 联系支付宝小二，解冻账号 |
| 400 | ACQ.ERROR_BUYER_CERTIFY_LEVEL_LIMIT | 买家未通过人行认证 | 让用户联系支付宝小二并更换其它付款方式 |
| 400 | ACQ.INVALID_STORE_ID | 商户门店编号无效 | 检查传入的门店编号是否符合规则 |
| 400 | ACQ.APPLY_PC_MERCHANT_CODE_ERROR | 申请二维码失败 | 请确认同样的订单号不能重复多次申请二维码，如有问题请联系支付宝小二处理 |
| 400 | ACQ.SECONDARY_MERCHANT_STATUS_ERROR | 商户状态异常 | 请联系对应的服务商咨询 |
| 400 | ACQ.BEYOND_PER_RECEIPT_DAY_RESTRICTION | 订单金额超过当日累计限额 | 联系支付宝小二提高限额（联系电话：4007585858） |
| 400 | ACQ.BEYOND_PER_RECEIPT_SINGLE_RESTRICTION | 订单金额超过单笔限额 | 联系支付宝小二提高限额（联系电话：4007585858） |
| 400 | ACQ.TRADE_SETTLE_ERROR | 交易结算异常 | 请检查传入的结算项信息是否正确，如果正确请联系支付宝小二 |
| 400 | ACQ.SECONDARY_MERCHANT_ID_INVALID | 二级商户不存在 | 请检查传入的二级商户编号是否正确 |
| 400 | ACQ.SECONDARY_MERCHANT_ISV_PUNISH_INDIRECT | 商户状态 异常 | 请联系对应的服务商咨询 |
| 400 | ACQ.SELLER_NOT_EXIST | 卖家不存在 | 确认卖家信息是否传递正确 |
| 400 | ACQ.SECONDARY_MERCHANT_ALIPAY_ACCOUNT_INVALID | 二级商户账户异常 | 确认传入的二级商户结算账户是否与进件时设置的结算账户一致，如果一致可联系支付宝小二确认是否商户的账号信息有变更 |
| 400 | ACQ.INVALID_RECEIVE_ACCOUNT | 收款账户不支持 | 确认seller_id信息是否传递正确，如正确请确认seller_id是否在签约中设置了收款权限 |
| 400 | ACQ.SECONDARY_MERCHANT_ID_BLANK | 二级商户编号错误 | 请检查是否正确传入二级商户编号 |
| 400 | ACQ.NOW_TIME_AFTER_EXPIRE_TIME_ERROR | 当前时间已超过允许支付的时间 | 请检查传入的支付超时时间是否正确 |
| 400 | ACQ.SECONDARY_MERCHANT_NOT_MATCH | 二级商户信息不匹配 | 请检查传入的二级商户编号是否正确 |
| 400 | ACQ.BUYER_NOT_EXIST | 买家不存在 | 确认买家账号信息传递是否正确，如果正确可联系支付宝小二，确认买家账号是否已经注销 |
| 400 | ACQ.SUB_GOODS_SIZE_MAX_COUNT | 子商品明细超长 | 请检查子商品明细是否超过了150条 |
| 400 | ACQ.DEFAULT_SETTLE_RULE_NOT_EXIST | 默认结算条款不存在 | 请确认二级商户进件是已经设置了默认结算账户 |
| 400 | ACQ.MERCHANT_PERM_RECEIPT_SUSPEND_LIMIT | 商户暂停收款 | 联系支付宝小二处理（联系电话：4007585858） |
| 400 | ACQ.MERCHANT_PERM_RECEIPT_SINGLE_LIMIT | 超过单笔收款限额 | 联系支付宝小二处理（联系电话：4007585858） |
| 400 | ACQ.MERCHANT_PERM_RECEIPT_DAY_LIMIT | 超过单日累计收款额度 | 联系支付宝小二处理（联系电话：4007585858） |
| 400 | ACQ.RISK_MERCHANT_IP_NOT_EXIST | 当前交易未传入IP信息，创单失败，请传入IP后再发起支付 | 检查请求参数是否已经传入用户IP信息 |
| 400 | ACQ.MERCHANT_STATUS_NOT_NORMAL | 商户状态异常 | 因商户超过三个月未产生交易，需重新激活后可正常收单。1、进入支付宝商家中心，重新确认激活商家信息 或2、联系支付宝小二处理（联系电话：4007585858） |
关联异步通知
触发通知类型
| 通知类型 | 描述 | 默认开启 |
|---|---|---|
| tradeStatus.TRADE_CLOSED | 交易关闭 | 0 |
| tradeStatus.TRADE_FINISHED | 交易完结 | 0 |
| 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/precreate' \
--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":"20150320010101001",
"total_amount":88.88,
"subject":"Iphone6 16G",
"product_code":"FACE_TO_FACE_PAYMENT",
"seller_id":"2088102146225135",
"body":"Iphone6 16G",
"goods_detail":[
{
"goods_id":"apple-01",
"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":"2021-12-31 10:05:00",
"timeout_express":"90m",
"settle_info":{
"settle_detail_infos":[
{
"trans_in_type":"cardAliasNo",
"trans_in":"A0001",
"summary_dimension":"A0001",
"settle_entity_id":"2088xxxxx;ST_0001",
"settle_entity_type":"SecondMerchant",
"amount":0.1,
"actual_amount":0.1
}
],
"settle_period_time":"7d"
},
"extend_params":{
"sys_service_provider_id":"2088511833207846",
"specified_seller_name":"XXX的跨境小铺",
"card_type":"S0JP0000",
"royalty_freeze":"true",
"trade_component_order_id":"2023060801502300000008810000005657"
},
"business_params":{
"campus_card":"0000306634",
"card_type":"T0HK0000",
"actual_order_time":"2019-05-14 09:18:55",
"good_taxes":"10.00",
"enterprise_pay_info":"{\"category_list\":[{\"price\":\"10.24\",\"name\":\"餐饮服务\",\"category\":\"3070401000000000000\"}]}",
"enterprise_pay_amount":"10.00",
"mc_create_trade_ip":"127.0.0.1",
"tiny_app_merchant_biz_type":"KX_SHOPPING"
},
"undiscountable_amount":8.88,
"discountable_amount":80.00,
"store_id":"NJ_001",
"operator_id":"yx_001",
"terminal_id":"NJ_T_001",
"disable_pay_channels":"pcredit,moneyFund,debitCardExpress",
"enable_pay_channels":"pcredit,moneyFund,debitCardExpress",
"merchant_order_no":"20161008001",
"code_type":"share_code",
"query_options":[
"hyb_amount",
"enterprise_pay_info"
],
"bkagent_req_info":{
"acq_code":"12345678901234",
"merch_code":"123412341234",
"device_type":"02",
"serial_num":"123123123123",
"location":"+37.28/-121.268"
}
}'响应示例响应示例
{
"out_trade_no": "6823789339978248",
"qr_code": "https://qr.alipay.com/bavh4wjlxf12tper3a",
"share_code": "chb4n8A94Qc"
}请求参数
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