实例介绍
|-- Secureay_client2.4.2 //测试用Demo
|-- securepay-lib.jar //SDK jar包
|-- ReadMe.txt //接入说明
|-- CustomConfig.properties //客户化配置的文件
2、接入说明
请参考Demo, Demo中支持两种支付接入方式(标准版,卡前置),请在Demo主页按menu键,弹出菜单内选择对应的接入方式。
注意:Demo中的所有数据均为测试数据,请接入时参考接入文档《连连支付手机应用SDK认证支付商户接口说明书》字段说明组装正式数据。
2.0、适用场景
2.0.1、标准版:适合商户不对用户支付环节进行处理的情况,即商户产生订单后,直接使用SDK进行支付,用户的银行卡管理完全有SDK负责。
2.0.2、卡前置:商户界面需要对支付时的银行卡进行管理,包括首次输入卡号,历次产生绑定卡列表。
2.1、将根目录下securepay-lib.jar 拷贝到项目工程的libs下
2.2、参考Demo中AndroidManifest.xml 关于Activity,service 和uses-permission的配置,配置到项目中。
2.3、认证支付SDK的接入具体方式,请参考Demo工程Secureay_client2.4.2\src\com\yintong\activity\AuthActivity.java
2.4、商户配置请参考Secureay_client2.4.2\src\com\yintong\secure\demo\env\EnvConstants.java
根据您的接入方式,选择配置对应的商户号和秘钥(秘钥分为RSA和MD5两种,请根据在商户站上的配置进行配置。建议配置到服务器,避免key泄露)
Demo中配置的是测试用商户号,请接入时替换为自己的商户号。
2.5、认证支付用户名和身份证号信息必须传入
3、客户化配置
SDK提供部分可定制化的设置,包括标题头颜色,高度等等,具体请参考 CustomConfig.properties。
1、如果需要定制,请修改这个文件,并将其放入assets目录下(注意格式UTF-8)。
1、1具体修改字段说明,请参考CustomConfig.properties各个字段的说明。
2、如果需要修改图片,可以直接用压缩工具将securepay-lib.jar打开,图片在assets目录里面,直接替换掉就可以了。
4、短信自动读取功能的解释
SDK支持短信自动读取功能,但由于各手机厂家对Android原生系统的定制不同,短信的读取规则也不一样。SDK支持以下两种短信读取。
4.1、原生系统4.4以下版本的,可以在AndroidManifest.xml中配置权限"android.permission.RECEIVE_SMS"即可。
4.2、如果想支持类似小米系统的和Android4.4以上版本的,需要配置"android.permission.READ_SMS"。此权限(可以读取用户短信)有可能会被某些安全软件认为是较危险的,请添加时自行评估。
4.2.1、小米手机等深度定制手机需要针对该应用开启读取短信功能方可读取。小米设置路径:设置--> 应用--> 该应用--> 权限管理--> 短信记录--> 允许。
4.2.2、三星Galaxy S5 等三星手机4.4以上系统版本的,如果配置了"android.permission.READ_SMS",可能存在必须允许打开读取权限方可使用的问题,请测试后自行评估是否配置该权限。
注意,部分手机安装了安全工具,有可能会拦截到短信,导致不能自动读取。另外手机厂商对手机短信的安全控制各不相同,无法适配所有机器,请跟情况配置权限。
5、为了增加安全控制系数,SDK可以增加用户位置信息的获取,但在用户进入支付时部分手机会弹框提示用户应用程序会获取用户位置信息(如小米3),如果业务风险控制严格的请评估用户体验影响后自行配置该功能。
如需要配置,请在AndroidManifest.xml中配置权限"android.permission.ACCESS_FINE_LOCATION"。没有配置该权限,SDK不会进行位置信息的获取动作。
6、混淆说明
请参考Demo中Secureay_client2.4.2\proguard.pro 只添加我们的keep 规则。
【实例截图】
【核心代码】
package com.yintong.activity; import com.yintong.pay.utils.BaseHelper; import com.yintong.pay.utils.Constants; import com.yintong.pay.utils.Md5Algorithm; import com.yintong.pay.utils.MobileSecurePayer; import com.yintong.pay.utils.PayOrder; import com.yintong.pay.utils.ResultChecker; import com.yintong.secure.auth.demo.R; import com.yintong.secure.demo.env.EnvConstants; import org.json.JSONException; import org.json.JSONObject; import android.app.Activity; import android.os.Bundle; import android.os.Handler; import android.os.Message; import android.text.TextUtils; import android.util.Log; import android.view.Menu; import android.view.MenuInflater; import android.view.MenuItem; import android.view.View; import android.view.View.OnClickListener; import android.widget.Button; import android.widget.EditText; import android.widget.TextView; import android.widget.Toast; import java.text.SimpleDateFormat; import java.util.Date; import java.util.Locale; public class AuthActivity extends Activity { private Button jump_btn; /* * 支付验证方式 0:标准版本, 1:卡前置方式,此两种支付方式接入时,只需要配置一种即可,Demo为说明用。可以在menu中选择支付方式。 */ private int pay_type_flag = 0; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.authpay); jump_btn = (Button) findViewById(R.id.jump_btn); jump_btn.setOnClickListener(new OnClickListener() { @Override public void onClick(View v) { PayOrder order = null; if (pay_type_flag == 0) { // 标准支付 order = constructGesturePayOrder(); String content4Pay = BaseHelper.toJSONString(order); // 关键 content4Pay 用于提交到支付SDK的订单支付串,如遇到签名错误的情况,请将该信息帖给我们的技术支持 Log.i(AuthActivity.class.getSimpleName(), content4Pay); MobileSecurePayer msp = new MobileSecurePayer(); boolean bRet = msp.pay(content4Pay, mHandler, Constants.RQF_PAY, AuthActivity.this, false); Log.i(AuthActivity.class.getSimpleName(), String.valueOf(bRet)); } else if (pay_type_flag == 1) { // TODO 卡前置方式, 如果传入的是卡号,卡号必须大于等于14位 if (((EditText) findViewById(R.id.bankno)).getText() .toString().length() < 14 && TextUtils .isEmpty(((EditText) findViewById(R.id.agree_no)) .getText().toString())) { Toast.makeText(AuthActivity.this, "卡前置模式,必须填入正确银行卡卡号或者协议号", Toast.LENGTH_LONG) .show(); return; } order = constructPreCardPayOrder(); String content4Pay = BaseHelper.toJSONString(order); Log.i(AuthActivity.class.getSimpleName(), content4Pay); MobileSecurePayer msp = new MobileSecurePayer(); boolean bRet = msp.pay(content4Pay, mHandler, Constants.RQF_PAY, AuthActivity.this, false); Log.i(AuthActivity.class.getSimpleName(), String.valueOf(bRet)); } } }); } private Handler mHandler = createHandler(); private Handler createHandler() { return new Handler() { public void handleMessage(Message msg) { String strRet = (String) msg.obj; switch (msg.what) { case Constants.RQF_PAY: { JSONObject objContent = BaseHelper.string2JSON(strRet); String retCode = objContent.optString("ret_code"); String retMsg = objContent.optString("ret_msg"); // TODO 先判断状态码,状态码为 成功或处理中 的需要 验签 if (Constants.RET_CODE_SUCCESS.equals(retCode)) { // TODO 卡前置模式返回的银行卡绑定协议号,用来下次支付时使用,此处仅作为示例使用。正式接入时去掉 if (pay_type_flag == 1) { TextView tv_agree_no = (TextView) findViewById(R.id.tv_agree_no); tv_agree_no.setVisibility(View.VISIBLE); tv_agree_no.setText(objContent.optString( "agreementno", "")); } String resulPay = objContent.optString("result_pay"); if (Constants.RESULT_PAY_SUCCESS .equalsIgnoreCase(resulPay)) { BaseHelper.showDialog(AuthActivity.this, "提示", "支付成功,交易状态码:" retCode, android.R.drawable.ic_dialog_alert); // TODO 支付成功后续处理 } else { BaseHelper.showDialog(AuthActivity.this, "提示", retMsg ",交易状态码:" retCode, android.R.drawable.ic_dialog_alert); } } else if (Constants.RET_CODE_PROCESS.equals(retCode)) { String resulPay = objContent.optString("result_pay"); if (Constants.RESULT_PAY_PROCESSING .equalsIgnoreCase(resulPay)) { BaseHelper.showDialog(AuthActivity.this, "提示", objContent.optString("ret_msg") "交易状态码:" retCode, android.R.drawable.ic_dialog_alert); } } else { BaseHelper.showDialog(AuthActivity.this, "提示", retMsg ",交易状态码:" retCode, android.R.drawable.ic_dialog_alert); } } break; } super.handleMessage(msg); } }; } private PayOrder constructGesturePayOrder() { SimpleDateFormat dataFormat = new SimpleDateFormat("yyyyMMddHHmmss", Locale.getDefault()); Date date = new Date(); String timeString = dataFormat.format(date); PayOrder order = new PayOrder(); order.setBusi_partner("101001"); order.setNo_order(timeString); order.setDt_order(timeString); order.setName_goods("龙禧大酒店中餐厅:2-3人浪漫套餐X1"); order.setNotify_url("http://beta.www.youtx.com/youtxpay/LianlianPay/YTPay_Notify.aspx"); // MD5 签名方式 order.setSign_type(PayOrder.SIGN_TYPE_MD5); // RSA 签名方式 // order.setSign_type(PayOrder.SIGN_TYPE_RSA); order.setValid_order("100"); order.setUser_id(((EditText) findViewById(R.id.userid)).getText() .toString()); order.setId_no(((EditText) findViewById(R.id.idcard)).getText() .toString()); order.setAcct_name(((EditText) findViewById(R.id.name)).getText() .toString()); order.setMoney_order(((EditText) findViewById(R.id.money)).getText() .toString()); order.setFlag_modify("1"); String sign = ""; order.setOid_partner(EnvConstants.PARTNER); String content = BaseHelper.sortParam(order); // MD5 签名方式, 签名方式包括两种,一种是MD5,一种是RSA 这个在商户站管理里有对验签方式和签名Key的配置。 sign = Md5Algorithm.getInstance().sign(content, EnvConstants.MD5_KEY); // RSA 签名方式 // sign = Rsa.sign(content, EnvConstants.RSA_PRIVATE); order.setSign(sign); return order; } private PayOrder constructPreCardPayOrder() { SimpleDateFormat dataFormat = new SimpleDateFormat("yyyyMMddHHmmss", Locale.getDefault()); Date date = new Date(); String timeString = dataFormat.format(date); PayOrder order = new PayOrder(); order.setBusi_partner("101001"); order.setNo_order(timeString); order.setDt_order(timeString); order.setName_goods("龙禧大酒店中餐厅:2-3人浪漫套餐X1"); order.setNotify_url("http://beta.www.youtx.com/youtxpay/LianlianPay/YTPay_Notify.aspx"); // MD5 签名方式 order.setSign_type(PayOrder.SIGN_TYPE_MD5); // RSA 签名方式 // order.setSign_type(PayOrder.SIGN_TYPE_RSA); order.setValid_order("100"); order.setUser_id(((EditText) findViewById(R.id.userid)).getText() .toString()); order.setId_no(((EditText) findViewById(R.id.idcard)).getText() .toString()); order.setAcct_name(((EditText) findViewById(R.id.name)).getText() .toString()); order.setMoney_order(((EditText) findViewById(R.id.money)).getText() .toString()); // 银行卡卡号,该卡首次支付时必填 order.setCard_no(((EditText) findViewById(R.id.bankno)).getText() .toString()); // 银行卡历次支付时填写,可以查询得到,协议号匹配会进入SDK, order.setNo_agree(((EditText) findViewById(R.id.agree_no)).getText() .toString()); // 风险控制参数。 order.setRisk_item(constructRiskItem()); String sign = ""; order.setOid_partner(EnvConstants.PARTNER); String content = BaseHelper.sortParam(order); // MD5 签名方式 sign = Md5Algorithm.getInstance().sign(content, EnvConstants.MD5_KEY); // RSA 签名方式 // sign = Rsa.sign(content, EnvConstants.RSA_PRIVATE); order.setSign(sign); return order; } /** * TODO 风险控制参数生成例子,请根据文档动态填写。最后返回时必须调用.toString() */ private String constructRiskItem() { JSONObject mRiskItem = new JSONObject(); try { mRiskItem.put("user_info_bind_phone", "13958069593"); mRiskItem.put("user_info_dt_register", "201407251110120"); mRiskItem.put("frms_ware_category", "4.0"); mRiskItem.put("request_imei", "1122111221"); } catch (JSONException e) { e.printStackTrace(); } return mRiskItem.toString(); } private PayOrder constructSignCard() { PayOrder order = new PayOrder(); order.setSign_type(PayOrder.SIGN_TYPE_MD5); // RSA 签名方式 // order.setSign_type(PayOrder.SIGN_TYPE_RSA); order.setUser_id(((EditText) findViewById(R.id.userid)).getText() .toString()); order.setId_no(((EditText) findViewById(R.id.idcard)).getText() .toString()); order.setAcct_name(((EditText) findViewById(R.id.name)).getText() .toString()); order.setCard_no(((EditText) findViewById(R.id.bankno)).getText() .toString()); String sign = ""; order.setOid_partner(EnvConstants.PARTNER); String content = BaseHelper.sortParamForSignCard(order); // MD5 签名方式 sign = Md5Algorithm.getInstance().sign(content, EnvConstants.MD5_KEY); // RSA 签名方式 // sign = Rsa.sign(content, EnvConstants.RSA_PRIVATE); order.setSign(sign); return order; } @Override public boolean onCreateOptionsMenu(Menu menu) { MenuInflater inflater = getMenuInflater(); inflater.inflate(R.menu.menu_xml_file, menu); return true; } @Override public boolean onOptionsItemSelected(MenuItem item) { if (R.id.menu_1 == item.getItemId()) { // 标准支付模式 findViewById(R.id.layout_precard).setVisibility(View.GONE); findViewById(R.id.money).setVisibility(View.VISIBLE); pay_type_flag = 0; } else if (R.id.menu_2 == item.getItemId()) { // 卡前置模式 pay_type_flag = 1; findViewById(R.id.layout_precard).setVisibility(View.VISIBLE); findViewById(R.id.money).setVisibility(View.VISIBLE); findViewById(R.id.agree_no).setVisibility(View.VISIBLE); } return super.onOptionsItemSelected(item); } }
标签: 支付
小贴士
感谢您为本站写下的评论,您的评论对其它用户来说具有重要的参考价值,所以请认真填写。
- 类似“顶”、“沙发”之类没有营养的文字,对勤劳贡献的楼主来说是令人沮丧的反馈信息。
- 相信您也不想看到一排文字/表情墙,所以请不要反馈意义不大的重复字符,也请尽量不要纯表情的回复。
- 提问之前请再仔细看一遍楼主的说明,或许是您遗漏了。
- 请勿到处挖坑绊人、招贴广告。既占空间让人厌烦,又没人会搭理,于人于己都无利。
关于好例子网
本站旨在为广大IT学习爱好者提供一个非营利性互相学习交流分享平台。本站所有资源都可以被免费获取学习研究。本站资源来自网友分享,对搜索内容的合法性不具有预见性、识别性、控制性,仅供学习研究,请务必在下载后24小时内给予删除,不得用于其他任何用途,否则后果自负。基于互联网的特殊性,平台无法对用户传输的作品、信息、内容的权属或合法性、安全性、合规性、真实性、科学性、完整权、有效性等进行实质审查;无论平台是否已进行审查,用户均应自行承担因其传输的作品、信息、内容而可能或已经产生的侵权或权属纠纷等法律责任。本站所有资源不代表本站的观点或立场,基于网友分享,根据中国法律《信息网络传播权保护条例》第二十二与二十三条之规定,若资源存在侵权或相关问题请联系本站客服人员,点此联系我们。关于更多版权及免责申明参见 版权及免责申明
网友评论
我要评论