跳到主要内容

付款码支付

请求接口

openapi/v2/pay/trans/micropay

公共参数

[接口协议 - 公共参数](/docs/openapi/v2/dev/rule/params.md

请求参数

参数必填类型说明
auth_codeString(64)支付付款码
amountint支付金额,单位分
out_trade_noString(32)业务订单号,业务方保证唯一
subjectString(127)商品名或订单简要描述
client_ipString(32)客户端IP
time_startString(20)订单生成时间,格式为:yyyy-MM-dd HH:mm:ss,不传默认为当前时间
time_expireString(20)订单失效时间,格式为:yyyy-MM-dd HH:mm:ss,建议:最短失效时间间隔大于1分钟
currencyString(16)货币类型,默认人民币:CNY
limit_creditint是否限制使用信用卡,1为限制,0或不传为不限制,默认为0
attachString(127)附加信息,会跟订单信息一起原样返回
goods_tagString(32)商品标记,优惠券或单品营销使用
goods_detailsJson商品详情,Json结构,做单品优惠时传入。goods_details结构
terminal_infoJson线下终端设备信息,Json结构。 terminal_info结构

线下付款码支付不建议回调,而是通过主动轮询的方式获取订单最新状态。 轮询间隔建议2-5s,持续40-60s

响应参数

名称必填类型说明
auth_codeString支付付款码
pay_noString聚合支付订单号
paymentString支付方式
statusint支付状态。参见支付状态值枚举
attachString附加信息,原样返回
以下字段在支付直接成功status=100时返回
transaction_idString支付平台交易流水号。微信、支付宝、云闪付等用户支付使用的平台返回流水号
ch_transaction_idString间连渠道交易流水号。聚合或其他第三方间连渠道返回流水号
amountint交易总额,单位:分
pay_timeString支付时间,格式"yyyy-MM-dd HH:mm:ss"
succ_timeString支付完成时间,只有在支付成功时返回,格式"yyyy-MM-dd HH:mm:ss"