统一收单线下交易预创建接口 -凯发app官方网站

产品地图

支付产品

当面付

接入指南

api 列表

app支付

手机网站支付

电脑网站支付

刷脸付

预授权支付

商家扣款

订单码支付

私域产品

公域产品

营销产品

资金产品

会员产品

信用产品

安全产品

广告产品

其他通用产品

支持第三方代理调用

更新时间：2024-12-10 18:38:43

订阅更新

我的文档

设置

接入检测（

即可查看检测结果）

若有未通过的接入检测项，接口将无法调通

当面付

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

注意：

预下单请求生成的二维码有效时间为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)

【描述】订单标题。
注意：不可使用特殊字符，如 /，=，& 等。

【示例值】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 格式，其它说明详见商品明细说明

goods_id必选string(32)

【描述】商品的编号

【示例值】apple-01

goods_name必选string(256)

【描述】商品名称

【示例值】ipad

quantity必选number(32)

【描述】商品数量

【示例值】1

price必选price(9)

【描述】商品单价，单位为元

【示例值】2000

goods_category可选string(24)

【描述】商品类目

【示例值】34543238

categories_tree可选string(128)

【描述】商品类目树，从商品类目根节点到叶子节点的类目id组成，类目id值使用|分割

【示例值】124868003|126232002|126252004

show_url可选string(400)

【描述】商品的展示地址

【示例值】http://www.alipay.com/xxx.jpg

extend_params可选extendparams

【描述】业务扩展参数

sys_service_provider_id可选string(64)

【描述】系统商编号
该参数作为系统商返佣数据提取的依据，请填写系统商签约协议的pid

【示例值】2088511833207846

specified_seller_name可选string(32)

【描述】特殊场景下，允许商户指定交易展示的卖家名称

【示例值】xxx的跨境小铺

card_type可选string(64)

【描述】卡类型

【枚举值】

s0jp0000: s0jp0000

【示例值】s0jp0000

business_params可选businessparams

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

【示例值】{"data":"123"}

mc_create_trade_ip可选string(128)

【描述】商户端创建订单的 ip，须上传正确的用户端外网 ip，支持 ipv4/ipv6 格式；
mc_create_trade_ip和mccreatetradeip（旧）参数描述相同，首选mc_create_trade_ip入参，请勿重复入参；
如已入参mccreatetradeip（旧），无需新增入参mc_create_trade_ip。

【示例值】127.0.0.1

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

参数	类型	是否必选	最大长度	描述	示例值
out_trade_no	string	必选	64	商户订单号。由商家自定义，64个字符以内，仅支持字母、数字、下划线且需保证在商户端不重复。	20150320010101001
total_amount	price	必选	12	订单总金额，单位为元，精确到小数点后两位，取值范围为 [0.01,100000000]，金额不能为 0。如果同时传入了【可打折金额】，【不可打折金额】，【订单总金额】三者，则必须满足如下条件：【订单总金额】=【可打折金额】【不可打折金额】	88.88
subject	string	必选	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

常见请求示例

默认示例

curljavac#php

curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.trade.precreate&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
 -f 'app_auth_token=${app_auth_token}' \
 -f 'biz_content={
	"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_name":"ipad",
			"quantity":1,
			"price":"2000",
			"goods_id":"apple-01",
			"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"
	},
	"discountable_amount":"80.00",
	"store_id":"nj_001",
	"operator_id":"yx_001",
	"terminal_id":"nj_t_001",
	"merchant_order_no":"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

参数	类型	是否必选	最大长度	描述	示例值
out_trade_no	string	必选	64	商户的订单号	6823789339978248
qr_code	string	必选	1024	当前预下单请求生成的二维码码串，有效时间2小时，可以用二维码生成工具根据该码串值生成对应的二维码	https://qr.alipay.com/bavh4wjlxf12tper3a

响应示例

正常示例

异常示例

{
    "alipay_trade_precreate_response": {
        "code": "10000",
        "msg": "success",
        "out_trade_no": "6823789339978248",
        "qr_code": "https://qr.alipay.com/bavh4wjlxf12tper3a"
    },
    "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}

说明：本示例仅供参考。

公共错误码

业务错误码

错误码	错误描述	凯发app官方网站的解决方案
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¬ify_id=91722adff935e8cfa58b3aabf4dead6ibe¬ify_time=2017-02-16 21:46:15&sign_type=rsa2&sign=wco t3d8kg71dtlkwn7r9pzuoxeabjwp8/fousxcuskxsovyxbpsaidpryscjhcjmaglncjokjqlj28/asl93jotw39fx6i07lxhnbpknezalwmvpdnqui01hzszf9v1i6ggzjbiad5lg8bzttxzoj87ub2i9guj3nr/nuc9vey=&invoice_amount=null&buyer_pay_amount=null&point_amount=null&buyer_id=null&voucher_detail_list=null&trade_no=null&app_id=null&out_trade_no=null&out_biz_no=null&open_id=null&buyer_logon_id=null&seller_id=null&seller_email=null&trade_status=null&total_amount=null&refund_fee=null&subject=null&body=null&gmt_create=null&gmt_payment=null&gmt_refund=null&gmt_close=null&fund_bill_list=null&merchant_app_id=2088102146225135&buyer_open_id=074a1cctg1lelxke4xqc0zgndid0nxi95b5lsnpazwyoco5&receipt_amount=null&charge_amount=8.88&charge_flags=bluesea_1&settlement_id=2018101610032004620239146945¬ify_action_type=paybyaccountaction/closetradeaction/reverseaction/finishfpaction/confirmdisburseaction/financingreceiptaction¤t_seller_received_amount=88.88&seller_received_total_amount=88.88&total_from_seller_fee=88.88&ff_current_period=1&passback_params=merchantbiztype=3c&merchantbizno=2016010101111&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"}]

设置阅读模式