全球支付-空中云汇（airwallex）

最新推荐文章于 2025-03-12 22:37:20 发布
最新推荐文章于 2025-03-12 22:37:20 发布
阅读量1.5k 收藏 16
点赞数 13
分类专栏： 支付 文章标签： java 后端 支付
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_47752736/article/details/144234882
版权

本文主要以前后端分离下单为内容对airwallex进行介绍

空中云汇api地址

https://www.airwallex.com/docs/api
在这里插入图片描述

在这里插入图片描述

接口解析

接口名称接口解析
商户token认证/api/v1/authentication/login根据 x-api-key 以及x-client-id 获取后续请求使用的商户token
获取支付方式/api/v1/pa/config/payment_method_types根据token，获取当前商户支持的支付方法
获取银行logo/api/v1/pa/config/banks获取银行logo
创建支付用户/api/v1/pa/customers/create这个用户是你要做的系统和空中云汇做一个关联，后续绑定银行卡等信息都会用到
获取支付用户临时token/api/v1/pa/customers/{id}/generate_client_secret后续下单后确认支付等需要支付用户的token
获取全部同意书/api/v1/pa/payment_consents支付同意书里包含支付方式以及绑定的银行卡信息
删除同意书/api/v1/pa/payment_consents/{id}/disable删除之前的同意书，删除之前绑定的银行卡信息
支付下单/api/v1/pa/payment_intents/create拉起后端支付，返回前端支付信息
查询支付/api/v1/pa/payment_intents/{id}查询支付信息
确认支付/api/v1/pa/payment_intents/{id}/confirm一般这个接口是需要购买native api才能提供，这个接口可以代替前端拉起支付接口
取消支付/api/v1/pa/payment_intents/{id}/cancel取消支付
发起退款/api/v1/pa/refunds/create根据之前下单接口发起退款
查询退款/api/v1/pa/refunds/{id}查询退款
查询所有退款/api/v1/pa/refunds查询所有退款

获取配置信息

1、登录空中云汇

地址
https://www.airwallex.com/app/login?region=cn
在这里插入图片描述

2、在账户-开发者中找到配置的API秘钥，获取到 CLIENT ID 以及 API 密钥 ，这两个信息可以token登录接口中使用

在这里插入图片描述
例如：

## 请求
curl --request POST \
--url 'https://api-demo.airwallex.com/api/v1/authentication/login' \
--header 'Content-Type: application/json' \
--header 'x-api-key: 72c0a50d840626050145ccf72b733e32f31bb21323d493f9d00290b37676a138bcdf1d6415d9f08aad117450e23a4f4f' \
--header 'x-client-id: 5f1vUssbSnq45temBX6CnB'

## 响应
{
  "expires_at": "2021-10-26T06:38:13+0000",
  "token": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0b20iLCJyb2xlcyI6WyJ1c2VyIl0sImlhdCI6MTQ4ODQxNTI1NywiZXhwIjoxNDg4NDE1MjY3fQ.UHqau03y5kEk5lFbTp7J4a-U6LXsfxIVNEsux85hj-Q"
}

3、配置webhook

根据自己情况配置需要的事件，建议至少将 交易订单 的 已取消 和 已成功 勾选
（1）按照空中云汇文档信息提示，webhook可以配置两个，而且必须要是 https 格式请求
（2）空中云汇webhook对请求响应时间有要求，业务逻辑最好是异步执行，先给返回响应状态
（3）webhook发送失败后间隔 5分钟，1小时，4小时，8小时，12小时，12小时 共重发6次，发送成功则终止重发
在这里插入图片描述

在Java中集成空中云汇并拉起支付，仅供参考，根据自己业务实际来进行

1、封装springboot 对象缓存类

@Component
public class ContextHolder implements ApplicationContextAware{
	
	private static ApplicationContext applicationContext = null;
	
	@Override
	public void setApplicationContext(ApplicationContext arg0) throws BeansException {
		if(ContextHolder.applicationContext == null){
			ContextHolder.applicationContext  = arg0;
	    }
		System.out.println("========ApplicationContext配置成功,ContextHolder.getAppContext()获取applicationContext对象,applicationContext="+ ContextHolder.applicationContext+"========");
	}
	
	//获取applicationContext
    public static ApplicationContext getApplicationContext() {
       return applicationContext;
    }
    //通过name获取 Bean.
    public static Object getBean(String name){
       return getApplicationContext().getBean(name);
    }
    //通过class获取Bean.
    public static <T> T getBean(Class<T> clazz){
       return getApplicationContext().getBean(clazz);
    }
    //通过name,以及Clazz返回指定的Bean
    public static <T> T getBean(String name,Class<T> clazz){
       return getApplicationContext().getBean(name, clazz);
    }

}

2、创建网络请求工具

public class HttpClientUtil {
    protected static Logger logger = LoggerFactory.getLogger(HttpClientUtil.class);


	/**
     * 空中云汇支付请求
     * @param url 请求url
     * @param obj 请求body
     * @param operatorId 商户id
     * @return
     * @throws Exception
     */
    public static String sendAirwallexHttpPost(String url, Object obj,String operatorId) throws Exception {
        HttpPost post = new HttpPost(url);
        RequestConfig requestConfig = RequestConfig.custom()
                .setConnectTimeout(30000).setConnectionRequestTimeout(30000)
                .setSocketTimeout(30000).build();
        post.setConfig(requestConfig);
        post.addHeader("Content-Type", "application/json;charset=UTF-8");
        post.setHeader("Accept", "application/json");
        if (StringUtils.isNotBlank(operatorId)) {
            AirwallexPaySourceServiceImpl paySourceService = ContextHolder.getBean(AirwallexPaySourceServiceImpl.class);
            String airwallexToken = paySourceService.getAirwallexToken(operatorId);
            post.setHeader("Authorization",airwallexToken);
        }
        CloseableHttpAsyncClient httpClient = null;
        try {
            String json = GsonUtil.toJson(obj);
            logger.info("sendAirwallexHttpPost before operatorId :{} url :{}  body :{}",operatorId,url,json);
            StringEntity entity = new StringEntity(json,"UTF-8");//解决中文乱码问题
            entity.setContentEncoding("UTF-8");
            entity.setContentType("application/json");
            post.setEntity(entity);
            SSLContext ctx = SSLContext.getInstance("TLS");
            X509TrustManager tm = new X509TrustManager() {
                public void checkClientTrusted(X509Certificate[] xcs, String string) {
                }
                public void checkServerTrusted(X509Certificate[] xcs, String string) {
                }
                public X509Certificate[] getAcceptedIssuers() {
                    return null;
                }
            };
            ctx.init(null, new TrustManager[] { tm }, null);

            SSLIOSessionStrategy sslSessionStrategy = new SSLIOSessionStrategy(ctx, new String[] { "TLSv1","TLSv1.1","TLSv1.2" }, null,
                    SSLIOSessionStrategy.getDefaultHostnameVerifier());

            httpClient = HttpAsyncClients.custom().setSSLStrategy(sslSessionStrategy).build();
            httpClient.start();
            Future<HttpResponse> future = httpClient.execute(post, null);
            HttpResponse response = future.get();

            StringBuffer sb = new StringBuffer();
            BufferedReader rd = new BufferedReader(new InputStreamReader(response.getEntity().getContent(),"UTF-8"));
            String line;
            while ((line = rd.readLine()) != null) {
                sb.append(line);
            }
            String body = sb.toString();
            logger.info("sendAirwallexHttpPost after operatorId :{} url :{}  response :{}",operatorId,url,body);
            return body;
        } catch (Exception e) {
            logger.error(e.getMessage(),e.getStackTrace());
            throw e;
        } finally {
            if (httpClient != null) {
                try {
                    httpClient.close();
                } catch (IOException e) {
                    logger.error(e.getMessage());
                }
            }
        }
    }
	 /**
     * 空中云汇支付请求
     * @param url 请求url
     * @param obj 请求body
     * @param operatorId 商户id
     * @return
     * @throws Exception
     */
    public static String sendAirwallexHttpPostLogin(String url,Map<String,String> header) throws Exception {
        HttpPost post = new HttpPost(url);
        RequestConfig requestConfig = RequestConfig.custom()
                .setConnectTimeout(30000).setConnectionRequestTimeout(30000)
                .setSocketTimeout(30000).build();
        post.setConfig(requestConfig);
        post.addHeader("Content-Type", "application/json;charset=UTF-8");
        post.setHeader("Accept", "application/json");
        if (!CollectionUtils.isEmpty(header)) {
            for (Entry<String, String> stringStringEntry : header.entrySet()) {
                post.setHeader(stringStringEntry.getKey(), stringStringEntry.getValue());
            }
        }
        CloseableHttpAsyncClient httpClient = null;
        try {
            SSLContext ctx = SSLContext.getInstance("TLS");
            X509TrustManager tm = new X509TrustManager() {
                public void checkClientTrusted(X509Certificate[] xcs, String string) {
                }
                public void checkServerTrusted(X509Certificate[] xcs, String string) {
                }
                public X509Certificate[] getAcceptedIssuers() {
                    return null;
                }
            };
            ctx.init(null, new TrustManager[] { tm }, null);


            SSLIOSessionStrategy sslSessionStrategy = new SSLIOSessionStrategy(ctx, new String[] { "TLSv1","TLSv1.1","TLSv1.2" }, null,
                    SSLIOSessionStrategy.getDefaultHostnameVerifier());

            httpClient = HttpAsyncClients.custom().setSSLStrategy(sslSessionStrategy).build();
            httpClient.start();
            Future<HttpResponse> future = httpClient.execute(post, null);
            HttpResponse response = future.get();

            StringBuffer sb = new StringBuffer();
            BufferedReader rd = new BufferedReader(new InputStreamReader(response.getEntity().getContent(),"UTF-8"));
            String line;
            while ((line = rd.readLine()) != null) {
                sb.append(line);
            }
            String body = sb.toString();
            logger.info("sendAirwallexHttpPostLogin  url :{}  header :{}",url,GsonUtil.toJson(header));
            return body;
        } catch (Exception e) {
            logger.error(e.getMessage(),e.getStackTrace());
            throw e;
        } finally {
            if (httpClient != null) {
                try {
                    httpClient.close();
                } catch (IOException e) {
                    logger.error(e.getMessage());
                }
            }
        }
    }

   
    /**
     * 空中云汇支付请求
     * 发送信息到服务端 GET方式
     * @param url
     * @return
     * @throws Exception
     */
    public static String sendAirwallexHttpGet(String url,String operatorId) throws Exception {
        logger.info("sendAirwallexHttpGet before operatorId :{} url :{}  ",operatorId,url);
        HttpGet httpGet = new HttpGet(url);
        RequestConfig requestConfig = RequestConfig.custom()
                .setConnectTimeout(30000).setConnectionRequestTimeout(30000)
                .setSocketTimeout(30000).build();
        httpGet.setConfig(requestConfig);
        httpGet.addHeader("Content-Type", "application/json;charset=UTF-8");
        httpGet.setHeader("Accept", "application/json");
        if (StringUtils.isNotBlank(operatorId)) {
            AirwallexPaySourceServiceImpl paySourceService = ContextHolder.getBean(AirwallexPaySourceServiceImpl.class);
            String airwallexToken = paySourceService.getAirwallexToken(operatorId);
            httpGet.setHeader("Authorization",airwallexToken);
        }
        CloseableHttpAsyncClient httpClient = null;
        try {
            SSLContext ctx = SSLContext.getInstance("TLS");
            X509TrustManager tm = new X509TrustManager() {
                public void checkClientTrusted(X509Certificate[] xcs, String string) {
                }
                public void checkServerTrusted(X509Certificate[] xcs, String string) {
                }
                public X509Certificate[] getAcceptedIssuers() {
                    return null;
                }
            };
            ctx.init(null, new TrustManager[] { tm }, null);

            SSLIOSessionStrategy sslSessionStrategy = new SSLIOSessionStrategy(ctx, new String[] { "TLSv1","TLSv1.1","TLSv1.2" }, null,
                    SSLIOSessionStrategy.getDefaultHostnameVerifier());

            httpClient = HttpAsyncClients.custom().setSSLStrategy(sslSessionStrategy).build();
            httpClient.start();
            Future<HttpResponse> future = httpClient.execute(httpGet, null);
            HttpResponse response = future.get();

            StringBuffer sb = new StringBuffer();
            BufferedReader rd = new BufferedReader(new InputStreamReader(response.getEntity().getContent(),"UTF-8"));
            String line;
            while ((line = rd.readLine()) != null) {
                sb.append(line);
            }
            String body = sb.toString();
            logger.info("sendAirwallexHttpGet after operatorId :{} response :{}  ",operatorId,body);
            return body;
        } catch (Exception e) {
            logger.error(e.getMessage(),e.getStackTrace());
            throw e;
        } finally {
            if (httpClient != null) {
                try {
                    httpClient.close();
                } catch (IOException e) {
                    logger.error(e.getMessage());
                }
            }
        }
    }
    
}

3、 拉起各个接口请求，以下接口简写，请根据自己实际情况进行调整

（1）使用商户的 CLIENT ID 和 API 密钥 获取token

	public String getAirwallexToken(String operatorId) {
		//从redis中获取token ，token默认设置有效期20分钟过期
        String token = redisTemplate.opsForValue()....省略;
        if (StringUtils.isNotBlank(token)) {
            return token;
        }
        
        String clientId = "";
        String apiKey = "";
        Map<String,String> headerMap = new HashMap<>();
        headerMap.put("x-client-id",clientId);
        headerMap.put("x-api-key",apiKey);
        String result = null;
        try {
            //获取token信息
            result = HttpClientUtil.sendAirwallexHttpPostLogin(String.format("%s%s", "https://api-demo.airwallex.com", "/api/v1/authentication/login"), headerMap);
        }catch (Exception e) {
            log.error("sendAirwallexHttpPost getToken error : "+operatorId+e.getMessage(),e);
        }
        if (StringUtils.isNotBlank(result)) {
            //省略。。。。。
            //加入到redis中，过期时间20分钟
            
        }
        return token;
    }

(2) 创建用户

		Map<String,Object> params = new HashMap<>();
        params.put("request_id",request_id);
        params.put("merchant_customer_id",merchant_customer_id);
        params.put("first_name",first_name);
        params.put("last_name",last_name);
        params.put("email",email);

        String result = null;
        try {
            result = HttpClientUtil.sendAirwallexHttpPost(String.format("%s%s", "https://api-demo.airwallex.com", "/api/v1/pa/customers/create"), params,operatorId);
        }catch (Exception e) {
            log.error("sendAirwallexHttpPost error : "+operatorId+e.getMessage(),e);
        }

（3）下单支付接口

		Map<String,Object> params = new HashMap<>();
        params.put("request_id",request_id);
        params.put("merchant_order_id",merchant_order_id);
        params.put("amount",amount);
        params.put("currency",currency);

        params.put("customer_id",customer_id);

        //构建额外配置参数
        Map<String,Object> metadata = new HashMap<>();
        metadata.put("accountId",accountId);
        params.put("metadata",metadata);

        String result = null;
        try {
            result = HttpClientUtil.sendAirwallexHttpPost(String.format("%s%s", "https://api-demo.airwallex.com", "/api/v1/pa/payment_intents/create"), params,operatorId);
        }catch (Exception e) {
            log.error("sendAirwallexHttpPost error : "+operatorId+e.getMessage(),e);
        }

前端拉起空中云汇支付

在这里插入图片描述

参考网址
https://www.airwallex.com/docs/payments__embedded-elements

在这里插入图片描述
git地址
https://github.com/airwallex/airwallex-payment-demo/tree/master/docs
在这里插入图片描述

【支付】Java对接Airwallex(空中云汇)实现单次扣费、循环扣费
藏进风里的博客
11-11 1810
java实现AIrwallex的单次扣费和循环扣费
airwallex（空中云汇）支付
weixin_42097973的博客
06-29 1581
【代码】airwallex（空中云汇）支付。
【PitchBook-2024研报】PitchBook年第四季度探索亚太地区的金融科技之路：第一部分：日本（英）.pdf
11-14
行业研究报告、行业调查报告、研报
Airwallex 支付配置
api工厂
09-27 1898
调用airwallex支付，需要以下4个信息： client_id api_key currency webhook_secret 开通账号 Airwallex(空中云汇)-跨境支付新标准 安全便捷收全球 官方，申请开通，如果需要开通小程序支付功能，需要联系他们的技术为你绑定 appID，授权以后，你的小程序即可接入 airwallex 支付。 获取密钥信息 通过上图位置，获取 client_id 和 api_key 信息 currency 为支付的货币代码...
前端快速接入Airwallex托管支付
最新发布
2503_90882539的博客
03-12 341
前端集成 Airwallex 支付解决方案指南—通过支付托管页面 Hosted Payment Page 方式接入空中云汇。
uniapp 对接 AirWallex 第三方支付
weixin_59685936的博客
04-18 1053
uniapp 对接 AirWallex 第三方支付
空中云汇 (Airwallex) 钱包支付
lx_xing的博客
10-07 1365
Airwallex将通过webhook API异步通知您付款结果。请参考 webhook 文档来相应地设置您的 webhook。虽然订阅不同的活动是可选的，但建议至少订阅“payment_intent.successed”，这表明购物者已成功通过AlipayHK支付订单。当购物者在桌面浏览器选择使用AlipayHK付款时，调用以下API端点以获取电子钱包收银员URL，您可以将该URL重定向到AlipayHK收银员以完成付款。响应：呈现将购物者重定向到支付宝收银员的价值。等待Airwallex的通知。
airwallex-payment-android:Airwallex Android SDK
03-08
Airwallex Android SDK EN | 该库可让您轻松快捷地在Android应用中构建出色的付款体验。 Airwallex的Android SDK可用于大于等于19的Android SDK。 安装 将依赖项添加到build.gradle 。 dependencies { implementation ' com.airwallex:airwallex-core:2.0.3 ' } 入门指南 在您的Android应用中集成Airwallex Android SDK的以及。 回馈 感谢您抽出宝贵的时间试用我们的示例代码，并欢迎您提供反馈。 以下是几种联系方式： 对于一般适用的问题和反馈，请在此存储库中创建一个问题。 在集成的任何阶段提供个人支持 变更日志 此项目的所有显着更改将记录在。
Apache APISIX 在 Airwallex 的应用 | 专访 Airwallex 技术平台负责人李杨
ApacheAPISIX的博客
08-18 634
本周六(8.21)，Apache APISIX Meetup 上海站 正式开始啦！今天，我们为大家带来了本次参会嘉宾 Airwallex 技术平台负责人李杨的专访，来听听空中云汇与 Apache APISIX 之间的故事。文章末尾附有本次 Meetup 上海站的参与方式，感兴趣的小伙伴千万不要错过！ Q：请简单介绍一下自己和目前从事的工作 李杨： 李杨（Jan Li），哲学博士，Apache APISIX Committer，Airwallex（空中云汇）Technical Platform Lead，负责
Airwallex空中云汇：2024年B2B外贸企业出海白皮书.pdf
12-23
空中云汇作为全球支付及金融平台，通过提供高效的跨境支付解决方案，帮助外贸企业降低运营成本，提升经营效率，增强合规性，从而增强了企业国际贸易竞争力。报告通过综合运用定量与定性研究方法，为企业出海战略和跨...
"Airwallex空中云汇：2022年嵌入式金融全球化SaaS平台新机遇
该报告基于支付咨询公司Edgar, Dunn的数据，详细分析了Airwallex空中云汇在全球范围内的发展趋势和未来机遇。 报告指出，在全球金融科技行业的发展中，嵌入式金融全球化SaaS平台及线上交易平台正迎来新的机遇。...
全球宠物市场白皮书.pdf
07-30
【全球宠物市场白皮书】揭示了宠物行业在全球范围内的快速...同时，金融科技如Airwallex空中云汇提供的支付解决方案，对于简化跨境支付流程、降低成本、提高效率起到了关键作用，有助于宠物企业更好地开拓海外市场。
PayPal支付配置
api工厂
11-16 1477
调用airwallex支付，需要以下4个信息： clientId clientSecret webhookId currency ​ 开通账号 https://www.paypal.com/ ​ 开通注册好你自己的 paypal 账号，然后进入开发者平台创建应用： https://developer.paypal.com/developer/applications/ ​ 创建好应用以后，即可查看到应用到 clientId 和 clientSecret 同时必须在账号设置中设置允许 checkout 方
wodpress独立站 Airwallex空中云汇 AB跳转支付插件详解 多账户轮询
ppcardpay的博客
12-30 1002
跨境独立站 Airwallex空中云汇 AB跳转支付插件介绍与下载 演示多账户轮询
PayPal开放其全球支付平台
iSmart -- 艾思
01-07 876
PayPal宣布已经开放了其全球支付平台PayPal X，并推出了新的应用程序接口（API）和新的开发者入口（developer portal），以帮助开发者享用在PayPal X平台上建立业务的财务益处。此外，PayPal还将在2010年上半年发售一套移动软件开发工具包（其最初将支持iPhone）。新的API功能包括货币转换功能、面向用银行帐户汇款的Pay Anyone功能和Pre-ap
海外国外支付渠道接口对接
网站开发专家
01-17 2867
最近很多人问我，这方面的支付接口的事情，越南支付，日本支付，印度支付，马来西亚支付，泰国支付等，所以我整理一些，这些支付接口的相关信息。 因为本人专业做海外支付的，所以，对这块比较了解，曾经做个那些海外支付 ，也积累了很多海外客户案例。 目前支付大概有几种，代付，直接支付，一般情况主要接入当地的支付方式，类似国内的支付宝，微信那些的，基本都差不多的。 如果有什么这方面的问题，可以加我扣扣，8582-36016 ...
八种互联网上常见的在线支付接口
u011553255的专栏
09-26 8052
目前互联网上在线支付接口种类很多，不过常见在线支付接口就这几种: 1、支付宝支付接口集成；支付宝支付接口集成是指支付宝支付平台接口程序与 你的商务网站无缝整合，从而让你的网站立即拥有在线收款的功能。根据你的网 站脚本和结构加以整合，经编程到调试成功。 2、财付通支付接口集成；财付通支付接口集成是指财付通支付平台接口程序与你 的商务网站无缝整合，从而让你的网站立即拥有在线收款的
8种互联网在线支付接口
YiRong
05-16 4861
作者：凤凰网  符星晨 2010-8-4 13:38:19【我要评论】 大中小 摘要：将信息化元素引入医院，可以让病人得到更好的治疗，也能让医护人员的工作效率有质的提升。 本文关键字： 信息化 医院IT 尽管挂号依然需要排长队，但患者李琳还是感觉入院后的流程比以前快了。虽然相对于普通企业，医院的运营管理水平还“很低”，但这同时意味着商机：将信息化元素引入医院，可以让
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值