订单推送
商家自有系统的订单推送至收钱吧专门收款设备上(如T9设备等),使商家在设备上利用其原有的收款功能,能够操作完成订单的收款。
入口
{api_domain}/appPush/tradePush
签名验证
请参考签名机制文档
请求参数说明
参数 | 参数名称 | 类型 | 必填 | 描述 |
---|---|---|---|---|
terminal_sn | 收钱吧终端号 | String(32) | Y | 收钱吧终端ID,不超过32位的纯数字。推送订单的收银系统绑定的终端号。 |
out_trade_no | 商户订单号 | String(32) | Y | 允许英文字母与阿拉伯数字。必须在商户系统内唯一;且长度不超过32字节。与支付接口的client_sn字段相同,可在之后查单、退款时使用。 |
total_amount | 订单金额 | String(10) | Y | 以分为单位,不超过10位纯数字字符串。如"1"=1分;"100"=1元。 |
trade_time | 推送时间 | String(13) | Y | 商家收银系统发起订单推送的时间。时间戳,13位 |
target_device_id | 推送设备号 | String(20) | Y | 设备编号。如,T9设备背后展示的TUSN编号,收银系统扫描其条形码录入该编号 |
notify_url | 回调地址 | String(128) | Y | 支付回调的地址,见回调接口。交易完成的结果会回调推送该地址。如正确响应即停止推送,如无正确响应则持续推送,直至最大推送次数。每次推送间隔为:1s,5s,30s,600s |
cancel_notify_url | 订单取消支付通知地址 | String(128) | N | 订单取消支付时,回调通知的地址 |
pay_type | 支付类型 | String(32) | N | 1:银行卡,2:扫码,3:花呗,支持为空或上送多个,以","分隔 |
remark | 备注 | String(16) | N | 订单备注 |
* 该接口同步返回的报文基本结构同其它接口,见《接口响应字段》。具体返回字段值参见《业务结果码-订单推送业务结果码》