统一收单交易支付接口
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/alipay/trade/pay
错误码
公共错误码
业务错误码
| 状态码 | 错误码 | 错误描述 | 解决方案 |
|---|---|---|---|
| 400 | ACQ.SYSTEM_ERROR | 系统异常 | 系统异常错误下该笔交易可能成功也可能失败，请调用查询订单API，查询当前订单的状态，并根据订单状态决定下一步的操作，如果多次调用依然报此错误码，请联系支付宝客服 |
| 400 | ACQ.INVALID_PARAMETER | 参数无效 | 请根据接口返回的错误信息，检查请求参数，修改后重新发起请求 |
| 400 | ACQ.ACCESS_FORBIDDEN | 无权限使用接口 | 未签约对应的产品合约； 1、请校验传入的product_code参数是否正确； 2、确认请求商户是否签约了对应的产品合约； |
| 400 | ACQ.EXIST_FORBIDDEN_WORD | 订单信息中包含违禁词 | 请检查订单标题和订单描述是否包含敏感词，修改订单信息后，重新发起请求 |
| 400 | ACQ.PARTNER_ERROR | 应用APP_ID填写错误 | 联系支付宝小二（联系支付宝文档右边的客服头像或到支持中心咨询），确认APP_ID的状态 |
| 400 | ACQ.TOTAL_FEE_EXCEED | 订单总金额超过限额 | 订单金额不能小于等于0，且不能大于100000000元，请修改订单金额后重新发起支付请求。 |
| 400 | ACQ.PAYMENT_AUTH_CODE_INVALID | 付款码无效 | 1、请确认auth_code参数传递正确； 2、请用户刷新付款码后，重新扫码发起请求； |
| 400 | ACQ.CONTEXT_INCONSISTENT | 订单信息不一致 | 商户订单号已经创建交易成功，且本次请求的交易关键信息（如订单金额、订单标题等）与已存交易的信息不一致，请检查传入的订单参数是否正确。 如原有交易未支付成功，请更换订单号重新发起支付请求。 |
| 400 | ACQ.TRADE_HAS_SUCCESS | 交易已被支付 | 请确认该订单号是否重复支付，如果是新订单，请更换商户订单号后重新提交支付。 |
| 400 | ACQ.TRADE_HAS_CLOSE | 交易已经关闭 | 商户订单号对应的交易已经关闭（超时未支付或者已全额退款），请更换商户订单号后重新发起支付请求。 |
| 400 | ACQ.BUYER_BALANCE_NOT_ENOUGH | 买家余额不足 | 买家绑定新的银行卡或者支付宝余额有钱后再发起支付 |
| 400 | ACQ.BUYER_BANKCARD_BALANCE_NOT_ENOUGH | 用户银行卡余额不足 | 建议买家更换支付宝进行支付或者更换其它付款方式 |
| 400 | ACQ.ERROR_BALANCE_PAYMENT_DISABLE | 余额支付功能关闭 | 用户打开余额支付开关后，再重新进行支付 |
| 400 | ACQ.BUYER_SELLER_EQUAL | 买卖家不能相同 | 交易的买家和卖家不能相同，请更换买家后重新发起支付请求。 |
| 400 | ACQ.TRADE_BUYER_NOT_MATCH | 交易买家不匹配 | 请确认该订单号是否重复支付，如果是新订单，请更换商户订单号后重新提交支付。 |
| 400 | ACQ.BUYER_ENABLE_STATUS_FORBID | 买家状态非法 | 用户联系支付宝小二（联系支付宝文档右边的客服头像或到支持中心咨询），确认买家状态为什么非法 |
| 400 | ACQ.PULL_MOBILE_CASHIER_FAIL | 唤起移动收银台失败 | 用户刷新条码后，重新扫码发起请求 |
| 400 | ACQ.MOBILE_PAYMENT_SWITCH_OFF | 用户的无线支付开关关闭 | 用户在PC上打开无线支付开关后，再重新发起支付 |
| 400 | ACQ.PAYMENT_FAIL | 支付失败 | 用户刷新条码后，重 新发起请求，如果重试一次后仍未成功，更换其它方式付款 |
| 400 | ACQ.BUYER_PAYMENT_AMOUNT_DAY_LIMIT_ERROR | 买家付款日限额超限 | 更换买家进行支付 |
| 400 | ACQ.BEYOND_PAY_RESTRICTION | 商户收款额度超限 | 联系支付宝小二提高限额（联系电话：4007585858） |
| 400 | ACQ.BEYOND_PER_RECEIPT_RESTRICTION | 商户收款金额超过月限额 | 联系支付宝小二提高限额（联系电话：4007585858） |
| 400 | ACQ.BUYER_PAYMENT_AMOUNT_MONTH_LIMIT_ERROR | 买家付款月额度超限 | 让买家更换账号后，重新付款或者更换其它付款方式 |
| 400 | ACQ.SELLER_BEEN_BLOCKED | 商家账号被冻结 | 联系支付宝小二，解冻账号（联系电话：4007585858） |
| 400 | ACQ.ERROR_BUYER_CERTIFY_LEVEL_LIMIT | 买家未通过人行认证 | 让用户联系支付宝小二并更换其它付款方式（联系电话：4007585858） |
| 400 | ACQ.PAYMENT_REQUEST_HAS_RISK | 支付有风险 | 更换其它付款方式 |
| 400 | ACQ.NO_PAYMENT_INSTRUMENTS_AVAILABLE | 没有可用的支付工具 | 更换其它付款方式 |
| 400 | ACQ.USER_FACE_PAYMENT_SWITCH_OFF | 用户当面付付款开关关闭 | 让用户在手机上打开当面 付付款开关 |
| 400 | ACQ.INVALID_STORE_ID | 商户门店编号无效 | 检查传入的门店编号是否有效 |
| 400 | ACQ.SUB_MERCHANT_CREATE_FAIL | 二级商户创建失败 | 检查上送的二级商户信息是否有效 |
| 400 | ACQ.SUB_MERCHANT_TYPE_INVALID | 二级商户类型非法 | 检查上传的二级商户类型是否有效 |
| 400 | ACQ.AGREEMENT_NOT_EXIST | 用户协议不存在或已解约 | 协议号传递错误或用户已经解约，请重新引导用户进行签约，使用新生成的协议号发起代扣请求。 |
| 400 | ACQ.AGREEMENT_INVALID | 用户协议失效 | 代扣业务传入的协议号对应的用户协议已经失效，需要用户重新签约 |
| 400 | ACQ.AGREEMENT_STATUS_NOT_NORMAL | 用户协议状态非NORMAL | 代扣业务用户协议状态非正常状态，需要用户解约后重新签约 |
| 400 | ACQ.MERCHANT_AGREEMENT_NOT_EXIST | 商户协议不存在 | 确认商户与支付宝是否已签约 |
| 400 | ACQ.MERCHANT_AGREEMENT_INVALID | 商户协议已失效 | 商户与支付宝合同已失效，需要重新签约 |
| 400 | ACQ.MERCHANT_STATUS_NOT_NORMAL | 商户状态异常 | 因商户超过三个月未产生交易，需重新激活后可正常收单 。1、进入支付宝商家中心，重新确认激活商家信息 或2、联系支付宝小二处理（联系电话：4007585858） |
| 400 | ACQ.CARD_USER_NOT_MATCH | 脱机记录用户信息不匹配 | 请检查传入的进展出站记录是否正确 |
| 400 | ACQ.CARD_TYPE_ERROR | 卡类型错误 | 检查传入的卡类型 |
| 400 | ACQ.CERT_EXPIRED | 凭证过期 | 凭证已经过期 |
| 400 | ACQ.AMOUNT_OR_CURRENCY_ERROR | 订单金额或币种信息错误 | 检查订单传入的金额信息是否有误，或者是不是当前币种未签约 |
| 400 | ACQ.CURRENCY_NOT_SUPPORT | 订单币种不支持 | 请检查是否签约对应的币种 |
| 400 | ACQ.MERCHANT_UNSUPPORT_ADVANCE | 先享后付2.0准入失败,商户不支持垫资支付产品 | 先享后付2.0准入失败,商户不支持垫资支付产品 |
| 400 | ACQ.BUYER_UNSUPPORT_ADVANCE | 先享后付2.0准入失败,买家不满足垫资条件 | 先享后付2.0准入失败,买家不满足垫资条件 |
| 400 | ACQ.ORDER_UNSUPPORT_ADVANCE | 订单不支持先享后付垫资 | 订单不支持先享后付垫资 |
| 400 | ACQ.CYCLE_PAY_DATE_NOT_MATCH | 扣款日期不在签约时的允许范围之内 | 对于周期扣款产品，签约时会约定扣款的周期。如果发起扣款的日期不符合约定的周期，则不允许扣款。请重新检查扣款日期，在符合约定的日期发起扣款。 |
| 400 | ACQ.CYCLE_PAY_SINGLE_FEE_EXCEED | 周期扣款的单笔金额超过签约时限制 | 对于周期扣款产品，签约时会约定单笔扣款的最大金额。如果发起扣款的金额大于约定上限，则不允许扣款。请在允许的金额范围内扣款。 |
| 400 | ACQ.CYCLE_PAY_TOTAL_FEE_EXCEED | 周期扣款的累计金额超过签约时限制 | 对于周期扣款产品，签约时可以约定多次扣款的累计金额限制。如果发起扣款的累计金额大于约定上限，则不允许扣款。请在允许的金额范围内扣款。 |
| 400 | ACQ.CYCLE_PAY_TOTAL_TIMES_EXCEED | 周期扣款的总次数超过签约时限制 | 对于周期扣款产品，签约时可以约定多次扣款的总次数限制。如果发起扣款的总次数大于约定上限，则不允许扣款。请在允许的次数范围内扣款 |
| 400 | ACQ.SECONDARY_MERCHANT_STATUS_ERROR | 商户状态异常 | 请联系对应的服务商咨询 |
| 400 | ACQ.AUTH_NO_ERROR | 预授权号错误或状态不对 | 1、确认预授权单号（auth_no）是否正确；2、确认预授权订单的参与方与支付单的参与方是否一致；3、确认预授权订单的状态是否为已授权状态； |
| 400 | ACQ.BUYER_NOT_EXIST | 买家不存在 | 联系支付宝小二，确认买家是否已经注销账号 |
| 400 | ACQ.PRODUCT_AMOUNT_LIMIT_ERROR | 产品额度超限 | 联系支付宝小二提高限额（联系电话：4007585858） |
| 400 | ACQ.SECONDARY_MERCHANT_ALIPAY_ACCOUNT_INVALID | 二级商户账户异常 | 确认传入的二级商户结算账户是否与进件时设置的结算账户一致，如果一致可联系支付宝小二确认是否商户的账号信息有变更 |
| 400 | ACQ.INVALID_RECEIVE_ACCOUNT | 收款账户不支持 | seller_id不在请求商户设置的收款账户限制集中，请确认是否需要收款到指定的支付宝账户，如需要联系支付宝小二进行配置处理。 如果不需要，则seller_id不需要传递，资金默认收款到签约商户账户中。 |
| 400 | ACQ.SELLER_NOT_EXIST | 卖家不存在 | 确认卖家信息是否传递正确 |
| 400 | ACQ.AUTH_AMOUNT_NOT_ENOUGH | 授权金额不足 | 订单金额大于授权剩余金额，请检查授权单剩余金额信息 |
| 400 | ACQ.AGREEMENT_ERROR | 协议信息异常 | 请检查传入的协议信息是否正确 |
| 400 | ACQ.BEYOND_PER_RECEIPT_SINGLE_RESTRICTION | 订单金额超过单笔限额 | 联系支付宝小二提高限额（联系电话：4007585858） |
| 400 | ACQ.PAYER_UNMATCHED | 付款人不匹配 | 建议用户更换为指定的支付宝账号进行支付 |
| 400 | ACQ.PRE_AUTH_PROD_CODE_INCONSISTENT | 预授权产品码不一致 | 请检查预授权订单和转交易订单传入的产品码是否一致 |
| 400 | ACQ.SECONDARY_MERCHANT_ID_INVALID | 二级商户不存在 | 请检查传入的二级商户编号是否正确 |
| 400 | ACQ.NOW_TIME_AFTER_EXPIRE_TIME_ERROR | 当前时间已超过允许支付的时间 | 请检查传入的支付超时时间是否正确 |
| 400 | ACQ.SECONDARY_MERCHANT_NOT_MATCH | 二级商户信息不匹配 | 1、请检查发起支付请求的商户账号是否与请求创建二级商户接口所使用的商户账号一致； 2、如果接入的是直付通模式，请联系BD确认是否签约了直付通收单模式； |
| 400 | ACQ.REQUEST_AMOUNT_EXCEED | 请求金额超限 | 请检查传入的订单金额是否正确，预授权订单场景下请检查订单金额是否大于冻结金额 |
| 400 | ACQ.SUB_GOODS_SIZE_MAX_COUNT | 子商品明细超长 | 请检查子商品明细是否超过了150条 |
| 400 | ACQ.NOT_SUPPORT_PAYMENT_INST | 不支持的钱包版本 | 业务不支持使用该客户端支付，建议买家更换客户端进行支付或者更换其它付款方式 |
| 400 | ACQ.BUYER_NOT_MAINLAND_CERT | 买家证件类型非大陆身份证 | 该服务仅支持中国大陆身份证实名制用户,建议买家完善实名信息 或者更换其它付款方式 |
| 400 | ACQ.SECONDARY_MERCHANT_ID_BLANK | 二级商户编号错误 | 请检查是否正确传入二级商户编号 |
| 400 | ACQ.TRADE_SETTLE_ERROR | 交易结算异常 | 请检查传入的结算项信息是否正确，如果正确请联系支付宝小二 |
| 400 | ACQ.AUTH_TOKEN_IS_NOT_EXIST | 支付授权码为空 | 请检查请求参数是否正确，支付授权码、协议信息或预授权号是否正确传入 |
| 400 | ACQ.SMILE_PAY_MERCHANT_NOT_MATCH | 请求支付和刷脸服务的商户身份不一致 | 请检查请求支付和刷脸服务使用的pid是否一致 |
| 400 | ACQ.NOT_CERTIFIED_USER | 买家非实名认证用户 | 建议买家完善实名信息后再重试或者更换其它付款方式 |
| 400 | ACQ.SECONDARY_MERCHANT_ISV_PUNISH_INDIRECT | 商户状态异常 | 请联系对应的服务商咨询 |
| 400 | ACQ.RESTRICTED_MERCHANT_INDUSTRY | 行业信息交易受限 | 订单金额超过所属行业支持的最大金额 |
| 400 | ACQ.PLATFORM_BUSINESS_ACQUIRE_MODE_MUST_MERCHANT_ID | 二级商户编码为空 | 二级商户编号(sub_merchant.merchant_id)不能为空。 直付通模式下，二级商户信息为必填项，如果不使用直付通模式接入，请联系支付宝小二改签。 |
| 400 | ACQ.BEYOND_PER_RECEIPT_DAY_RESTRICTION | 订单金额超过当日累计限额 | 联系支付宝小二提高限额（联系电话：4007585858） |
| 400 | ACQ.TRADE_STATUS_ERROR | 交易状态异常 | 请检查订单状态是否已经支付成功 |
| 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.USER_LOGONID_DUP | 用户账号重复 | 用户手机账户名与他人重复，无法进行收付款。为了保障资金安全，建议您通知对方修改账户名，并与对方核对后更新对方账户名 |
| 400 | ACQ.AUTH_ORDER_NOT_PAID | 预授权订单未支付 | 先引导用户完成预授权订单的支付，再重新请求转交易支付接口 |
| 400 | ACQ.AUTH_ORDER_HAS_FINISHED | 预授权订单已经完结 | 预授权订单已经转交易支付成功，授权单状态已完结，不能再发起转交易扣款 |
| 400 | ACQ.AUTH_ORDER_HAS_CLOSED | 预授权订单已关闭 | 预授权订单已撤销、解冻或未支付超时关闭，授权单状态已关闭，不能再发起转交易扣款 |
| 400 | ACQ.ZM_AUTH_AMOUNT_EXCEED | 先用后付场景下超过约定的免密支付金额 | 超过约定的免密支付金额，需要商户调用支付宝SDK唤起收银台，用户确认后付款 |
| 400 | ACQ.ZM_CREDIT_AUTH_FAIL | 综合评估不通过 | 建议用户按时履约，提升芝麻信用等级 |
| 400 | ACQ.RISK_MERCHANT_IP_NOT_EXIST | 当前交易未传入IP信息，创单失败，请传入IP后再发起支付 | 检查请求参数是否已经传入用户IP信息 |
关联异步通知
触发通知类型
| 通知类型 | 描述 | 默认开启 |
|---|---|---|
| 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/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":"20150320010101001",
"total_amount":88.88,
"subject":"Iphone6 16G",
"auth_code":"28763443825664394",
"scene":"bar_code",
"product_code":"FACE_TO_FACE_PAYMENT",
"seller_id":"2088102146225135",
"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"
}
],
"extend_params":{
"sys_service_provider_id":"2088511833207846",
"specified_seller_name":"XXX的跨境小铺",
"card_type":"S0JP0000"
},
"business_params":{
"mc_create_trade_ip":"127.0.0.1"
},
"promo_params":{
"actual_order_time":"2018-09-25 22:47:33"
},
"store_id":"NJ_001",
"operator_id":"yx_001",
"terminal_id":"NJ_T_001",
"query_options":[
"fund_bill_list",
"voucher_detail_list",
"discount_goods_detail"
]
}'响应示例响应示例
{
"trade_no": "2013112011001004330000121536",
"out_trade_no": "6823789339978248",
"buyer_logon_id": "159****5620",
"total_amount": 120.88,
"receipt_amount": "88.88",
"buyer_pay_amount": 8.88,
"point_amount": 8.12,
"invoice_amount": 12.5,
"gmt_payment": "2014-11-27 15:45:57",
"fund_bill_list": [
{
"fund_channel": "ALIPAYACCOUNT",
"amount": 10,
"real_amount": 11.21
}
],
"store_name": "证大五道口店",
"discount_goods_detail": "[{\"goods_id\":\"STANDARD1026181538\",\"goods_name\":\"雪碧\",\"discount_amount\":\"100.00\",\"voucher_id\":\"2015102600073002039000002D5O\"}]",
"buyer_user_id": "2088101117955611",
"voucher_detail_list": [
{
"id": "2015102600073002039000002D5O",
"name": "XX超市5折优惠",
"type": "ALIPAY_FIX_VOUCHER",
"amount": 10,
"merchant_contribute": 9,
"other_contribute": 1,
"memo": "学生专用优惠",
"template_id": "20171030000730015359000EMZP0",
"purchase_buyer_contribute": 2.01,
"purchase_merchant_contribute": 1.03,
"purchase_ant_contribute": 0.82
}
],
"mdiscount_amount": "88.88",
"discount_amount": "88.88"
}请求参数
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