接入指南
简介
DEMO 集成接入
Java 版接入说明
工程目录结构
运行环境
运行步骤
1.
2.
3.
4.
C++ 版接入说明
工程目录结构
运行环境
运行步骤
接口调用
地铁购票核销码发码
购票发码调用流程
示例代码
package com.java.sdk.demo;
import com.alipay.v3.ApiException;
import com.alipay.v3.ApiClient;
import com.alipay.v3.util.model.AlipayConfig;
import com.alipay.v3.Configuration;
import com.alipay.v3.api.AlipayCommerceCityfacilitatorVoucherApi;
import com.alipay.v3.model.*;
import java.io.File;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
public class AlipayCommerceCityfacilitatorVoucherApiGenerate {
public static void main(String[] args) throws ApiException {
ApiClient defaultClient = Configuration.getDefaultApiClient();
// 初始化alipay参数（全局设置一次）
AlipayConfig alipayConfig = new AlipayConfig();
alipayConfig.setServerUrl("https://openapi.alipay.com");
alipayConfig.setAppId("<-- 请填写您的AppId，例如：2019091767145019 -->");
alipayConfig.setPrivateKey("<-- 请填写您的应用私钥，例如：MIIEvQIBADANB ... ... -->");
alipayConfig.setAlipayPublicKey("<-- 请填写您的支付宝公钥，例如：MIIBIjANBg... -->");
defaultClient.setAlipayConfig(alipayConfig);
AlipayCommerceCityfacilitatorVoucherApi api = new AlipayCommerceCityfacilitatorVoucherApi();
AlipayCommerceCityfacilitatorVoucherGenerateModel data = new AlipayCommerceCityfacilitatorVoucherGenerateModel();
data.setSiteBegin("02490301");
data.setTicketPrice("5.00");
data.setCityCode("440300");
data.setTotalFee("10.00");
data.setSiteEnd("02490305");
data.setTicketNum("5");
data.setTicketType("oneway");
data.setTradeNo("2016031521001004390263523925");
try {
AlipayCommerceCityfacilitatorVoucherGenerateResponseModel response = api.generate(data);
} catch (ApiException e) {
AlipayCommerceCityfacilitatorVoucherGenerateDefaultResponse errorObject = (AlipayCommerceCityfacilitatorVoucherGenerateDefaultResponse) e.getErrorObject();
System.out.println("调用失败:" + errorObject);
}
}
}地铁购票发码退款
示例代码
package com.java.sdk.demo;
import com.alipay.v3.ApiException;
import com.alipay.v3.ApiClient;
import com.alipay.v3.util.model.AlipayConfig;
import com.alipay.v3.Configuration;
import com.alipay.v3.api.AlipayCommerceCityfacilitatorVoucherApi;
import com.alipay.v3.model.*;
import java.io.File;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
public class AlipayCommerceCityfacilitatorVoucherApiRefund {
public static void main(String[] args) throws ApiException {
ApiClient defaultClient = Configuration.getDefaultApiClient();
// 初始化alipay参数（全局设置一次）
AlipayConfig alipayConfig = new AlipayConfig();
alipayConfig.setServerUrl("https://openapi.alipay.com");
alipayConfig.setAppId("<-- 请填写您的AppId，例如：2019091767145019 -->");
alipayConfig.setPrivateKey("<-- 请填写您的应用私钥，例如：MIIEvQIBADANB ... ... -->");
alipayConfig.setAlipayPublicKey("<-- 请填写您的支付宝公钥，例如：MIIBIjANBg... -->");
defaultClient.setAlipayConfig(alipayConfig);
AlipayCommerceCityfacilitatorVoucherApi api = new AlipayCommerceCityfacilitatorVoucherApi();
AlipayCommerceCityfacilitatorVoucherRefundModel data = new AlipayCommerceCityfacilitatorVoucherRefundModel();
try {
Object response = api.refund(data);
} catch (ApiException e) {
AlipayCommerceCityfacilitatorVoucherRefundDefaultResponse errorObject = (AlipayCommerceCityfacilitatorVoucherRefundDefaultResponse) e.getErrorObject();
System.out.println("调用失败:" + errorObject);
}
}
}地铁购票站点数据查询
示例代码
package com.java.sdk.demo;
import com.alipay.v3.ApiException;
import com.alipay.v3.ApiClient;
import com.alipay.v3.util.model.AlipayConfig;
import com.alipay.v3.Configuration;
import com.alipay.v3.api.AlipayCommerceCityfacilitatorStationApi;
import com.alipay.v3.model.*;
import java.io.File;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
public class AlipayCommerceCityfacilitatorStationApiQuery {
public static void main(String[] args) throws ApiException {
ApiClient defaultClient = Configuration.getDefaultApiClient();
// 初始化alipay参数（全局设置一次）
AlipayConfig alipayConfig = new AlipayConfig();
alipayConfig.setServerUrl("https://openapi.alipay.com");
alipayConfig.setAppId("<-- 请填写您的AppId，例如：2019091767145019 -->");
alipayConfig.setPrivateKey("<-- 请填写您的应用私钥，例如：MIIEvQIBADANB ... ... -->");
alipayConfig.setAlipayPublicKey("<-- 请填写您的支付宝公钥，例如：MIIBIjANBg... -->");
defaultClient.setAlipayConfig(alipayConfig);
AlipayCommerceCityfacilitatorStationApi api = new AlipayCommerceCityfacilitatorStationApi();
String cityCode = "440300";
try {
AlipayCommerceCityfacilitatorStationQueryResponseModel response = api.query(cityCode);
} catch (ApiException e) {
AlipayCommerceCityfacilitatorStationQueryDefaultResponse errorObject = (AlipayCommerceCityfacilitatorStationQueryDefaultResponse) e.getErrorObject();
System.out.println("调用失败:" + errorObject);
}
}
}地铁购票订单批量查询
示例代码
package com.java.sdk.demo;
import com.alipay.v3.ApiException;
import com.alipay.v3.ApiClient;
import com.alipay.v3.util.model.AlipayConfig;
import com.alipay.v3.Configuration;
import com.alipay.v3.api.AlipayCommerceCityfacilitatorVoucherApi;
import com.alipay.v3.model.*;
import java.io.File;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
public class AlipayCommerceCityfacilitatorVoucherApiBatchquery {
public static void main(String[] args) throws ApiException {
ApiClient defaultClient = Configuration.getDefaultApiClient();
// 初始化alipay参数（全局设置一次）
AlipayConfig alipayConfig = new AlipayConfig();
alipayConfig.setServerUrl("https://openapi.alipay.com");
alipayConfig.setAppId("<-- 请填写您的AppId，例如：2019091767145019 -->");
alipayConfig.setPrivateKey("<-- 请填写您的应用私钥，例如：MIIEvQIBADANB ... ... -->");
alipayConfig.setAlipayPublicKey("<-- 请填写您的支付宝公钥，例如：MIIBIjANBg... -->");
defaultClient.setAlipayConfig(alipayConfig);
AlipayCommerceCityfacilitatorVoucherApi api = new AlipayCommerceCityfacilitatorVoucherApi();
AlipayCommerceCityfacilitatorVoucherBatchqueryModel data = new AlipayCommerceCityfacilitatorVoucherBatchqueryModel();
data.setCityCode("440300");
List<String> tradeNos = new ArrayList<String>();
tradeNos.add("0123456789");
data.setTradeNos(tradeNos);
try {
AlipayCommerceCityfacilitatorVoucherBatchqueryResponseModel response = api.batchquery(data);
} catch (ApiException e) {
AlipayCommerceCityfacilitatorVoucherBatchqueryDefaultResponse errorObject = (AlipayCommerceCityfacilitatorVoucherBatchqueryDefaultResponse) e.getErrorObject();
System.out.println("调用失败:" + errorObject);
}
}
}接口调用结果处理
示例代码
AlipayCommerceCityfacilitatorVoucherGenerateResponse response = alipayClient.execute(request);
System.out.println(response.getCode());//获取结果码
System.out.println(response.getSubCode());//获取子错误码
System.out.println(response.getMsg());//获取子错误描述
System.out.println(response.getBody());//获取返回报文结果码说明
| 同步返回结果码 | 含义 | 说明 |
|---|---|---|
| 10000 | 业务处理成功 | - |
| 40001～40006 | 业务处理失败 | 具体失败原因请参考 公共错误码。其它请参考API文档。 |
| 20000 | 业务出现未知错误或者系统异常 | 业务出现未知错误或者系统异常（请一定要在确定本次调用结果后，再 发起重试），若有结果接口的，需调用查询接口发起查询。 |