目录
前言
接下来的几篇文章,我会介绍一下,在实际项目中,我们会介绍,如何接入第三方支付(国外),比如纸币、找零、扫码以及刷卡等。
我们将深入探讨在接入这些支付系统前所需的准备工作、接入过程中双方的协作方式,以及接入完成后的交付流程。这些经验均源自我的亲身开发实践。
在这个过程中,我遇到了不少挑战,也浪费了许多宝贵的时间。因此,我迫切希望将这些经验分享给你们,以帮助你们在未来的项目中更加顺利地完成支付系统的接入。
这些支付方式在自动售卖机中尤为常见,特别是在海外,自动售卖机几乎随处可见。为了满足无人值守的支付需求,这些设备迫切需要接入高效、便捷的支付系统。
本篇文章,我将重点介绍扫码支付。
一、需求场景:扫码支付(开发前对接,需要对方提供信息)
当需求来以后我们应该如何对接呢?
今天我们收到需求,客户要我们的自动售卖机,接入一个日本的支付方式。那么我们需要对方提供什么?
- 提供对应的API文档。这样我们就可以评估是否可以接入到我们Android程序里面,还是说要建立一个后台系统才行。
- 提供测试环境。比如密钥、id等账户信息,用于我们测试使用。不然无法测试对应的流程。
- 建立对应的微信群,或whatsApp。因为对方给的信息不一定是正确的,我们调试过程中会遇到各种问题,需要建立这样的一个技术群取进行对接,这样会加快我们的效率,实在不行才会考虑邮箱,但邮箱的回复是非常慢的。
- 如果有对应的Android Demo对接实例,会更加快速的加速我们的开发,因为有些支付公司的对接,加密是非常麻烦的,如果能提供可运行的项目,对我们的效率提升非常大。
有了这些大致的信息,我们就可以开始测试,然后进行开发时间的评估。
二、阅读、测试对方提供的API
我们看一个具体的支付公司的案例,比如我们要接入日本的Take Me支付。
官网:docs.takeme.com/references/…
跟客户明确好,我们具体要开发哪一种,因为TakeMe的文档里面有很多种支付
比如我们要开发的是Universal Payment,简单介绍一下这种支付方式的流程如上图,Payment flow
- 我们(Shop)要创建一个二维码出来,要给消费者扫码进行支付,所以我们需要发送请求给TakeMe的服务器。需要我们提供金额,这样他才能知道具体要创建多少金额的二维码,也要提供订单号,后面你要根据订单号去查询是否支付成功。
- 那么二维码返回后,我们就进行展示,消费者开始扫码。
- 接着我们要开始查询订单,是否支付成功,如果支付成功,启动自动售卖机出商品。
- 商品出来以后,我们要上传一个信息,告知商品出货成功,如果失败则上传出货失败。
好的,大体的流程,其实就是这样。所以从上面我们也可以得出,具体我们需要对方提供哪些接口,我们看看他的文档。核心的接口:
- Create a PredefinedPayment for online usage. :创建一个二维码,TakeMe会返回一个url,我们在代码里面将其转换成一个二维码。
- Retrieve a PredefinedPayment:根据订单号查询是否结果如何。
第三个接口,上传出货状态,这里没有,有些支付不提供这个接口。
2.1 开始测试API
这个时候,我们先不要写代码,没错,还不需要写代码。我们要借助Postmen工具或者Apifox工具,进行接口的测试。
为什么要这样呢?为什么不直接写代码呢?
因为在测试过程中,你会遇到千奇百怪的问题,如果你用代码,他们会怀疑写的代码有问题,请求体有问题,接口没有设置好,等等各种怀疑,会导致各种甩锅,尤其是和国外的人交流,语言不通,只能靠翻译,解释起来就更加的麻烦,浪费时间。
所以我们推荐使用Postmen工具或者Apifox工具,大家都在使用,并且参数的设置,全部都摆在那里,究竟是谁的问题,一看便知。
所以写代码之前,一定要使用这个工具先跑一遍。确保对方没有问题后,才进行写代码。
2.2 接口API详解
(1)请求二维码的接口:Create a PredefinedPayment for online usage.
这个官方文档,还是非常的厉害的,提供的信息非常的清晰,连接是怎么样,需要什么请求参数,响应体是什么。
【请求信息】
- amount:是金额
- custom:是备注信息,你可以填写商品名字,比如你卖出了草莓冰淇淋,就写草莓冰淇淋,菠萝,就菠萝。这样就知道这笔订单做的是什么。
- redirection_url:是支付成功后跳转的url
- expires_after:是二维码的过期时间
【响应信息】
参数太多了,我们就简单介绍几个关键信息
- token:用于查询支付状态的信息,后面我们会用到,我们需要保存起来。
- url:二维码url
(2) 根据订单号查询是否结果如何:Retrieve a PredefinedPayment
将第一个接口获取的token带入进去即可。
【响应参数】
- fulfilledf返回true就是支付成功
三、代码示例
- 使用retrofit发起网络
japanRetrofit = new Retrofit.Builder()
.client(builder.build())
.addConverterFactory(GsonConverterFactory.create())
.addCallAdapterFactory(RxJava2CallAdapterFactory.create())
.baseUrl("https://stg.ribenmeishi.com/")
.build();
- 创建接口
@POST("v3/predefined_payments/create_online_payment")
@Headers("Content-Type: application/x-www-form-urlencoded; charset=utf-8")
Observable createOnlinePayment(
@QueryMap Map params,
@HeaderMap Map headers // 使用@HeaderMap来传递额外的请求头
) ;
@GET("v3/predefined_payments/{token}")
Observable queryPaymentorder(@Path("token") String token);
- 发起请求和处理
HashMap params = new HashMap<>();
params.put("amount", localPrice);
params.put("custom", productName);
params.put("redirection_url", "https://www.example.com");
params.put("expires_after","3600" );
params.put("order_no", xxx);
Map headers = new HashMap<>();
headers.put("X-Auth-API-Key", xxx);
addSubscription(TakeMePayApi.api.createOnlinePayment(params,headers),
new HttpResultObserver(mView, mContext) {
public void onNext(String baseOrder) {
if (TextUtils.isEmpty(baseOrder)) {
return;
}
Gson gson = new Gson();
TakeMePayBean takeMePayBean = gson.fromJson(baseOrder, TakeMePayBean.class);
String token = takeMePayBean.getPredefined_payment().getToken();
String url = takeMePayBean.getUrl();
mView.getTakeMeCodeSuccess(url,token);
}
@Override
public void onError(Throwable t) {
t.printStackTrace();
}
});
二维码的转换,你可以使用Glide来进行
this.eventBusCode = eventBusCode;
Bitmap bitmap = ZXingUtils.createQRImage(url, 600, 600);
this.msn = token;
ByteArrayOutputStream baos = new ByteArrayOutputStream();
bitmap.compress(Bitmap.CompressFormat.PNG, 100, baos);
byte[] bytes = baos.toByteArray();
RequestOptions options = new RequestOptions()
.diskCacheStrategy(DiskCacheStrategy.NONE)
.skipMemoryCache(true);
Glide.with(getContext())
.load(bytes)
.apply(options)
.into(ivQrCode);
四、 第三方支付对接的其他信息
上面文章讲解的内容,只是核心部分,还会有一些测试呀,加密呀等流程。
-
如果你对结果其他的第三方支付,你也会发现有一些不一样的地方,比如有些会麻烦一些,参数需要排序,需要加密,那么就需要写这些代码,不过有了AI,可以大大节约我们的时间,加密的话就根据对方的规定,使用对应的加密工具,这个就会很花时间了,需要测试,验证加密是否正确,这个就没什么方法,只能测试了。如果对方能提供代码示例,那么问题也会迎刃而解。
-
有些第三方支付,我们写好后,需要进行测试验收,也就是需要你提供请求体,响应体给他;还有取消支付会怎么样;支付过程中取消会怎么样,这些都需要做,这样才能确保你写的代码经得起折腾,这些测试也会很花时间。
-
有一些第三方开发的好的话,他们会直接给你测试码,直接返回对应不同的错误码,这样你就可以节省很多时间。
五、总结
对接扫码支付,其实并不是难,也就几个接口:
- 获取二维码。
- 查询支付结果。
难的地方在于对于流程的了解,当你了解了全局后,你就大概知道问题可能会出现在对方的身上,还是我们自己的身上。
难的地方在于沟通,你需要让对方非常清晰明了的了解你发送了什么参数,用到域名是什么,借助大家都是用的工具,那么就会方便很多。
1、本站所有资源均从互联网上收集整理而来,仅供学习交流之用,因此不包含技术服务请大家谅解!
2、本站不提供任何实质性的付费和支付资源,所有需要积分下载的资源均为网站运营赞助费用或者线下劳务费用!
3、本站所有资源仅用于学习及研究使用,您必须在下载后的24小时内删除所下载资源,切勿用于商业用途,否则由此引发的法律纠纷及连带责任本站和发布者概不承担!
4、本站站内提供的所有可下载资源,本站保证未做任何负面改动(不包含修复bug和完善功能等正面优化或二次开发),但本站不保证资源的准确性、安全性和完整性,用户下载后自行斟酌,我们以交流学习为目的,并不是所有的源码都100%无错或无bug!如有链接无法下载、失效或广告,请联系客服处理!
5、本站资源除标明原创外均来自网络整理,版权归原作者或本站特约原创作者所有,如侵犯到您的合法权益,请立即告知本站,本站将及时予与删除并致以最深的歉意!
6、如果您也有好的资源或教程,您可以投稿发布,成功分享后有站币奖励和额外收入!
7、如果您喜欢该资源,请支持官方正版资源,以得到更好的正版服务!
8、请您认真阅读上述内容,注册本站用户或下载本站资源即您同意上述内容!
原文链接:https://www.shuli.cc/?p=21029,转载请注明出处。
评论0