SDK-A集成文档1.0
<p>1、简要描述:</p>
<p>集成了UPI支付、专属UPI(UPI转账)和专属银行(网银转账)支付
SDK采取内置回调方式,模式为:SDK请求商户后台,商户返回结果。所以商户需要接入API格式,把API的结果返回给SDK。
业务流程图可以查看【代收代付时序图】,<a href="https://www.showdoc.com.cn/1033811985337405?page_id=5330629943513849">https://www.showdoc.com.cn/1033811985337405?page_id=5330629943513849</a> 点此直接到达
2、下载地址:</p>
<p>点击下载1.0 <a href="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/bed582928e7e39401427baa899990482" title="[ConsoleSDK.zip.zip">ConsoleSDK.zip.zip</a> 即可下载
点击下载2.0 <a href="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/56679bb053a299df997141085a5724c9" title="[consolesdk2.0.zip">consolesdk2.0.zip</a>即可下载
点击下载2.1(最新版)<a href="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/d9b2d39f8d127fa7c46bb5d9c971fb51" title="[consolesdk2.1.zip">consolesdk2.1.zip</a>即可下载
3、SDK代收商户后台对应调起业务API</p>
<p>4、SDK集成文档:</p>
<p>1)添加.aar包到lib文件夹
2)在app下build.gradle 的android标签下添加
repositories {
flatDir {
dirs 'libs'
}
}
3)添加aar包扫描
implementation fileTree(dir: 'libs', include: ['<em>.jar'])
android在原生基础上添加:'</em>.aar'
implementation fileTree(dir: 'libs', include: ['<em>.jar', '</em>.aar'])
4)添加自定义UI设置
是否显示普通UPI用户姓名电话号码
IMPPayManager.getService().setFixed(true);
设置自定义UI
设置弹出框选择字体颜色
IMPPayManager.getService().setSelectCenterColor(0xffDC143C);
设置标题背景色
IMPPayManager.getService().setTitleBackColor(0xffDC143C);
设置按钮背景色
IMPPayManager.getService().setButtonBackColor(0xffDC143C);
设置按钮字体色
IMPPayManager.getService().setButtonTextColor(0xffffffff);
设置copy按钮背景色
IMPPayManager.getService().setCopyBackColor(0xffDC143C);
设置copy按钮字体色
IMPPayManager.getService().setCopyTextColor(0xffffffff);
设置边框背景色
IMPPayManager.getService().setAccountCircleColor(0xffDC143C);
5)输入参数设置
订单参数设置
设置金额
orderEntity.setAmount(Amount.getText().toString());
设置名称
orderEntity.setName(Name.getText().toString());
设置订单号
orderEntity.setOrder(Order.getText().toString());
设置订单时间
orderEntity.setTime(Time.getText().toString());
普通UPI参数设置
UpiEntity param = new UpiEntity();
param.setPayerVA(PayerVA.getText().toString());
param.setPhone(Phone.getText().toString());
param.setName(Name2.getText().toString());
转账UPI参数设置
TranserEntity param = new TranserEntity();
param.setReceiverVa(ReceiverVa2.getText().toString());
转账银行参数设置
TranserEntity param = new TranserEntity();
param.setReceiverVa(ReceiverVa.getText().toString());
param.setIfsc(Ifsc.getText().toString());
6)调用付款平台
IMPPayManager.getService().CreateConsoleTransaction(
getBaseContext(), orderEntity,new IMPCallback() {
@Override
public void startNormalUpi() {
//普通UPI参数设置
UpiEntity param = new UpiEntity();
param.setPayerVA(PayerVA.getText().toString());
param.setPhone(Phone.getText().toString());
param.setName(Name2.getText().toString());
//开启UPI账号获取(有默认值)
IMPPayManager.setUPIParam(getBaseContext(), param);
//开启UPI账号获取(无默认值)
//IMPPayManager.setUPIParam(getBaseContext());
}
@Override
public void startTranserUpi() {
//转账UPI付款参数设置
TranserEntity param = new TranserEntity();
param.setReceiverVa(ReceiverVa2.getText().toString());
//开启转账UPI账号获取
IMPPayManager.setTransUPI(getBaseContext(), param);
}
@Override
public void startTranserBank() {
//转账网银付款参数设置
TranserEntity param = new TranserEntity();
param.setReceiverVa(ReceiverVa.getText().toString());
param.setIfsc(Ifsc.getText().toString());
//开启网银转账账号获取
IMPPayManager.setTransBank(getBaseContext(), param);
}
@Override
public void onError(int ErrorCode, String inErrorMessage) {
// 普通订单参数:10000;
// 普通错误upi:10001;
// 转账UPI错误:10002;
// 转账银行输入错误:10003;
}
@Override
public void onBack(int ErrorCode) {
//SDK退出回调()
//10005 订单页面直接返回<br />
//10006 进入UPI页面后返回
//10007 进入获取转账UPI后返回
//10008 进入获取转账银行账户后返回<br />
}
@Override
public void getNormalUpi(NUpiEntity payEntity) {
//UpiRequest转账参数回调
//拿到此参数调用平台提供的付款接口进行后续操作
}
});
版本更新2.0说明:</p>
<p>1,添加SDK国际化版本(印度语)
2,优化页面,添加付款说明文档
3,添加新型付款方式UPI方式,直接唤起第三方应用付款,方便用户使用(推荐支付方式)
4,付款方式及回调方法名称优化
付款方式名称优化:
UPI to Pay----> UPI Request
Transer to BANK----> Bank Transfer
Transer to UPI----> UPI Transfer
回调方法名称优化:
startTranserUpi----> startUpiRequest
setUPIParam----> setUpiRequest
getNormalUpi----> getUpiRequest
5,添加需要接入支付方式(中间用|隔开,避免无法识别,默认4中方式都接入)
UPI方式:UPIThree
UPI Request方式:UPIRequest
Bank Transfer方式:BankTransfer
UPI Transfer方式:UPITransfer
IMPPayManager.getService().setType("UPIThree|UPIRequest|UPITransfer|BankTransfer");</p>
<hr />
<p>SDK2.0支付方法调用实例
IMPPayManager.getService().CreateConsoleTransaction(getBaseContext(), orderEntity,new IMPCallback() {
@Override
public void startUpiRequest() {
//UPI参数设置
UpiEntity param = new UpiEntity();
param.setPayerVA();
param.setPhone();
param.setName();
//开启UPI账号获取(有默认值)
IMPPayManager.setUpiRequest(getBaseContext(), param);
//开启UPI账号获取(无默认值)
// IMPPayManager.setUpiRequest(getBaseContext());
}
@RequiresApi(api = Build.VERSION_CODES.O)
@Override
public void startUPI() {
//后台接口获取(token)
IMPPayManager.setUPI(getBaseContext(), token);
}
@Override
public void startTranserUpi() {
//转账UPI付款参数设置(后台接口生成专属UPI)
TranserEntity param = new TranserEntity();
param.setReceiverVa();
//开启转账UPI账号获取
IMPPayManager.setTransUPI(getBaseContext(), param);
}
@Override
public void startTranserBank() {
//DC UPI
//转账网银付款参数设置(后台接口生成专属银行卡号)
TranserEntity param = new TranserEntity();
param.setReceiverVa();
param.setIfsc();
//开启网银转账账号获取
IMPPayManager.setTransBank(getBaseContext(), param);
}
@Override
public void onError(int ErrorCode, String inErrorMessage) {
//错误日志回调
}
@Override
public void onBack(int ErrorCode) {
//SDK退出回调()
//10005 订单页面直接返回<br />
//10006 进入UPI页面后返回
//10007 进入获取转账UPI后返回
//10008 进入获取转账银行账户后返回<br />
//10009 进入UPI付款方式后返回<br />
}
@Override
public void getUpiRequest(UpiEntity payEntity) {
//UpiRequest转账参数回调
//拿到此参数调用平台提供的UPI付款接口进行后续操作
}
});</p>