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位 反射参数

results matching ""

    No results matching ""