跳到主要内容

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支持以下第三方功能:


  1. 收款、退款、查询多笔交易记录、查询交易明细。

2.查看交易摘要,查询交易通道配置。


  1. 对于卡的交易/撤销/查询/调整端点
Introduction

如何使用

添加权限

将以下代码添加到 AndroidManifest.xml 文件中。 注:为了保证您能获得权限,请先安装haojin App。

Add Permissions

添加 Jar Package Dependency

将qfpay_haojin_api_xxx.jar文件集成到第三方应用中。

Add Jar Package Dependency

配置 Target Application Id

Config Target Application Id

添加 Proguard Rule

Add follow code to the proguard-rules.pro file.

Add Proguard Rule

第三方接口调用示例

收单

调用收单请求:

Collection

退款

调用退款请求:

Refund

解析返回值:

Refund

查询多笔交易

调用查询请求:

Query Multiple Transaction
备注

  1. 检查支持的通道。
    2.仅支持两种交易类型(付款、退款)查询
    3、按时间段查询优先级高于按月查询。
    4.时间格式为“yyyy-MM-dd HH:mm:ss
    5.月份格式为“yyyyMM”
    6、分页数值从1开始。

解析返回值:

Query Multiple Transaction

Query Transaction Details

调用查询请求:

Query Transaction Details

解析返回值:

Query Transaction Details

View Transaction Summary

调用查看交易摘要请求:

View Transaction Summary

解析返回值:

View Transaction Summary

查询交易通道配置(已弃用)

该接口已被标记为已弃用,可以用 GetUserConfig 接口替换。 详细信息请参见查询客户配置信息

调用查询交易通道配置请求:

Query Transaction Channel Configuration(Deprecated)

解析返回值:

Query Transaction Channel Configuration(Deprecated)

查询客户配置信息

调用查询客户配置信息请求:

Query User Configuration Information

解析返回值:

Query User Configuration Information

预授权交易扣款

调用预授权交易扣款请求:

Pre-authorization Transaction Deduction

解析返回值:

Pre-authorization Transaction Deduction

预授权交易取消

调用预授权交易取消请求:

Pre-authorization Transaction Cancel

解析返回值:

Pre-authorization Transaction Cancel

预授权交易列表

调用预授权交易列表请求:

Pre-authorization Transaction List

解析返回值:

Pre-authorization Transaction List

预授权交易详情

调用预授权交易详情:

Pre-authorization Transaction Detail

解析返回值:

Pre-authorization Transaction Detail

卡退款

调用卡退款请求

Card Refund

解析返回值:

Card Refund

Query Multiple Card Transactions

调用查询请求:

Query Multiple Card Transactions

解析返回值:

Query Multiple Card Transactions

Query Card Transaction Details

调用查询请求:

Query Card Transaction Details

解析返回值:

Query Card Transaction Details Query Card Transaction Details

卡调整

调用卡调整请求:

Card Adjust

解析返回值:

Card Adjust

卡清算

调用卡清算请求:

Card Settle

解析返回值:

Card Settle

附录

交易信息字段说明

参数名称参数类型是否必填描述
idString交易识别码
amtLong交易金额
timeString交易时间 格式:yyy-MM-dd HH:mm:ss
channelString交易通道 例如 weixin, alipay
statusInteger交易状态
typeString交易类型, payment 支付 or refund 退款
originIdString原本交易识别码, 如果交易是退款则必须填写
mchntNameString商户名字
remarksString交易备注
confirmCodeString交易确认码
operatorAccountString操作员名称
appCodeString申请码(刷卡)
customerIdString客户钱包身份(预授权)
customerAccountString客户钱包账户(预授权)
completeTransIdString预授权交易完成时新生成的交易Id(预授权)
completeTimeString预授权交易完成的完成时间 格式yyyy-MM-dd HH:mm:ss(预授权)

通道信息字段说明

参数名称参数类型是否必填描述
nameString通道名字
descString通道描述

交易状态字段说明

交易状态描述
0正常交易
-1/-2等待支付
-3失败
1沖正
2撤销
3退款
4部分退款
5预授权冻结
6预授权解冻
7预授权完成

结果代码 说明

结果代码描述
-1未知错误
0成功
100客户端错误
101金额错误
102AppId为空
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退款失败