第一步：创建应用并获取APPID

要在您的应用中使用支付宝开放产品的接口能力，您需要先去蚂蚁金服开放平台（open.alipay.com），在开发者中心中创建登记您的应用，并提交审核，审核通过后会为您生成应用唯一标识（APPID），并且可以申请开通开放产品使用权限，通过APPID您的应用才能调用开放产品的接口能力。需要详细了解开放平台创建应用步骤请参考《开放平台应用创建指南》。

第二步：配置密钥

开发者调用接口前需要先生成RSA密钥，RSA密钥包含应用私钥(APP_PRIVATE_KEY)、应用公钥(APP_PUBLIC_KEY）。生成密钥后在开放平台开发者中心进行密钥配置，配置完成后可以获取支付宝公钥(ALIPAY_PUBLIC_KEY)。详细步骤请参考《配置应用环境》。

第三步：搭建和配置开发环境

1.下载服务端SDK

为了帮助开发者调用开放接口，我们提供了开放平台服务端SDK，包含JAVA、PHP和.NET三个语言版本，封装了签名&验签、HTTP接口请求等基础功能。请先下载对应语言版本的SDK并引入您的开发工程。

各语言版本服务端SDK详细使用说明，请参考《服务端SDK使用说明》

2.接口调用配置

在SDK调用前需要进行初始化，代码如下：

AlipayClient alipayClient = new DefaultAlipayClient(URL, APP_ID, APP_PRIVATE_KEY, FORMAT, CHARSET, ALIPAY_PUBLIC_KEY, SIGN_TYPE);

关键参数说明:

第四步：接口调用

接口调用流程

1、商户系统构建报关请求信息，调用支付宝统一收单报关接口alipay.trade.customs.declare，支付宝对请求参数进行校验，校验成功后受理报关请求，返回支付宝报关流水号。

2、支付宝异步请求海关系统做支付单报关。

3、商户系统可以通过调用支付宝报关信息查询接口alipay.trade.customs.query

 SDK接入

1、统一收单报关接口（alipay.trade.customs.declare）

//新建调用示例
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");

//新建请求对象
AlipayTradeCustomsDeclareRequest request = new AlipayTradeCustomsDeclareRequest();
//初始化请求
request.setBizContent("{" +
"\"out_request_no\":\"9193457120563834\"," +
"\"trade_no\":\"2015051446800462\"," +
"\"merchant_customs_code\":\"737203458\"," +
"\"merchant_customs_name\":\"龙腾国际贸易有限公司\"," +
"\"amount\":\"2\"," +
"\"customs_place\":\"HANGZHOU\"," +
"\"is_split\":\"T\"," +
"\"sub_out_biz_no\":\"2015080811223212345453\"," +
"\"buyer_info\":{" +
"\"buyer_name\":\"王一\"," +
"\"buyer_cert_no\":\"230227198707201827\"" +
"    }" +
"  }");

//调用
AlipayTradeCustomsDeclareResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

2、查询报关详细信息 （alipay.trade.customs.query）

//新建调用实例
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");

//新建请求对象
AlipayTradeCustomsQueryRequest request = new AlipayTradeCustomsQueryRequest();
//初始化请求
request.setBizContent("{" +
"\"out_request_nos\":\"201506010001,201506010002,201506010003\"" +
"  }");

//调用
AlipayTradeCustomsQueryResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");}

关于沙箱

如何接入沙箱

海关报关接入注意点

FAQ