Stripe 银行卡支付功能初步指南(Java)

2024-02-20 22:58
文章标签 java 功能 初步 支付 指南 银行卡 stripe

本文主要是介绍Stripe 银行卡支付功能初步指南(Java)，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

Stripe 国外银行卡支付功能指南(Java)

简介

        编写这篇文章的目的就是~~没有什么目的。网上关于stripe银行卡支付代码很多，有写得很好的，但是太多太杂了，不系统。所以我就结合项目中实际应用，总结了一些比较常用的方法，希望能给予各位一些帮助。
        当然我的这个指南也不是很完全，以后如果有机会还会继续补充。

Stripe支付步骤

开通stripe账号

这是最最重要的一步，没有账号后面的内容就不用看啦~~

账号开通之后就是要获得密钥了，stripe密钥分为线上环境密钥和测试环境密钥，我们因为只是做测试就申请测试密钥即可,下面所有讨论的东西都是以测试环境为主
在这里插入图片描述
密钥有两种：
可发布密钥(pk_test)：前端实现stripe接口时用
密钥(sk_test)：后端实现stripe方法时用

因为是测试并且所有的支付都是我后台这边操作的，我这边只需要用sk_test的即可，线上环境同理
在这里插入图片描述
至此所有准备工作都已经准备好了，我们开始实现银行卡支付功能。

Stripe Api 核心功能

下面是官方文档提供的一些资料，因为官方文档是纯英文版，找的比较麻烦，就把一些使用的文档记录下

StripeApi文档
Stripe接口返回错误码文档
Stripe测试银行卡号

测试账号不想看上面文档的可以用下面这个即可
通用付款成功 4242 4242 4242 4242

stripe支付核心功能很多，包括但不限于Token、Card、Customers、PaymentIntent、PaymentMethod、Source、Charge

我这边因为业务逻辑并不那么广泛，并没有全部涉及到，所有下面只解释我所用到的核心功能

Customers

顾名思义customber就是用户，凡是需要使用银行卡支付的用户都需要在stripe上创建自己的独立账户，并且最好是需要与你业务上的用户保持唯一，当然这是根据实际情况来的,你不唯一也是可以的，如果你想这么做的话。
在这里插入图片描述

创建Customers
Stripe.apiKey =  your key;//创建客户时的参数，方便后面识别，具体参数详见api，这里的话推荐description参数必传，这里的值会展示在stripe平台上方便后面观察
Map<String, Object> params = new HashMap<>();
params.put("description","My First Test Customer (created for API docs)"
);Customer customer = Customer.create(params);
//stripe平台Customers的唯一标识
String customerId = customer.getId();

Tokens

Token是Stripe用来客户收集敏感卡或者银行账户信息的过程，当用户填写了银行卡的卡号、过期年月、CVC等信息后，Stripe会生成过一个包含这些信息的Token，这样在传输过程中，确保没有敏感的卡数据和我们自己的服务器交互，降低客户真实信息丢失率。我们自身的服务器，取到token,进行支付即可 。

Token不能多次存储和使用，要存储卡的信息供以后使用，可以创建用户。将卡的信息添加给用户。
在这里插入图片描述

创建银行卡号相关Token
Stripe.apiKey =  your key;Map<String, Object> card = new HashMap<>();
card.put("number", "4242424242424242");
card.put("exp_month", 2);
card.put("exp_year", 2022);
card.put("cvc", "314");
Map<String, Object> params = new HashMap<>();
params.put("card", card);Token token = Token.create(params);
//在后面创建银行卡时可以使用，传参过程无需再填写银行卡相关信息
String tokenId = token.getId();

Cards

可以在一个客户上存储多张卡，向该客户收费。您还可以在收件人上存储多个借记卡，以便以后转移到这些借记卡上。
在这里插入图片描述

创建Card并与Customers绑定

Customers初次绑定Card时，如果绑定成功，此Card将成为支付时的默认Card。

Stripe.apiKey =  your key;Map<String, Object> retrieveParams = new HashMap<>();
List<String> expandList = new ArrayList<>();
expandList.add("sources");
retrieveParams.put("expand", expandList);
Customer customer =Customer.retrieve("Customers对应id",retrieveParams,null);Map<String, Object> params = new HashMap<>();
params.put("source", "银行卡的tokenId");Card card =(Card) customer.getSources().create(params);
//建议将卡号保存下来
String cardId = card.getId();
修改Customers的支付默认Card

如果Customers有多张Card，需要更改支付时的默认卡片。

Stripe.apiKey =  your key;Map<String, Object> retrieveParams = new HashMap<>();
List<String> expandList = new ArrayList<>();
expandList.add("sources");
retrieveParams.put("expand", expandList);
Customer customer = Customer.retrieve("Customers对应id", retrieveParams,null);Map<String, Object> params = new HashMap<>();
params.put("default_source", "需要设置为默认Card的Id");
customer.update(params);
修改Card

修改Card只允许修改一下参数，如果多写了其他参数方法会报错
在这里插入图片描述

Stripe.apiKey =  your key;Map<String, Object> retrieveParams =new HashMap<>();
List<String> expandList = new ArrayList<>();
expandList.add("sources");
retrieveParams.put("expand", expandList);
Customer customer =Customer.retrieve("Customers对应id",retrieveParams,null);Card card =customer.getSources().retrieve("需要修改Card的Id");//修改参数
Map<String, Object> params = new HashMap<>();
params.put("name", "Jenny Rosen");Card updatedCard = (Card) card.update(params);
删除Card

如果删除的是默认Card，系统会默认按时间顺序寻找到上一次最后添加的卡片并设置为默认Card。

Stripe.apiKey =  your key;Map<String, Object> retrieveParams =new HashMap<>();
List<String> expandList = new ArrayList<>();
expandList.add("sources");
retrieveParams.put("expand", expandList);
Customer customer =Customer.retrieve("Customers对应id",retrieveParams,null);Card card =customer.getSources().retrieve("需要删除Card的Id");Card deletedCard = (Card) card.delete();

Charges

要收取信用卡或借记卡的费用，请创建一个Charge对象。您可以检索并退还单个费用以及列出所有费用。费用由唯一的随机ID标识。

PS:stripe的支付有很多种方式，直接从默认卡扣费，或者回调监听扣费等等方式，我这边因为扣费操作都在后台，与前端没有交互，所以就直接用默认卡扣费的方式操作了

Map<String, Object> params = new HashMap<>();
//金额，实际金额*100，最小支付金额是0.5
params.put("amount", 2000);
//货币单位，小写，银行卡扣费货币换算stripe内部自行转换，我们不需要关心
params.put("currency", "aud");
params.put("customer", "Customers对应id");
params.put("description","My First Test Charge (created for API docs)"
);
//是否立即捕获费用。默认为true。如果为false，则费用会发出授权（或预授权），以后需要捕获。未捕获的费用将在7天内到期。
params.put("capture", true);Charge charge = Charge.create(params);
//可以实时获取支付状态
if ("succeeded".equals(charge.getStatus())) {//交易成功后，需要更新我们的订单表，修改业务参数，此处省略return true;} else {return false;}

Webhook Endpoints

通过API配置Webhook端点，以通知您的Stripe帐户或关联帐户中发生的事件。
在这里插入图片描述
在这里插入图片描述

自用Java工具类

本工具类只是根据实际业务做的操作，可能与各位支付场景不同，可以根据api文档理解进行改造，以下仅供参考。

<dependency><groupId>com.stripe</groupId><artifactId>stripe-java</artifactId><version>${stripe.version}</version>
</dependency>

/*** stripe 支付工具类** @author zhouquan* @date 2021-01-26 13:44:00*/
@Component
public class StripePayUtils {private static final String key = "your key";/*** 创建初始用户* @param description 描述-用户编号* @return* @throws StripeException*/public String createStripeCustomNoCard(String description) throws StripeException {Stripe.apiKey = key;Map<String, Object> params = new HashMap<>();params.put( "description", description);Customer customer = Customer.create(params);return customer.getId();}/*** 更新用户绑定银行卡* @param stripeMemberId 客户stripeId* @param cardParam 银行卡参数* @return* @throws StripeException*/public String updateStripeCustomWithCard(String stripeMemberId, Map<String, Object> cardParam) throws StripeException {Stripe.apiKey = key;//创建银行卡Token，顺便借用stripe内部验证校验银行卡信息是否正确String cardTokenId = createCardToken(cardParam);Map<String, Object> retrieveParams = new HashMap<>();List<String> expandList = new ArrayList<>();expandList.add("sources");retrieveParams.put("expand", expandList);Customer customer = Customer.retrieve(stripeMemberId, retrieveParams,null);Map<String, Object> params = new HashMap<>();params.put("source", cardTokenId);Card card = (Card) customer.getSources().create(params);return card.getId();}/*** 修改默认支付银行卡* @param stripeMemberId 客户stripeId* @param stripeCardId 银行卡stripeId* @throws StripeException*/public void updateStripeDefaultCard(String stripeMemberId, String stripeCardId) throws StripeException {Stripe.apiKey = key;Map<String, Object> retrieveParams = new HashMap<>();List<String> expandList = new ArrayList<>();expandList.add("sources");retrieveParams.put("expand", expandList);Customer customer = Customer.retrieve(stripeMemberId, retrieveParams,null);Map<String, Object> params = new HashMap<>();params.put("default_source", stripeCardId);customer.update(params);}/*** 删除用户绑定银行卡* @param stripeMemberId 客户stripeId* @param cardId 银行卡stripeId* @return* @throws StripeException*/public void deleteCard(String stripeMemberId, String cardId) throws StripeException {Stripe.apiKey = key;Map<String, Object> retrieveParams = new HashMap<>();List<String> expandList = new ArrayList<>();expandList.add("sources");retrieveParams.put("expand", expandList);Customer customer = Customer.retrieve( stripeMemberId, retrieveParams, null );Card card = (Card) customer.getSources().retrieve(cardId);Card deletedCard = (Card) card.delete();}/*** 生成卡token(鉴定卡对不对)* @param cardParam  number 卡号  exp_month 有效期月份 exp_year 有效期年份  cvc 安全码* @return* @throws StripeException*/public String createCardToken(Map<String, Object> cardParam) throws StripeException {Stripe.apiKey = key;//生成卡片tokenMap<String, Object> params = new HashMap<>();params.put("card", cardParam);Token token = Token.create(params);return token.getId();}/*** 修改银行卡信息* @param stripeMemberId 客户stripeId* @param stripeCardId 银行卡stripeId* @param params 需要修改的参数* @throws StripeException*/public void updateCard(String stripeMemberId, String stripeCardId,Map<String, Object> params) throws StripeException {Stripe.apiKey = key;Map<String, Object> retrieveParams = new HashMap<>();List<String> expandList = new ArrayList<>();expandList.add("sources");retrieveParams.put("expand", expandList);Customer customer = Customer.retrieve(stripeMemberId, retrieveParams,null);Card card =  (Card) customer.getSources().retrieve(stripeCardId);card.update(params);}/*** 同步支付* @param stripeMemberId 客户stripeId* @param money 实际支付金额* @param moneyType 货币单位* @param description 订单描述* @return* @throws StripeException*/public boolean charge(String stripeMemberId, BigDecimal money, String moneyType, String description) throws StripeException {Stripe.apiKey = key;//发起支付Map<String, Object> payParams = new HashMap<>();//1元=100payParams.put("amount", money.multiply(new BigDecimal(100)).longValue());payParams.put("currency", moneyType);payParams.put("description", description);payParams.put("customer", stripeMemberId);payParams.put("capture", true);Charge charge = Charge.create(payParams);System.err.println(charge.toString());//charge  支付是同步通知if ("succeeded".equals(charge.getStatus())) {//交易成功后，需要更新我们的订单表，修改业务参数，此处省略return true;} else {return false;}}/*** 捕获stripe平台返回的错误状态码* @param code*/public void catchError(String code){switch (code){case "account_number_invalid"://银行卡号不正确throw new RRException(null, ErrorPromptEnum.BANK_STRIPE_account_number_invalid.getValue());case "balance_insufficient"://账户余额不足throw new RRException(null, ErrorPromptEnum.BANK_STRIPE_balance_insufficient.getValue());case "bank_account_declined"://所提供的银行帐户尚未通过验证或不受支持，因此无法用于收费throw new RRException(null, ErrorPromptEnum.BANK_STRIPE_bank_account_declined.getValue());case "bank_account_exists"://账户已存在throw new RRException(null, ErrorPromptEnum.BANK_STRIPE_bank_account_exists.getValue());case "bank_account_unusable"://提供的银行帐户不能用于付款。必须使用其他银行帐户。throw new RRException(null, ErrorPromptEnum.BANK_STRIPE_bank_account_unusable.getValue());case "expired_card"://卡已过期throw new RRException(null, ErrorPromptEnum.BANK_STRIPE_expired_card.getValue());case "incorrect_cvc"://卡的安全码不正确throw new RRException(null, ErrorPromptEnum.BANK_STRIPE_incorrect_cvc.getValue());case "incorrect_number"://卡号不正确throw new RRException(null, ErrorPromptEnum.BANK_STRIPE_incorrect_number.getValue());case "incorrect_zip"://卡的邮政编码不正确throw new RRException(null, ErrorPromptEnum.BANK_STRIPE_incorrect_zip.getValue());case "instant_payouts_unsupported"://此卡不支持即时付款throw new RRException(null, ErrorPromptEnum.BANK_STRIPE_instant_payouts_unsupported.getValue());case "invalid_cvc"://卡的安全码无效throw new RRException(null, ErrorPromptEnum.BANK_STRIPE_invalid_cvc.getValue());case "invalid_expiry_month"://卡的有效期限不正确throw new RRException(null, ErrorPromptEnum.BANK_STRIPE_invalid_expiry_month.getValue());case "invalid_expiry_year"://卡的有效期不正确throw new RRException(null, ErrorPromptEnum.BANK_STRIPE_invalid_expiry_year.getValue());case "invalid_number"://卡号无效throw new RRException(null, ErrorPromptEnum.BANK_STRIPE_invalid_number.getValue());default://系统异常throw new RRException(code, ErrorPromptEnum.BANK_STRIPE_error.getValue());}}
}

结尾

以上就是对stripeApi的一个初步探索，不是很全面，很多功能都没用到，要彻底摸透这个支付，任重而道远~~~

这篇关于Stripe 银行卡支付功能初步指南(Java)的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/729800。

相关文章

Java设计模式---迭代器模式(Iterator)解读

Java设计模式---迭代器模式(Iterator)解读

《Java设计模式---迭代器模式(Iterator)解读》：本文主要介绍Java设计模式---迭代器模式(Iterator),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,... 目录1、迭代器（Iterator）1.1、结构1.2、常用方法1.3、本质1、解耦集合与遍历逻辑2、统一
阅读更多...
Java内存分配与JVM参数详解(推荐)

Java内存分配与JVM参数详解(推荐)

《Java内存分配与JVM参数详解(推荐)》本文详解JVM内存结构与参数调整,涵盖堆分代、元空间、GC选择及优化策略,帮助开发者提升性能、避免内存泄漏,本文给大家介绍Java内存分配与JVM参数详解,... 目录引言JVM内存结构JVM参数概述堆内存分配年轻代与老年代调整堆内存大小调整年轻代与老年代比例元空
阅读更多...
深度解析Java DTO(最新推荐)

深度解析Java DTO(最新推荐)

《深度解析JavaDTO(最新推荐)》DTO（DataTransferObject）是一种用于在不同层（如Controller层、Service层）之间传输数据的对象设计模式,其核心目的是封装数据,... 目录一、什么是DTO？DTO的核心特点：二、为什么需要DTO？（对比Entity）三、实际应用场景解析
阅读更多...
Java 线程安全与 volatile与单例模式问题及解决方案

Java 线程安全与 volatile与单例模式问题及解决方案

《Java线程安全与volatile与单例模式问题及解决方案》文章主要讲解线程安全问题的五个成因（调度随机、变量修改、非原子操作、内存可见性、指令重排序）及解决方案,强调使用volatile关键字... 目录什么是线程安全线程安全问题的产生与解决方案线程的调度是随机的多个线程对同一个变量进行修改线程的修改操
阅读更多...
从原理到实战深入理解Java 断言assert

从原理到实战深入理解Java 断言assert

《从原理到实战深入理解Java断言assert》本文深入解析Java断言机制,涵盖语法、工作原理、启用方式及与异常的区别,推荐用于开发阶段的条件检查与状态验证,并强调生产环境应使用参数验证工具类替代... 目录深入理解 Java 断言（assert）：从原理到实战引言：为什么需要断言？一、断言基础1.1 语
阅读更多...
深度解析Java项目中包和包之间的联系

深度解析Java项目中包和包之间的联系

《深度解析Java项目中包和包之间的联系》文章浏览阅读850次，点赞13次，收藏8次。本文详细介绍了Java分层架构中的几个关键包：DTO、Controller、Service和Mapper。_jav... 目录前言一、各大包1.DTO1.1、DTO的核心用途1.2. DTO与实体类(Entity)的区别1
阅读更多...
Java中的雪花算法Snowflake解析与实践技巧

Java中的雪花算法Snowflake解析与实践技巧

《Java中的雪花算法Snowflake解析与实践技巧》本文解析了雪花算法的原理、Java实现及生产实践,涵盖ID结构、位运算技巧、时钟回拨处理、WorkerId分配等关键点,并探讨了百度UidGen... 目录一、雪花算法核心原理1.1 算法起源1.2 ID结构详解1.3 核心特性二、Java实现解析2.
阅读更多...
mysql表操作与查询功能详解

mysql表操作与查询功能详解

《mysql表操作与查询功能详解》本文系统讲解MySQL表操作与查询,涵盖创建、修改、复制表语法,基本查询结构及WHERE、GROUPBY等子句,本文结合实例代码给大家介绍的非常详细,感兴趣的朋友跟随... 目录01.表的操作1.1表操作概览1.2创建表1.3修改表1.4复制表02.基本查询操作2.1 SE
阅读更多...
SpringBoot整合liteflow的详细过程

SpringBoot整合liteflow的详细过程

《SpringBoot整合liteflow的详细过程》：本文主要介绍SpringBoot整合liteflow的详细过程,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋...  liteflow 是什么？ 能做什么？总之一句话：能帮你规范写代码逻辑 ，编排并解耦业务逻辑，代码
阅读更多...
JavaSE正则表达式用法总结大全

JavaSE正则表达式用法总结大全

《JavaSE正则表达式用法总结大全》正则表达式就是由一些特定的字符组成,代表的是一个规则,：本文主要介绍JavaSE正则表达式用法的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下... 目录常用的正则表达式匹配符正则表China编程达式常用的类Pattern类Matcher类PatternSynta
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2