# Develop in the sandbox

> In the sandbox environment, you can call and debug APIs, as well as develop and test your integrations with Alipay+.

> **Note**: Since the sandbox is an emulated environment, all tests in the sandbox do not take effect in the production environment. All returned codes and processing logic need to be consistent with those in the production environment.

## Step 1: Receive sandbox resources

After the application is created, sandbox resources are automatically allocated to you. On the **Sandbox** > **Settings** page, check your sandbox resources, which include the following two parts:

> **Note**: All the values here are applicable to the sandbox only.

-   **Integration Information**: contains key information for sandbox test, such as:

-   **Gateway Endpoint**: indicates the domain name that is assigned by Alipay+ to construct the API request URL. For more information, see the [Request URL](../api_acq/api_overview.md#TFGaA) section in _API Reference_.
-   **Client ID**: used to specify the _Client-Id_ parameter in the API request header. For more information, see the [Request header](../api_acq/api_overview.md#3mLq0) section in _API Reference._
-   **Participant ID**: indicates the unique ID that is assigned by Alipay+ to identify an Acquiring Service Provider (ACQP), also known as the "Partner ID". The value of this parameter can be used to:

-   Specify the _acquirerId_ parameter in the API request or response.
-   Recognize the _participantId_ parameter involved in the reconciliation. For more information, see the [Download reports](../reconcile_acq/download_report.md) chapter in _Reconcile_.

-   **Certification Type**: indicates the method that is used by Alipay+ to sign an API request and validate the signature. It is displayed after you set a public key. For more information, see [Set a sandbox public key](#YabQV).

-   **Financial Reports**: contains information that is used to download sandbox clearing and settlement reports in the SFTP server, including the login account, password, and SFTP URL.

![3.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2025/png/b831e463-2685-4145-8878-2cde653020ae.png)

## Step 2: Configure the sandbox

To configure the sandbox on the **Sandbox** > **Settings** page, complete the following tasks.

### 1\. Set a sandbox public key

To make your integration safer, Alipay+ uses asymmetric keys for API signature. Your key pair and the Alipay+ public key are required in your local code. You need to generate your key pair and upload your public key to get the Alipay+ public key.

In the **Public key** panel of the **Sandbox > Settings** page, complete the following steps.

1.  Click **Set Your Public Key**.

![image](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/1673848250163-285bf279-eace-4c7e-8c1d-99b53a0a6591.png)

2.  On the **Set Your Public Key** page, click the respective link to download the tool that is provided by Alipay+.

![image](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/1673848434197-5af30559-df89-44eb-ad9c-cdb6838d4682.png)

3.  Open the zipped folder and run the **Run.bat** file.

![image](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/1680243756336-f03b8927-d285-4658-bea1-3c7b4e18eb8f.png)

4.  Click **New** to generate a key pair. Keep the private key locally.

![image](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/1644486312592-e97e1be2-1f34-4506-b832-b76220bf7c4e.png)

5.  Copy the public key and enter it on the **Set Your Public Key** page.

![image](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/1673848519249-3b5af4a8-558b-42af-a266-3d47ca61c265.png)

6.  Click **Submit** to upload your public key.

After submission, the Alipay+ public key is generated automatically. You can click the respective button to view or copy the Alipay+ public key.

![image](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/1673848594696-709a937a-aa6a-4d51-9f08-65f0a32a8532.png)

Your public key is updatable. Click **Edit Your Public Key** to update it. Please remember to update your key pair in your local code.

> **Note**: Your public key that is used in the sandbox must be different from the one in the production environment. For more information about getting the Alipay+ public key for the production environment, see [Set a production public key](launch_into_production.md#a7mDb).

### 2\. Conditional: Set notification URLs

Alipay+ provides APIs such as **authNotify**, **consultBinding**, and **userInitiatedPay** to send notifications to the ACQP. To receive notifications from Alipay+, the ACQP needs to provide notification URLs in [Alipay+ Developer Center](https://developers.alipayplus.com/open/console/developer/aps/app/list.md).

In the **Notification URL** panel, click **Edit** to specify the notification URLs for APIs that are shown as **Required**, so as to ensure that Alipay+ can call the APIs in the sandbox.

![image](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/1677814358417-cf7292d6-0857-4b1f-9048-48b5b1dd1ad9.png)

## Step 3: Test in the sandbox

When getting the sandbox ready, use development tools and resources to develop and test your application. Alipay+ provides the following tools and resources for developers:

-   **iTest**: used to create API requests. For more information about how to use iTest, see [iTest](itest.md).
-   **iMock**: used to simulate different API results and return specified responses. For more information about how to use iMock, see [iMock](imock.md).
-   **iNotify**: used to test whether the asynchronous notification can be received and are handled correctly. For more information about how to use iNotify, see [iNotify](inotify.md).
-   **iScan**: used to validate your API requests and responses against Alipay+ standards. For more information about how to use iScan, see [iScan](iscan.md).
-   **Auto Diagnosis**: used to investigate the specific reason when encountering errors during the integration tests. For more information about how to use Auto Diagnosis, see [Auto Diagnosis](auto_diagnosis.md).
-   **Alipay+ ACQP SDKs**: For more information, see [Alipay+ ACQP SDKs](sdk.md).
-   **Alipay+ Linker Wallet**: used to simulate the process of making payments to the merchant side. For more information, see [Alipay+ Linker Wallet](awallet.md).

You can find these tools and resources under the **Sandbox** > **Tools** tab.

![lQLPJxFAWrDvOPHNAtvM8LBYzdoa4GAf8AiMN-GQ86oA_240_731.png](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/yuque/idocs/2025/png/ec00e83a-2f24-483e-bb54-fb85082e5a92.png)