App call App Android SDK
最近更新
version 2.3.4.jar
1、sdk 支持指定正扫或者反扫支付
CollectionReq.SCAN_TYPE_SCAN:扫码支付
CollectionReq.SCAN_TYPE_QRCODE:QR_CODE 支付
设置方法:
CollectionReq req = new CollectionReq(Long.parseLong(money));
req.setScan_type(scan_type);//设置扫码方式, CollectionReq.SCAN_TYPE_SCAN/CollectionReq.SCAN_TYPE_QRCODE
version 2.3.3.jar
1、Transaction 添加getOut_trade_no 和getCardscheme 方法
version 2.3.2.jar
更新内容:
一、交易相关
1、交易支持传入外部订单号 out_trade_no :
2、支持设置设置刷卡(card_payment/unionpay_card/amex_card)等待超时时间wait_card_timeout(可以不设置),wait_card_timeout如果不设置,
默认超时120s,该参数必须大于0,如果传小于等于0的值,则超时时间默认120s
设置方法:
CollectionReq req = new CollectionReq(Long.parseLong(money));
req.setWait_card_timeout(wait_card_timeout);//设置刷卡超时时间
req.setOut_trade_no(out_trade_no);//设置外部订单号
二、查询、
1、支持使用out_trade_no 查询交易信息,
order_id 和 out_trade_no 至少传一个,或者两个都传
设置方法:
GetTransReq req = new GetTransReq(order_id);
req.setOut_trade_no(out_trade_no);
version 2.3.1.jar
1、app call app sdk 支付时支持具体的支付方式
通过 CollectionReq setPay_method 设置具体的支付方式:,如果不设置具体的支付方式,
或者账号没有开通相应的支付方式,则会弹出支付方式选择框,自己选择
pay_method 字段 类型 String ,参考值如下:
pay_method desc
(1)、card_payment Card payment(master/visa)
(2)、wx WeChat Pay
(3)、alipay Alipay
(4)、payme PayMe
(5)、union UnionPay
(6)、fps FPS
(7)、octopus Octopus
(8)、unionpay_card union card pay
(9)、amex_card amex card pay
2、sdk 支持设置前后置摄像头
通过 CollectionReq setCamera_id 设置 前后置摄像头 可以不设置,默认后置:
camera_id:扫码支付的时候可以切换前后摄像头,可以不传这个字段,默认是后置摄像头
camera_id 字段 类型 Int ,参考值如下:
0:CAMERA_PARAM_BACK 后置摄像头
1:CAMERA_PARAM_FROT 前置摄像头
例如:
CollectionReq req = new CollectionReq(Long.parseLong(money));
req.setPay_method(current_paymethod);
req.setCamera_id(current_camera);
简介
HaoJin是一款为商户提供聚合收款服务的手机软件。 本文档描述了HaoJin开放的接口调用,第三方应用程序可以通过这些接口实现收单功能。 HaoJin支持以下第三方功能:
- 收款、退款、查询多笔交易记录、查询交易明细。
2.查看交易摘要,查询交易通道配置。
- 对于卡的交易/撤销/查询/调整端点
如何使用
添加权限
将以下代码添加到 AndroidManifest.xml 文件中。 注:为了保证您能获得权限,请先安装haojin App。
添加 Jar Package Dependency
将qfpay_haojin_api_xxx.jar文件集成到第三方应用中。
配置 Target Application Id
添加 Proguard Rule
Add follow code to the proguard-rules.pro file.
第三方接口调用示例
收单
调用收单请求:
退款
调用退款请求:
解析返回值:
查询多笔交易
调用查询请求:
备注
- 检查支持的通道。
2.仅支持两种交易类型(付款、退款)查询
3、按时间段查询优先级高于按月查询。
4.时间格式为“yyyy-MM-dd HH:mm:ss”
5.月份格式为“yyyyMM”
6、分页数值从1开始。
解析返回值:
Query Transaction Details
调用查询请求:
解析返回值:
View Transaction Summary
调用查看交易摘要请求:
解析返回值:
查询交易通道配置(已弃用)
该接口已被标记为已弃用,可以用 GetUserConfig 接口替换。 详细信息请参见查询客户配置信息。
调用查询交易通道配置请求:
解析返回值:
查询客户配置信息
调用查询客户配置信息请求:
解析返回值:
预授权交易扣款
调用预授权交易扣款请求:
解析返回值:
预授权交易取消
调用预授权交易取消请求:
解析返回值:
预授权交易列表
调用预授权交易列表请求:
解析返回值:
预授权交易详情
调用预授权交易详情:
解析返回值:
卡退款
调用卡退款请求
解析返回值:
Query Multiple Card Transactions
调用查询请求:
解析返回值:
Query Card Transaction Details
调用查询请求:
解析返回值:
卡调整
调用卡调整请求:
解析返回值:
卡清算
调用卡清算请求:
解析返回值:
附录
交易信息字段说明
参数名称 | 参数类型 | 是否必填 | 描述 |
---|---|---|---|
id | String | 是 | 交易识别码 |
amt | Long | 是 | 交易金额 |
time | String | 是 | 交易时间 格式:yyy-MM-dd HH:mm:ss |
channel | String | 是 | 交易通道 例如 weixin, alipay |
status | Integer | 是 | 交易状态 |
type | String | 是 | 交易类型, payment 支付 or refund 退款 |
originId | String | 否 | 原本交易识别码, 如果交易是退款则必须填写 |
mchntName | String | 是 | 商户名字 |
remarks | String | 否 | 交易备注 |
confirmCode | String | 否 | 交易确认码 |
operatorAccount | String | 是 | 操作员名称 |
appCode | String | 否 | 申请码(刷卡) |
customerId | String | 否 | 客户钱包身份(预授权) |
customerAccount | String | 否 | 客户钱包账户(预授权) |
completeTransId | String | 否 | 预授权交易完成时新生成的交易Id(预授权) |
completeTime | String | 否 | 预授权交易完成的完成时间 格式yyyy-MM-dd HH:mm:ss(预授权) |
通道信息字段说明
参数名称 | 参数类型 | 是否必填 | 描述 |
---|---|---|---|
name | String | 是 | 通道名字 |
desc | String | 是 | 通道描述 |
交易状态字段说明
交易状态 | 描述 |
---|---|
0 | 正常交易 |
-1/-2 | 等待支付 |
-3 | 失败 |
1 | 沖正 |
2 | 撤销 |
3 | 退款 |
4 | 部分退款 |
5 | 预授权冻结 |
6 | 预授权解冻 |
7 | 预授权完成 |
结果代码 说明
结果代码 | 描述 |
---|---|
-1 | 未知错误 |
0 | 成功 |
100 | 客户端错误 |
101 | 金额错误 |
102 | AppId为空 |
103 | 订单Id为空 |
104 | 其他参数为空 |
105 | 用户取消 |
106 | 网络错误 |
107 | 用户未登录 |
108 | 应用程序未安装 |
109 | 启动应用程序失败 |
110 | 不支持API调用 |
111 | 时间段错误 |
112 | 不允许跨月查询 |
113 | 获取配置信息失败 |
114 | 调整卡交易失败 |
115 | 设备不支持刷卡 |
116 | 密码输入错误 |
200 | 服务器错误 |
201 | 订单Id 不存在 |
202 | 交易失败 |
203 | 账户余额不足 |
204 | 交易正在确认中 |
205 | 登录状态已过期 |
206 | 退款正在确认中 |
207 | 退款失败 |