Simulator

On the Simulator page of Alipay+ Linker Merchant (also called "AMerchant"), you can perform testing for Alipay+ payment products.

Follow these steps:

1. Open AMerchant and make sure all the required configurations are ready. For more information, see Step 1: Confirm configurations.
2. Locate yourself on the Simulator page and you can see Alipay+ payment products.

3. Complete the settings for further testing any of the payment products.

Note: This step is only necessary for those who are logged in for the first time. Skip this step if you have already completed the settings.

1. Once you are logged in or tap any of the payment products, a pop-up window appears to remind you of completing the settings. Tap Confirm.
2. On the Settings page, tap the Acquirer section to pull up the Acquiring Partner list.

1. Select an Acquiring Partner from the list and the Client ID is automatically assigned to you.

If you want to change the settings during testing, you can tap the avatar icon on the top-right corner of the Simulator page and then, follow the steps b~c above.

4. Select one of the following fours payment products and start testing:

• Cashier Payment: For more information, see Cashier Payment.
• Auto Debit: For more information, see Auto Debit.
• User-presented Mode Payment: For more information, see User-presented Mode Payment.
• Merchant-presented Mode Payment: For more information, see Merchant-presented Mode Payment.

Cashier Payment

Cashier Payment occurs when a user purchases the merchandise on the merchant's online site and the user is redirected to the checkout page to complete the payment.

To test Cashier Payment via AMerchant, follow these steps:

1. Tap Cashier Payment on the Simulator page.
2. The Cashier Payment page displays the parameters that are required to specify to send a consultPayment request. The consultPayment API is used by the Acquiring Service Provider (ACQP) to retrieve available payment methods from Alipay+.

Fill in the following fields to continue:

• Order Amount: Enter a value.
• Currency: Select a currency that you want to test.
• Merchant Cashier Page Type: Select the type of the merchant cashier page.

• SDK
• WAP

• Back to Merchant App: Select the method by which the user is redirected to the merchant app.

• App
• H5

If you want to edit the request body directly, tap Customize Request.

3. Tap Check Out to go to the Order Information page, where the order information, including the commodity name, the commodity number, and the order amount is displayed.

4. Select one payment method and tap Place Order.

Note: If you want to add available payment methods, contact the Alipay+ Solution Architect Team to add them to the available payment methods list.

If you want to edit the request body directly, tap Customize Request.

5. A half-screen dialog pops up. Select a URL type for redirection from the following three types:

• NormalUrl: indicates the URL that redirects the user to a WAP or Web page in the browser or in the WebView.
• AppLinkUrl: indicates the URL that redirects the user to open an app, or, if no app is installed, to a WAP page.
• SchemeUrl: indicates the URL scheme that redirects the user to open an app.

7. Tap Pay Now on the Payment Confirmation page.

8. The payment result is displayed. Tap Done to finish the testing.

Auto Debit

Auto Debit occurs when a user pre-authorizes and links his/her digital wallet account with the merchant app account so that the merchant can directly deduct funds from the user's account upon each transaction.

To test Auto Debit via AMerchant, follow these steps:

1. Tap Auto Debit on the Simulator page.
2. The Auto Debit page displays all the parameters that are required to specify to send a pay request. In the Auto Debit scenario, the pay API is used by the ACQP to send a request to deduct funds from the user's MPP account.

Fill in the following fields to continue:

• Order Amount: Enter a value.
• Currency: Select a currency that you want to test.

3. To add a payment method, tap Authorization Management.
4. Tap Add Payment Method and all the available payment methods are displayed.

Note: If you want to add available payment methods, contact the Alipay+ Solution Architect Team to add them to the available payment methods list.

5. Select a payment method and tap Continue.
6. A half-screen dialogue pops up. Select a type of redirection URL from the following three types:

• NormalUrl: indicates the authorization URL that redirects users to a WAP or Web page in the browser or in the WebView.
• AppLinkUrl: indicates the authorization URL in the form of a link that redirects users to an app, or, if no app is installed, to a WAP page.
• SchemeUrl: indicates the authorization URL in the form of a URL scheme, which redirects users to an app.

6. Complete the authorization that is sent to your digital wallet and the authorization result is displayed. Tap Back to return to the Auto Debit page.

7. Select an authorized digital wallet as Payment Method, and then the value of Access Token is automatically generated.

Moreover, if you want to deauthorize a digital wallet for Auto Debit, or refresh the access token, visit the Authorization Management page, select the wallet to view details, and tap Close Service or Refresh Token respectively.

8. Tap Check Out to complete the payment. The payment result is displayed on the Payment Result page.

User-presented Mode Payment

User-presented Mode Payment occurs when the consumer presents the payment code to the merchant, and the merchant scans the payment code to initiate a payment.

To test User-presented Mode Payment via AMerchant, follow these steps:

1. Tap User-presented Mode Payment on the Simulator page.
2. The Scanner page displays the parameters that are required to specify to initiate a pay request. In the User-presented Mode Payment scenario, the pay API is used by the ACQP to send a request to deduct funds from the user's MPP account.

Fill in the following fields:

• Order Amount: Enter a value.
• Currency: Select a currency that you want to test.

3. Tap Scan to scan the QR code that is shown on your digital wallet app.
4. The payment result is displayed on the Payment Result page after the payment is completed.

Merchant-presented Mode Payment

Merchant-presented Mode Payment occurs when the consumer scans the QR code presented by the merchant (also called collection code) to complete the payment. The collection code can be an entry code or an order code.

To test Merchant-Presented Mode Payment via AMerchant, follow these steps:

1. Tap Merchant-presented Mode Payment on the Simulator page.
2. The Payment Code page displays the parameters that are required to specify to initiate a payment request. In the Merchant-presented Mode Payment scenario, the pay API is used by the ACQP to send a request to place orders.

Fill in the following fields:

• Payment Code Type: Select the type of the payment code.

• Order Code (Alipay+): indicates that the payment code is an order code generated by Alipay+.
• Order Code (ACQP): indicates that the payment code is an order code generated by the ACQP.
• Entry Code: indicates that the payment code is an entry code.

• Order Amount: Enter a value.
• Currency: Select a currency that you want to test.

3. Tap Generate Payment Code to obtain a payment code.
4. Save the screenshot of the payment code and use your digital wallet app to scan the code.

• If the payment code is an order code, the code scanning will lead you to the Payment Confirmation page.
• If the payment code is an entry code, the code scanning will lead you to the page where you need to enter the order amount again. Then, tap Confirm to go to the Payment Confirmation page.

5. Tap Pay Now to complete the payment.

6. The payment result is displayed. Tap Done to finish the testing.