开发工具包（SDK）下载

API 集成工具集

API 集成工具集一览表

API Explorer

沙箱测试服务

沙箱环境

快速接入

支持的产品范围

约束限制说明

环境升级说明

常见问题

接入及调试

支付宝开放平台密钥工具

蚂蚁设计平台

云排查

通用工具 > API 集成工具集 > 沙箱环境 > 快速接入

快速接入

更新时间：2023-10-20 09:33:26

简介

沙箱环境是支付宝开放平台为开发者提供的安全低门槛的测试环境，开发者在沙箱环境中调用接口无需具备所需的商业资质，无需绑定和开通产品，同时不会对生产环境中的数据造成任何影响。

合理使用沙箱环境，可以让研发流程与商业流程并行，降低联调资损风险，加速项目的交付。

前提条件

操作步骤

前端开发过程使用沙箱

后端开发过程使用沙箱

步骤一：获取应用配置和支付宝网关信息

从 支付宝开放平台 进入沙箱控制台。

选择需要调试的应用，获取应用配置信息，包括：APPID、应用私钥、支付宝公钥、支付宝网关信息。

说明：点击公钥模式里面的查看，可以快速拷贝应用私钥和支付宝公钥。

步骤二：获取产品接入指南

以接入 JSAPI支付 为例，在沙箱控制台应用信息下的产品列表，找到 JSAPI支付，点击 查看文档。

参考调试文档中的示例进行代码开发。

步骤三：开发代码发起调用

参考如下示例代码，调用接口 alipay.trade.create 创建交易单。

String APP_ID = "线上应用同步到沙箱后的APPID，该APPID跟线上应用一致";
String APP_PRIVATE_KEY = "沙箱分配的默认应用私钥";
String ALIPAY_PUBLIC_KEY = "沙箱分配的默认支付宝公钥";
String BUYER_ID = "建议使用开发平台默认分配的沙箱账号下面的买家信息";
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi-sandbox.dl.alipaydev.com/gateway.do",APP_ID,APP_PRIVATE_KEY,"json","GBK",ALIPAY_PUBLIC_KEY,"RSA2");
AlipayTradeCreateRequest request = new AlipayTradeCreateRequest();
request.setNotifyUrl("");
JSONObject bizContent = new JSONObject();
bizContent.put("out_trade_no", "20210817010101003X02");
bizContent.put("total_amount", 0.01);
bizContent.put("subject", "测试商品");
bizContent.put("buyer_id", BUYER_ID);
bizContent.put("timeout_express", "10m");
bizContent.put("product_code", "JSAPI_PAY");
request.setBizContent(bizContent.toString());
AlipayTradeCreateResponse response = alipayClient.execute(request);
if(response.isSuccess()){
    System.out.println("调用成功");
} else {
    System.out.println("调用失败");
}

云调用使用沙箱

步骤一：学习云开发，创建云环境

说明：请务必完成云开发中文档快速入门、云调用、 IDE使用中的使用和学习。

进入小程序云环境管理，点击 新建环境，完成云环境的创建。

步骤二：打开沙箱云调用开关，开发支持云调用的云函数

进入 环境管理 > 云调用，打开 沙箱云调用能力开关。

说明：

新建云函数。例如调用沙箱环境的 alipay.trade.create 接口，注意配置 sandbox:true 标记。

index.js 示例代码

const cloud = require('@alipay/faas-server-sdk');
cloud.init();
exports.main = async (event, context) => {
  const res = await cloud
  .openapi({ sandbox:true }) // 当存在{ sandbox:true }标记时，表示该openapi接口调用沙箱环境
  .alipayTradeCreate.request({
    biz_content: {
      out_trade_no: '20210817010101003X23', // 订单外部交易号，关联商家系统的订单号
      total_amount: 0.01,
      subject: '沙箱测试商品',
      buyer_id: '2088622997162666',  // 付钱的用户id，请使用沙箱环境默认分配给你的买家UID
      product_code: 'JSAPI_PAY',
    },
  });
  console.log('云调用沙箱结果:', res);
  return {
    res,
    nodeVersion: process.version,
    runtimeVersion: process.env['runtime-version']
  }
};

package.json 示例代码

{
  "name": "testOpenAPI",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts":
  {},
  "author": "",
  "license": "ISC",
  "dependencies":
  {
    "@alipay/faas-server-sdk": "1.1.13-alpha.1"
  }
}

发布接口，并点击测试，发起接口调用。

步骤三：IDE 关联云环境，调用云函数

后续操作

应用开发配置

配置证书模式

AlipayConfig config = new AlipayConfig();
config.setServerUrl("https://openapi-sandbox.dl.alipaydev.com/gateway.do");
config.setAppId("发起调用的应用的APPID，例如：2021xxx");
config.setPrivateKey("应用私钥信息");
config.setAlipayPublicCertPath("支付宝公钥证书本地地址，例如：/Users/xx/Downloads/alipayPublicCert.crt");
config.setAppCertPath("应用公钥证书本地地址，例如：/Users/xx/Downloads/appPublicCert.crt");
config.setRootCertPath("支付宝根证书本地地址，例如：/Users/xx/Downloads/alipayRootCert.crt");
config.setCharset("UTF8");
config.setSignType("RSA2");
AlipayClient alipayClient = new DefaultAlipayClient(config);
String alipayUserId = "被查询的用户支付宝UID，例如：2088xx"
AlipayFundAccountQueryRequest request = new AlipayFundAccountQueryRequest();
AlipayFundAccountQueryModel model = new AlipayFundAccountQueryModel();
model.setAlipayUserId(alipayUserId);
model.setAccountType("ACCTRANS_ACCOUNT");
request.setBizModel(model);
AlipayFundAccountQueryResponse response = alipayClient.certificateExecute(request);
if (response.isSuccess()) {
    System.out.println("调用成功");
} else {
    System.out.println("调用失败");
}