T-Linx2.0外部应用开放平台接口

Size: px

Start display at page:

Download "T-Linx2.0外部应用开放平台接口"

陌芬侯
5 years ago
Views:

1 APP&H5& 微信小程序接口文档 V

2 1. 文档更新日志版本日期备注 V H5 下单参数 sub_appid 修改为非必传 2 新增微信小程序支付 3 新增商户配置接口( 同原 jsapi 商户支付配置文档 ) V 初始版 1. 文档更新日志

3 2. 订单接口下订单接口 payorder 请求参数返回参数返回示例

4 2. 接口配置 2.1 商户支付配置 contract/addconfig 通讯方式以及加密参考进件文档配置一次只能配置一种请求参数字段名称请求方式必填数据类型长度说明 open_id get true int 32 机构编号 lang get false string 5 系统返回的语言默认 zh-cn, 支持 zh-tw timestamp get true string 10 Linx 时间戳, 至现在的秒数 randstr get true string 32 随机字符串, 不能少于 32 位 ( 数字字母 ) sign post true string 32 rsa 签名字符串, 需要私钥进行签名 data post true string 128 open_key 进行 aes 加密后的数据 data 字段 json 数据 ctt_code post ture string 32 合同编号 jsapi_path post string 64 支付授权目录 sub_appid post 三选一 string 32 配置关联公众号 appid subscribe_ap pid 配置 post string 32 配置推荐关注公众号 appid 返回参数字段名称必填数据类型长度说明 errcode true string 4 返回错误码, 为 0 表示没有错误 msg true string 32 返回错误提示, 会根据 lang 参数返回不同的语言 data false string 128 open_key 进行 aes 加密后的数据 sign false string 64 rsa 私钥签名字符串, 需要公钥验签 4

5 data 字段 json 数据 status true string 1 配置状态 (0 成功 ) msg true sting 300 错误信息 data true list 300 相关信息请求地址 GET: XX&timestamp=XXX POST:data=XXX&sign=XXX 返回示例 { "errcode": 0, "msg": " 操作成功 ", 3. 订单接口 3.1 下订单接口 payorder 原生 jsapi 支付说明 : 下单后会返回原生 jsapi 支付的 js 参数. 通讯方式以及加密参考商户支付接口文档请求参数字段名称请求方式必填数据类型长度说明 open_id post true string 20 商户门店 open_id timestamp post true string 10 Unix 时间戳 5

6 sign post true string 30 签名 out_no post true string 64 开发者流水号, 确认同一门店内唯一付款方式编号举例如 : pmt_tag post true string 10 测试环境 :WeixinOL 生产环境 :WeixinOL 可以调用 paylist 接口查看商户开通了哪些支付方式 pmt_name post false string 10 商户自定义付款方式名称, 当 pmt_tag 为 Diy 时,pmt_name 不能为空 ord_name post false string 100 订单名称 ( 描述 ) original_amo unt discount_am ount ignore_amou nt trade_amoun t post true int 20 原始交易金额 ( 以分为单位, 没有小数点 ) post false int 20 折扣金额 ( 以分为单位, 没有小数点 ) post false int 20 抹零金额 ( 以分为单位, 没有小数点 ) post true int 20 实际交易金额 ( 以分为单位, 没有小数点 ) trade_accoun t post false string 50 交易帐号 ( 收单机构交易的银行卡号, 手机号等, 可为空 ) trade_no post false string 50 交易号 ( 收单机构交易号, 可为空 ) remark post false string 100 订单备注 tag post false string 50 订单标记, 订单附加数据 notify_url post false string 200 异步通知地址 ( 新增 ) 支付方式 :APP 支付 sub_appid post true string 200 微信分配的子商户公众账号 ID trade_type post true string 16 默认值 APP ( 新增 ) 支付方式 :H5 支付 6

7 sub_appid post false string 200 微信分配的子商户公众账号 ID trade_type post true string 200 H5 支付传递固定值 MWEB spbill_create_ ip post true string 50 客户端用户真是的 ip 地址 scene_info post true string 256 场景信息 ( 新增 ) 支付方式 : 微信小程序支付 sub_appid post true string 200 微信小程序的 appid sub_openid post true string 200 用户在商户下小程序 appid 下的唯一标识 ( 自己获取 ) trade_type post true string 16 默认值 JSAPI 微信高级参数 goods_tag post false json limit_pay post false string 商品标记, 代金券或立减优惠功能的参数其它说明详见微信说明 limit_pay=no_credit, 限制用户不能使用信用卡支付返回参数字段名称必填数据类型长度说明 errcode true string 4 返回错误码, 为 0 表示没有错误 msg true string 32 返回错误提示, 会根据 lang 参数返回不同的语言 data false string open_key 进行 aes 加密后的数据 sign false string MD5 验签 data 字段 json 数据 pmt_name true string 32 收单机构名称 pmt_tag true string 20 收单机构标签 ord_mct_id true int 20 商户流水号 ( 从 1 开始自增长不重复 ) ord_shop_id true int 20 门店流水号 ( 从 1 开始自增长不重复 ) 7

8 ord_no true string 20 订单号 ord_type false int 1 订单类型 (1 消费,2 辙单 ) original_amount false int 20 原始金额 ( 以分为单位, 没有小数点 ) discount_amount false int 20 折扣金额 ( 以分为单位, 没有小数点 ) ignore_amount false int 20 抹零金额 ( 以分为单位, 没有小数点 ) trade_account false string 100 交易帐号 ( 银行卡号支付宝帐号微信帐号等, 某些收单机构没有此数据 ) trade_no false string 50 收单机构交易号 trade_amount true int 20 实际交易金额 ( 以分为单位, 没有小数点 ) trade_qrcode false string 200 二维码字符串 trade_pay_time false datetime 付款完成时间 ( 以收单机构为准 ) status true int 1 订单状态 (1 交易成功,2 待支付,4 已取消, 9 等待用户输入密码确认 ) trade_result true string 4000 收单机构原始交易数据 out_no true string 20 开发者流水号 jsapi_pay_url false string 100 公众号订单支付地址, 如果为非公众号订单, 此参数为空 H5 返回参数 mweb_url true string 255 mweb_url 为拉起微信支付收银台的中间页面, 可通过访问该 url 来拉起微信客户端, 完成支付,mweb_url 的有效期为 5 分钟 (H5) APP 返回参数 appid true string 32 公众号 id(app) partnerid true string 32 子商户号 (APP) prepayid true string 32 预支付交易会话标识 (APP) package true string 128 扩展字段 (APP) noncestr true string 32 随机字符串 (APP) timestamp true string 32 时间戳 (APP) sign true string 32 签名 (APP) 8

9 小程序返回参数 appid true string 32 小程序的 appid noncestr true string 32 随机字符串 timestamp true string 32 时间戳 signtype true string 32 签名方式 package true string 128 统一下单接口返回 prepay_id 参数值 paysign true string 64 签名请求示例 GET: POST:data=XXX&sign=XXX?open_id=XXX&randStr=XXX&timestamp=XXX 返回示例 { "errcode": 0, "msg": " 订单提交成功 ", "timestamp": "data": { "ord_no": "123456", "ord_mct_id": "28", "ord_shop_id": "28", "ord_currency": "CNY", "currency_sign": " ", "pmt_tag": "Weixin", "pmt_name": " 微信支付 ", "trade_no": "wx bd46afd ", "trade_amount": "1", "trade_qrcode": "weixin://wxpay/bizpayurl?pr=zswfi1a", "trade_account": null, "trade_result": "{\"return_code\":\"success\",\"return_msg\":\"ok\",\"appid\":\"12345\",\"mch_id\":\"12345\",\"sub_mch_id\":\"123 45\",\"nonce_str\":\"S5iffPxMziF68Dt0\",\"sign\":\"F6B2BE4314F279EAAEA C08522\",\"result_code\":\"SUCC ESS\",\"prepay_id\":\"wx bd46afd \",\"trade_type\":\"NATIVE\",\"code_url\":\"weixin: \\/\\/wxpay\\/bizpayurl?pr=zswfi1a\"}", "trade_pay_time": null, "status": "2", 9

10 "out_no": "12345", "mweb_url": "", "appid": "12345", "partnerid": "12345", "prepayid": "wx ", "package": "Sign=WXPay", "noncestr": "2", "timestamp": "12345", "sign": "0EA0D80F92BE5AA2BA0989C0DD9F88BE" }, } 10

【服务商商户】开通免充值业务功能API接口升级详情

【服务商商户】开通免充值业务功能API接口升级详情开通免充值业务功能 API 接口升级详情开通免充值业务功能后, 以下 6 个支付业务接口部分参数将会按照以下表格变更, 请确认是否优先进行内部系统升级以适配新的接口参数 (api 接口中, 只有使用了免充值券才会返回新增参数 ) 一接口变更概览 : 编号接口名称新增修改删除修改参数名称 : 1 下载对账单新增返回字段 : 1 订单金额 2 申请退款金额 3 费率备注 4 订单总金额 5 申请退款总金额