alipay.trade.precreate(统一收单线下交易预创建)

支持第三方代理调用

更新时间：2026-07-29 15:27:53

通用场景

当面付

订单码支付

收银员通过收银台或商户后台调用支付宝接口，生成二维码后，展示给用户，由用户扫描二维码完成订单支付。

注意：

预下单请求生成的二维码有效时间为2小时

公共请求参数

参数 类型 是否必选 最大长度 描述 示例值

app_id String 必选 32

支付宝分配给开发者的应用ID

2014072300007148

method String 必选 128

接口名称

alipay.trade.precreate

format String 可选 40

仅支持JSON

JSON

charset String 必选 10

请求使用的编码格式，如utf-8,gbk,gb2312等

utf-8

sign_type String 必选 10

商户生成签名字符串所使用的签名算法类型，目前支持RSA2和RSA，推荐使用RSA2

RSA2

sign String 必选 344

商户请求参数的签名串，详见签名

详见示例

timestamp String 必选 19

发送请求的时间，格式"yyyy-MM-dd HH:mm:ss"

2014-07-24 03:07:50

version String 必选 3

调用的接口版本，固定为：1.0

1.0

notify_url String 可选 256

支付宝服务器主动通知商户服务器里指定的页面http/https路径。

http://api.test.alipay.net/atinterface/receive_notify.htm

app_auth_token String 可选 40

详见应用授权概述

biz_content String 必选

请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

请求参数

参数

类型

是否必选

最大长度

描述

示例值

out_trade_no

String

必选

64

商户订单号。

由商家自定义，64个字符以内，仅支持字母、数字、下划线且需保证在商户端不重复。

20150320010101001

total_amount

Price

必选

12

订单总金额，单位为元，精确到小数点后两位，取值范围为 [0.01,100000000]，金额不能为 0。如果同时传入了【可打折金额】，【不可打折金额】，【订单总金额】三者，则必须满足如下条件：【订单总金额】=【可打折金额】+【不可打折金额】

88.88

subject

String

必选

256

订单标题。

注意：256个字符以内，不可使用特殊字符，如 /，=，& 等。

Iphone6 16G

product_code

String

可选

64

销售产品码。如果签约的是当面付快捷版，则传 OFFLINE_PAYMENT；其它支付宝当面付产品传 FACE_TO_FACE_PAYMENT；不传则默认使用 FACE_TO_FACE_PAYMENT。

FACE_TO_FACE_PAYMENT

seller_id

String

可选

32

卖家支付宝用户 ID。 如果该值为空，则默认为商户签约账号对应的支付宝用户 ID。不允许收款账号与付款方账号相同

2088102146225135

body

String

可选

128

订单附加信息。

如果请求时传递了该参数，将在异步通知、对账单中原样返回，同时会在商户和用户的pc账单详情中作为交易描述展示

Iphone6 16G

goods_detail

GoodsDetail[]

可选

订单包含的商品列表信息，为 JSON 格式，其它说明详见商品明细说明

extend_params

ExtendParams

可选

业务扩展参数

business_params

BusinessParams

可选

商户传入业务信息，具体值要和支付宝约定，应用于安全，营销等参数直传场景，格式为json格式

{"data":"123"}

discountable_amount

Price

可选

11

可打折金额。参与优惠计算的金额，单位为元，精确到小数点后两位，取值范围为 [0.01,100000000]。如果该值未传入，但传入了【订单总金额】和【不可打折金额】，则该值默认为【订单总金额】-【不可打折金额】

80.00

store_id

String

可选

32

商户门店编号。

指商户创建门店时输入的门店编号。

NJ_001

operator_id

String

可选

28

商户操作员编号。

yx_001

terminal_id

String

可选

32

商户机具终端编号。

NJ_T_001

merchant_order_no

String

可选

32

商户原始订单号，最大长度限制 32 位

20161008001

公共响应参数

参数 类型 是否必选 最大长度 描述 示例值

code String 必选 -

网关返回码,详见文档

40004

msg String 必选 -

网关返回码描述,详见文档

Business Failed

sub_code String 可选 -

业务返回码，参见具体的API接口文档

ACQ.TRADE_HAS_SUCCESS

sub_msg String 可选 -

业务返回码描述，参见具体的API接口文档

交易已被支付

sign String 必选 -

签名,详见文档

DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo=

响应参数

参数 类型 是否必选 最大长度 描述 示例值

out_trade_no String 必选 64

商户的订单号

6823789339978248

qr_code String 必选 1024

当前预下单请求生成的二维码码串，有效时间2小时，可以用二维码生成工具根据该码串值生成对应的二维码

https://qr.alipay.com/bavh4wjlxf12tper3a

请求示例

cUrl

Java

C#

PHP

响应示例

json

说明：本示例仅供参考。

异常示例

json

错误码

公共错误码

业务错误码

错误码 错误描述 解决方案

ACQ.ACCESS_FORBIDDEN 无权限使用接口

联系支付宝小二签约

ACQ.APPLY_PC_MERCHANT_CODE_ERROR 申请二维码失败

请确认同样的订单号不能重复多次申请二维码，如有问题请联系支付宝小二处理

ACQ.BEYOND_PAY_RESTRICTION 商户收款额度超限

联系支付宝小二提高限额

ACQ.BEYOND_PER_RECEIPT_DAY_RESTRICTION 订单金额超过当日累计限额

联系支付宝小二提高限额（联系电话：4007585858）

ACQ.BEYOND_PER_RECEIPT_RESTRICTION 商户收款金额超过月限额

联系支付宝小二提高限额

ACQ.BEYOND_PER_RECEIPT_SINGLE_RESTRICTION 订单金额超过单笔限额

联系支付宝小二提高限额（联系电话：4007585858）

ACQ.BUYER_ENABLE_STATUS_FORBID 买家状态非法

用户联系支付宝小二，确认买家状态为什么非法

ACQ.BUYER_NOT_EXIST 买家不存在

确认买家账号信息传递是否正确，如果正确可联系支付宝小二，确认买家账号是否已经注销

ACQ.BUYER_PAYMENT_AMOUNT_DAY_LIMIT_ERROR 买家付款日限额超限

更换买家进行支付

ACQ.BUYER_PAYMENT_AMOUNT_MONTH_LIMIT_ERROR 买家付款月额度超限

让买家更换账号后，重新付款或者更换其它付款方式

ACQ.BUYER_SELLER_EQUAL 买卖家不能相同

更换买家重新付款

ACQ.CONTEXT_INCONSISTENT 交易信息被篡改

更换商家订单号后，重新发起请求

ACQ.DEFAULT_SETTLE_RULE_NOT_EXIST 默认结算条款不存在

请确认二级商户进件是已经设置了默认结算账户

ACQ.ERROR_BUYER_CERTIFY_LEVEL_LIMIT 买家未通过人行认证

让用户联系支付宝小二并更换其它付款方式

ACQ.EXIST_FORBIDDEN_WORD 订单信息中包含违禁词

修改订单信息后，重新发起请求

ACQ.INVALID_PARAMETER 参数无效

检查请求参数，修改后重新发起请求

ACQ.INVALID_RECEIVE_ACCOUNT 收款账户不支持

确认seller_id信息是否传递正确，如正确请确认seller_id是否在签约中设置了收款权限

ACQ.INVALID_STORE_ID 商户门店编号无效

检查传入的门店编号是否符合规则

ACQ.MERCHANT_PERM_RECEIPT_DAY_LIMIT 超过单日累计收款额度

联系支付宝小二处理（联系电话：4007585858）

ACQ.MERCHANT_PERM_RECEIPT_SINGLE_LIMIT 超过单笔收款限额

联系支付宝小二处理（联系电话：4007585858）

ACQ.MERCHANT_PERM_RECEIPT_SUSPEND_LIMIT 商户暂停收款

联系支付宝小二处理（联系电话：4007585858）

ACQ.MERCHANT_STATUS_NOT_NORMAL 商户状态异常

因商户超过三个月未产生交易，需重新激活后可正常收单。1、进入支付宝商家中心，重新确认激活商家信息 或2、联系支付宝小二处理（联系电话：4007585858）

ACQ.NOW_TIME_AFTER_EXPIRE_TIME_ERROR 当前时间已超过允许支付的时间

请检查传入的支付超时时间是否正确

ACQ.PARTNER_ERROR 应用APP_ID填写错误

联系支付宝小二，确认APP_ID的状态

ACQ.RISK_MERCHANT_IP_NOT_EXIST 当前交易未传入IP信息，创单失败，请传入IP后再发起支付

检查请求参数是否已经传入用户IP信息

ACQ.SECONDARY_MERCHANT_ALIPAY_ACCOUNT_INVALID 二级商户账户异常

确认传入的二级商户结算账户是否与进件时设置的结算账户一致，如果一致可联系支付宝小二确认是否商户的账号信息有变更

ACQ.SECONDARY_MERCHANT_ID_BLANK 二级商户编号错误

请检查是否正确传入二级商户编号

ACQ.SECONDARY_MERCHANT_ID_INVALID 二级商户不存在

请检查传入的二级商户编号是否正确

ACQ.SECONDARY_MERCHANT_ISV_PUNISH_INDIRECT 商户状态异常

请联系对应的服务商咨询

ACQ.SECONDARY_MERCHANT_NOT_MATCH 二级商户信息不匹配

请检查传入的二级商户编号是否正确

ACQ.SECONDARY_MERCHANT_STATUS_ERROR 商户状态异常

请联系对应的服务商咨询

ACQ.SELLER_BEEN_BLOCKED 商家账号被冻结

联系支付宝小二，解冻账号

ACQ.SELLER_NOT_EXIST 卖家不存在

确认卖家信息是否传递正确

ACQ.SUB_GOODS_SIZE_MAX_COUNT 子商品明细超长

请检查子商品明细是否超过了150条

ACQ.SYSTEM_ERROR 接口返回错误

请立即调用查询订单API，查询当前订单的状态，并根据订单状态决定下一步的操作

ACQ.TOTAL_FEE_EXCEED 订单总金额超过限额

修改订单金额再发起请求

ACQ.TRADE_BUYER_NOT_MATCH 交易买家不匹配

更换商家订单号后，重新发起请求

ACQ.TRADE_HAS_CLOSE 交易已经关闭

更换商家订单号后，重新发起请求

ACQ.TRADE_HAS_SUCCESS 交易已被支付

确认该笔交易信息是否为当前买家的，如果是则认为交易付款成功，如果不是则更换商家订单号后，重新发起请求

ACQ.TRADE_SETTLE_ERROR 交易结算异常

请检查传入的结算项信息是否正确，如果正确请联系支付宝小二

触发通知类型

通知类型 描述 默认开启

tradeStatus.TRADE_CLOSED 交易关闭 0

tradeStatus.TRADE_FINISHED 交易完结 0

tradeStatus.TRADE_SUCCESS 支付成功 1

tradeStatus.WAIT_BUYER_PAY 交易创建 0

触发通知示例

https://www.merchant.com/receive_notify.htm?notify_type=trade_status_sync&notify_id=91722adff935e8cfa58b3aabf4dead6ibe&notify_time=2017-02-16 21:46:15&sign_type=RSA2&sign=WcO+t3D8Kg71dTlKwN7r9PzUOXeaBJwp8/FOuSxcuSkXsoVYxBpsAidprySCjHCjmaglNcjoKJQLJ28/Asl93joTW39FX6i07lXhnbPknezAlwmvPdnQuI01HZsZF9V1i6ggZjBiAd5lG8bZtTxZOJ87ub2i9GuJ3Nr/NUc9VeY=&trade_status=null&seller_email=null&buyer_pay_amount=null&buyer_open_id=074a1CcTG1LelxKe4xQC0zgNdId0nxi95b5lsNpazWYoCo5&merchant_app_id=2088102146225135&fund_bill_list=null&gmt_close=null&gmt_refund=null&gmt_payment=null&gmt_create=null&body=null&subject=null&refund_fee=null&seller_id=null&buyer_logon_id=null&open_id=null&out_biz_no=null&out_trade_no=null&app_id=null&trade_no=null&voucher_detail_list=null&buyer_id=null&point_amount=null&invoice_amount=null&receipt_amount=null&total_amount=null&charge_amount=8.88&charge_flags=bluesea_1&settlement_id=2018101610032004620239146945&notify_action_type=payByAccountAction/closeTradeAction/reverseAction/finishFPAction/confirmDisburseAction/financingReceiptAction&current_seller_received_amount=88.88&seller_received_total_amount=88.88&total_from_seller_fee=88.88&ff_current_period=1&passback_params=merchantBizType%3d3C%26merchantBizNo%3d2016010101111&hb_fq_pay_info={"USER_INSTALL_NUM":"3"}&receipt_currency_type=DC&discount_goods_detail="[{\"goodsId\":\"STANDARD1026181538\",\"goodsName\":\"雪碧\",\"discountAmount\":\"10.00\"}]"&enterprise_pay_info={"invoice_amount":"28.00"}&hyb_amount=10.24&bkagent_resp_info={"bindtrxId":"XXXXXXXXXXXXXX","bindclrissrId":"01","bindpyeracctbkId":"XXXXXXXXXXXXXX","bkpyeruserCode":"XXXXXXXXXXXXXX","estterLocation":" XXXXXXXXXXXXXX"}&charge_info_list=[{"charge_fee":"0.01","original_charge_fee":"0.02","switch_fee_rate":"0.03","is_rating_on_trade_receiver":"Y","is_rating_on_switch":"Y"}]