统一收单交易创建接口
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/alipay/trade/create
公共错误码
业务错误码
| 状态码 | 错误码 | 错误描述 | 解决方案 |
|---|---|---|---|
| 400 | ACQ.ACCESS_FORBIDDEN | 无权限使用接口 | 未签约对应的产品合约； 1、请校验传入的product_code参数是否正确； 2、确认请求商户是否签约了对应的产品合约； |
| 400 | ACQ.BEYOND_PER_RECEIPT_SINGLE_RESTRICTION | 订单金额超过单笔限额 | 联系支付宝小二提高限额（联系电话：4007585858） |
| 400 | ACQ.BIZ_PRODUCT_NOT_ALLOWED | 公域订单场景下不支持使用该产品码 | 公域场交易需要切换使用JSAPI支付产品。1、请确认签约JSAPI支付产品；2、product_code改成JSAPI_PAY产品码 |
| 400 | ACQ.BUYER_ENABLE_STATUS_FORBID | 买家状态非法 | 用户联系支付宝小二，确认买家状态为什么非法 |
| 400 | ACQ.BUYER_NOT_EXIST | 买家不存在 | 确认买家账号信息传递是否正确，如果正确可联系支付宝小二，确认买家账号是否已经注销 |
| 400 | ACQ.BUYER_SELLER_EQUAL | 买卖家不能相同 | 更换买家重新付款 |
| 400 | ACQ.CONTEXT_INCONSISTENT | 交易信息被篡改 | 更换商家订单号后，重新发起请求 |
| 400 | ACQ.CUSTOMER_VALIDATE_ERROR | 客户校验出错 | 请确认结算账号是否完成实名信息认证，如还有问题联系支付宝小二处理 |
| 400 | ACQ.DEFAULT_SETTLE_RULE_NOT_EXIST | 默认结算条款不存在 | 请确认二级商户进件是已经设置了默认结算账户 |
| 400 | ACQ.ERROR_BUYER_CERTIFY_LEVEL_LIMIT | 买家未通过人行认证 | 让用户联系支付宝小二并更换其它付款方式 |
| 400 | ACQ.ERROR_SELLER_CERTIFY_LEVEL_LIMIT | 卖家未通过人行认证 | 根据国家相关法规要求，收款账户资金变动超过一定数额，需补充实名认证资料后，才能进行收付款 |
| 400 | ACQ.EXIST_FORBIDDEN_WORD | 订单信息中包含违禁词 | 修改订单信息后，重新发起请求 |
| 400 | ACQ.ILLEGAL_ARGUMENT | 参数错误 | 请确认请求传参是否正确 |
| 400 | ACQ.INVALID_PARAMETER | 参数无效 | 检查请求参数，修改后重新发起请求 |
| 400 | ACQ.INVALID_RECEIVE_ACCOUNT | 收款账户不支持 | 确认seller_id信息是否传递正确，如正确请确认seller_id是否在签约中设置了收款权限 |
| 400 | ACQ.INVALID_STORE_ID | 商户门店编号无效 | 检查传入的门店编号是否有效 |
| 400 | ACQ.MERCHANT_PERM_RECEIPT_DAY_LIMIT | 超过单日累计收款额度 | 联系支付宝小二处理（联系电话：4007585858） |
| 400 | ACQ.MERCHANT_PERM_RECEIPT_SINGLE_LIMIT | 超过单笔收款限额 | 联系支付宝小二处理（联系电话：4007585858） |
| 400 | ACQ.MERCHANT_PERM_RECEIPT_SUSPEND_LIMIT | 商户暂停收款 | 联系支付宝小二处理（联系电话：4007585858） |
| 400 | ACQ.MERCHANT_STATUS_NOT_NORMAL | 商户状态异常 | 因商户超过三个月未产生交易，需重新激活后可正常收单。1、进入支付宝商家中心，重新确认激活商家信息 或2、联系支付宝小二处理（联系电话：4007585858） |
| 400 | ACQ.NOW_TIME_AFTER_EXPIRE_TIME_ERROR | 当前时间已超过允许支付的时间 | 请检查传入的支付超时时间是否正确 |
| 400 | ACQ.OPEN_ID_NOT_TINY_APP | 请求的应用id非小程序应用类型 | 1、接口需要传入op_app_id，且该应用id是小程序应用类型； 2、商户需要先在商家平台-产品中心-JSAPI支付产品页面 关联该小程序AppID； 3、如果未传入op_app_id，则默认发起请求的appId即唤起收银台所在的小程序应用ID，该appId需要是小程序应用类型。 |
| 400 | ACQ.PARTNER_ERROR | 应用APP_ID填写错误 | 联系支付宝小二，确认APP_ID的状态 |
| 400 | ACQ.PAYER_UNMATCHED | 付款人不匹配 | 建议用户更换为指定的支付宝账号进行支付 |
| 400 | ACQ.PLATFORM_BUSINESS_ACQUIRE_MODE_MUST_MERCHANT_ID | 二级商户编码为空 | 请检查是否正确传入二级商户编号 |
| 400 | ACQ.PRODUCT_NOT_SUPPORT_IN_TINY_APP | 小程序内不支持使用该产品码交易 | 1、请确认签约JSAPI支付产品；2、product_code改成JSAPI_PAY产品码 |
| 400 | ACQ.RISK_MERCHANT_IP_NOT_EXIST | 当前交易未传入IP信息，创单失败，请传入IP后再发起支付 | 检查请求参数是否已经传入用户IP信息 |
| 400 | ACQ.SECONDARY_MERCHANT_ALIPAY_ACCOUNT_INVALID | 二级商户账户异常 | 确认传入的 二级商户结算账户是否与进件时设置的结算账户一致，如果一致可联系支付宝小二确认是否商户的账号信息有变更 |
| 400 | ACQ.SECONDARY_MERCHANT_CARD_ALIAS_NO_INVALID | 二级商户银行卡编号错误 | 请确认是否正确传入二级商户的银行卡信息，以及银行卡信息是否与商户进件是设置的卡信息一致 |
| 400 | ACQ.SECONDARY_MERCHANT_ID_BLANK | 二级商户编号错误 | 请检查是否正确传入二级商户编号 |
| 400 | ACQ.SECONDARY_MERCHANT_ID_INVALID | 二级商户不存在 | 请检查传入的二级商户编号是否正确 |
| 400 | ACQ.SECONDARY_MERCHANT_ISV_PUNISH_INDIRECT | 商户/服务商状态异常 | 请联系对应的服务商咨询 |
| 400 | ACQ.SECONDARY_MERCHANT_NOT_MATCH | 二级商户信息不匹配 | 1、请检查发起支付请求的二级商户账号是否正确或是否进件； 2、如果使用的是直付通平台商模式，请确认是否签约了直付通收单模式； |
| 400 | ACQ.SECONDARY_MERCHANT_STATUS_ERROR | 二级商户状态异常 | 请联系对应的服务商咨询 |
| 400 | ACQ.SELLER_BEEN_BLOCKED | 商家账号被冻结 | 联系支付宝小二，解冻账号 |
| 400 | ACQ.SELLER_NOT_EXIST | 卖家不存在 | 确认卖家信息是否传递正确 |
| 400 | ACQ.STORE_INFO_INVALID | 门店信息错误 | 请校验传入的结算门店信息是否正确 |
| 400 | ACQ.SUB_GOODS_SIZE_MAX_COUNT | 子商品明细超长 | 请检查子商品明细是否超过了150条 |
| 400 | ACQ.SYSTEM_ERROR | 接口返回错误 | 请立即调用查询订单API，查询当前订单的状态，并根据订单状态决定下一步的操作 |
| 400 | ACQ.TOTAL_FEE_EXCEED | 订单总金额超过限额 | 修改订单金额再发起请求 |
| 400 | ACQ.TRADE_BUYER_NOT_MATCH | 交易买家不匹配 | 更换商家订单号后，重新发起请求 |
| 400 | ACQ.TRADE_HAS_CLOSE | 交易已经关闭 | 更换商家订单号后，重新发起请求 |
| 400 | ACQ.TRADE_HAS_SUCCESS | 交易已被支付 | 确认该笔交易信息是否为当前买家的，如果是则认为交易付款成功，如果不是则更换商家订单号后，重新发起请求 |
| 400 | ACQ.UNBOUND_APPLICATION | 未绑定小程序appId | 1、确认op_app_id为唤起收银台支付的小程序appId；2、商户需要先在商家平台-产品中心-JSAPI支付产品页面 关联该小程序AppID |
| 400 | ACQ.USER_LOGONID_DUP | 用户账号重复 | 用户手机账户名与他人重复，无法进行收付款。为了保障资金安全，建议您通知对方修改账户名，并与对方核对后更新对方账户名 |
关联异步通知
触发通知类型
| 通知类型 | 描述 | 默认开启 |
|---|---|---|
| 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/create' \
--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 '{
"out_trade_no":"20150320010101001",
"product_code":"JSAPI_PAY",
"op_app_id":"2014072300007148",
"total_amount":"600.0",
"extend_params":{
"trade_component_order_id":"2023091501502300000000530013354806"
},
"discountable_amount":"80.00",
"subject":"Iphone6 16G",
"body":"特价手机",
"buyer_id":"2088102146225135",
"store_id":"1701866128974405634"
}'响应示例响应示例
200 - 成功示例
{
"out_trade_no":"20150423001001",
"trade_no":"2015042321001004720200028594"
}请求参数
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