2.1. 预下单接口
接口介绍:
描述:在与礼品/SVC应用程序的选卡对接之前,请提前向收钱吧的系统下订单。获取密钥参数“Token”以继续后续操作。此外,订单信息还用于帮助商户通过礼品卡选择器从帐户中选择礼品卡。
API endpoint: {api_domain}/api/giftcard/v1/orders/_precreate
Verb: POST
参数 | 出现 | 类型 | 约束 | 描述 |
---|---|---|---|---|
brand_code | 1 | String | 数字,最大 6 位 | 品牌编号, 由收钱吧提供 |
store_sn | 1 | String | 字符串,最大 36 位 | 商户门店编号 |
workstation_sn | 1 | String | 字符串,最大 36 位 | 门店收银机编号, 如果商户系统没有此参数,则设置为 0 |
check_sn | 1 | String | 字符串,最大 36 位 | 商户核对账单号码或商户订单号 |
total_amount | 1 | String | 数字,最大 10 位 | 订单总额,以分为单位 |
trade_mode | 1 | String | 数字,1 位 | 0: 付款 |
trade_scene | 1 | String | 字符串,最大 36 位 | 集成场景,如下所示 “PC_WEB”:当场景是 PC 网站时 “APP”:当场景为商户移动应用时 “WX_MINIAPP”:当场景是微信小程序时” |
subject | 1 | String | 字符串,最大 64 位 | 交易的概述 |
out_trade_no | 1 | String | 字符串,最大 36 位 | 商户系统的交易号 |
payer_uid | 0-1 | String | 字符串,最大 64 位 | 消费者在支付通道的 id |
goods_details | 0-1 | String | 结构如下: { “goods_id”:” ” ; “goods_name”:” ”; “ quantity”:” ”; “price”: “in cent”, “promotion_type”: “0-no;1-has” } | |
timeout | 0-1 | String | 数字,最大 6 位 | 以秒为单位,默认值为 7200 秒 |
notify_url | 1 | String | 字符串,最大 128 位 | 客户选卡后接收通知的地址 |
reflect | 0-1 | String | 字符串,最大 256 位 | 反射参数 |
返回参数:
参数 | 出现 | 类型 | 约束 | 描述 |
---|---|---|---|---|
brand_code | 1 | String | 数字,最大 6 位 | 品牌编号, 由收钱吧提供 |
store_sn | 1 | String | 字符串,最大 36位 | 商户门店编号 |
workstation_sn | 1 | String | 字符串,最大 36位 | 门店收银机编号, 如果商户系统没有此参数,则设置为 0 |
check_sn | 1 | String | 字符串,最大 36位 | 商户核对账单号码或商户订单号 |
redirect_url | 0-1 | String | 字符串,最大 12位 | 仅当交易类型为“PC 网站”时发生,商户应使用此选项重定向到礼品卡收银台 |
token | 0-1 | String | 字符串,最大 12位 | 订单标记,如果创建订单成功,则返回 |
out_trade_no | 1 | String | 字符串,最大 36位 | 商户系统的交易号 |
trade_no | 1 | String | 字符串,最大 36位 | 订单的唯一序列号 |
reflect | 0-1 | String | 字符串,最大 256位 | 反射参数 |