Alipay+Alipay+

Simulator

On the Simulator block of Alipay+ Linker Merchant (also called "AMerchant"), you can perform integration 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.

测试首页.jpg

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

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

Take the following three steps:

  1. Once you log in or click any of the payment products, a pop-up window appears to remind you of completing the settings. Click Confirm.
  2. On the Settings page, click the right arrow icon on the right of Acquirer to open the half-screen dialog.
  3. Click to select an Acquirer in the dialog and the Client ID is automatically assigned to you.

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

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

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. Click the Cashier Payment card 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 (Alipay+) to retrieve available payment methods from Alipay+.

lADPJwnIzLA9hazNBQDNAlA_592_1280.jpg

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, click Customize Request.

  1. Click 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. Also, all the available payment methods are shown.

lADPJxuMRegw7NvNClDNBLA_1200_2640.jpg

  1. Select one payment method and click Place Order.

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

  1. 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.

收银台订单选择URL.jpg

  1. Click Pay Now on the Payment Confirmation page.

收银台支付页.jpg

  1. The payment result is displayed. Click Done to finish the testing.

收银台支付成功页.jpg

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. Click the Auto Debit card 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.

代扣未填写.jpg

Fill in the following fields to continue:

  • Order Amount: Enter a value.
  • Currency: Select a currency that you want to test.
  1. To add a payment method, click Authorization Management.
  2. Click Add Payment Method and all the available payment methods are displayed. Note that if you want to add payment methods here, contact the Alipay+ solution team to add them into the allowlist.

lADPJx8ZxI0GBAHNClDNBLA_1200_2640.jpg

  1. Select a payment method and click Continue.
  2. 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.

lADPJxDjyfny1ijNClDNBLA_1200_2640.jpg_720x720q90g.jpg

  1. Complete the authorization to the digital wallet and the authorization result page is displayed in AMerchant. Click Back to return to the Auto Debit page.

代扣-授权成功商户端.jpg

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

代扣填写.jpg

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

lADPJxDjyfolG7vNClDNBLA_1200_2640.jpg_720x720q90g.jpg

  1. Click Check Out to complete the payment. The payment result is displayed on the Payment Result page.

代扣支付结果.jpg

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. Click the User-presented Mode Payment card 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.

反扫未填写.jpg

Fill in the following fields:

  • Order Amount: Enter a value.
  • Currency: Select a currency that you want to test.
  1. Click Scan to scan the QR code that is shown on your digital wallet app.
  2. 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. Click the Merchant-presented Mode Payment card on the Simulator page.
  2. The Payment Code page displays the parameters that are required to specify to initiate a pay request. In the Merchant-presented Mode Payment scenario, the pay API is used by the ACQP to send a request to place orders.

订单码未填写.jpg

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.
  1. Click Generate Payment Code to obtain a payment code.
  2. 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, click Confirm to go to the Payment Confirmation page.

聚合码输入金额.jpg

  1. Click Pay Now to complete the payment.

订单码支付页.jpg

  1. The payment result is displayed. Click Done to finish the testing.

正扫支付成功页.jpg