请求参数说明 <{api_domain}/haipay/micropay>

参数 参数名称 类型 是否必须 示例值 描述
appid appid String(32) 必须 hf1020354855HWMA 1.appid(机构):由开放平台统一分配,用于识别请求开放平台的机构商应用,同时用于签名。

2.appid(商户):由商户在商户平台-应用列表中新增的应用,标识商户侧请求开发平台的应用,同时用于签名。 备注:机构appid和商户appid相互独立,使用流程不一。

sign 签名 String(32) 必须 288100720801151687safd 不集成SDK:所有参与请求的字段配合appsecret根据签名规则进行签名根据,签名规则请看文档说明。

集成SDK:SDK自动签名。

org_id 机构号 String(128) 非必须 20180604172617127LU9NAW5R7IO1AA 机构号,用于识别机构主体。是机构在开放平台内的唯一标识。
merchant_no 商户号 String(128) 特殊非必须 20180604172617127LU9NAW5R7IO1AA 商户号,开放平台系统生成的商户号,是开放平台下商户的唯一标识,当传入机构号时,商户号和外部商户号特殊选填二选一。
out_merchant_no 外部商户号 String(128) 特殊非必须 20180604172617127LU9NAW5R7IO1AA 外部商户号,由机构商系统生成,是机构下商户的唯一标识,同一个机构下需保证外部商户号唯一性。当传入机构号时,商户号和外部商户号必传其一。
openid 系统中的openid String(32) 非必须 45534471284841158322307115207110 开放平台角色标识。角色有(商户、店长、店员) 用于商户区分订单归属那个门店/用户收款,如果输入错误并且不存在的openid,系统将自动过滤,订单将纳入商户角色收款
total_amount 支付金额 Integer 必须 12912 交易金额,只能为人民币交易,接口中参数支付金额单位为【分】
discountable_amount 优惠金额-暂未使用 Integer 非必须 888 参与优惠计算的金额,仅支付宝订单有效,单位为【分】如果该值未传入,但传入了【订单总金额】和【不可打折金额】,则该值默认为【订单总金额】-【不可打折金额】
discount_coupon 优惠券-暂未使用 String(32) 非必须 13004567132648 微信支付优惠券
body 商品名称 String(32) 非必须 ipad pro 在客户端中展示
detail 商品详情 String(8192) 非必须 说明详见商品明细说明,在订单中展示本次交易支付所使用的单品券优惠的商品优惠信息
auth_code 用户授权码 String(128) 特殊非必填 130025998499 支付授权码,实际字符串长度以开发者获取的付款码长度为准, 付款码即微信、支付宝等钱包上的付款条码/二维码,刷脸支付场景时传入FToken
attach 附加数据 String(128) 非必须 说明 商家数据包,原样返回
pay_type 支付方式 String(2) 非必须 1 0:微信

1:支付宝

如果不传即自动识别

nonce_str 随机数 String(32) 必须 39523182131882585253504626424160 随机字符串,长度要求为32位字符串,用于签名
out_trade_no 商户外部订单号 String(32) 必须 20180604172617127LU9NAW5R7IO1AA 商户外部订单号,由商户自定义生成,需保持唯一性,每次发起都需重新生成新的订单号(建议根据当前系统时间戳加随机序列来生成订单号),长度8-32位(建议商户外部订单号长度为30-32位)
version 版本号 String(8) 必须 V1.0 版本号固定值为 V1.0
note 订单备注 String(128) 非必须 备注 订单备注 仅做记录
scene 场景 String(128) 非必须 1 1:条码

2:声波

3:刷脸

默认为1

un_discountable_amount 不可打折金额 Integer 非必须 100 仅支付宝订单有效,单位为【分】,【订单总金额】=【可打折金额】+【不可打折金额】
auth_order_no 商户授权订单号 String(64) 特殊非必须 auth201807162112584023786330 授权支付模式商户平台生成的授权订单号,用于查询标识冻结。auth_order_no和auth_confirm_mode都填写的时候判定为预授权支付,此时auth_code可不填。
auth_confirm_mode 授权支付模式 String(20) 特殊非必须 NOT_COMPLETE COMPLETE:转交易支付完成结束预授权;NOT_COMPLETE:转交易支付完成不结束预授权(暂不支持)。auth_order_no和auth_confirm_mode都填写的时候判定为预授权支付,此时auth_code可不填。
zim_id 刷脸调用的标识 String(128) 特殊非必须 支付宝刷脸支付调用的标识,scene = 3 and pay_type =1 时必传
wx_open_id 微信openid String(256) 特殊非必须 微信的openid,scene = 3 and pay_type =0 时必传
face_code 人脸凭证 String(128) 特殊非必须 人脸凭证,scene = 3 and pay_type =0 时必传
Copyright © 创匠科技 2018 all right reserved,powered by Gitbook该文件修订时间: 2019-02-26 15:18:35

results matching ""

    No results matching ""