pay (Cashier Payment)ACQP → Alipay+

The order details that are agreed upon by the buyer and the merchant, including the information about the buyer, the merchant, the goods, the initial order amount, and so on. The order details are displayed in purchase records and used for risk and regulatory reporting. 

Note: 

In this scenario, apart from the required child parameters, the following child parameters must be specified:

• env.terminalType
• env.osType if the value of the env.terminalType parameter is APP or WAP

It is recommended that you also specify the following child parameter:

• buyer.referenceBuyerId

The unique ID that is assigned by the ACQP to identify a payment order.

The amount that the ACQP requests to receive from Alipay+. The currency of the amount must be specified to the one that the ACQP uses to create the payment order.

Note:

• The paymentAmount and settlementStrategy parameters jointly affect the amount that Alipay+ settles to the ACQP (which is returned as the settlementAmount parameter) in the following ways:
• If the payment currency (specified on the paymentAmount.currency parameter) is the same as the settlement currency (specified on the settlementStrategy.settlementCurrency parameter), the settlement amount is the same as the payment amount (specified on the paymentAmount.value parameter).
• If the payment currency (specified on the paymentAmount.currency parameter) is different from the settlement currency (specified on the settlementStrategy.settlementCurrency parameter), the settlement amount is calculated based on the payment amount (specified on the paymentAmount.value parameter) and the exchange rate between the settlement currency and payment currency.
• When you specify the paymentAmount parameter, ensure that the settlement amount is no less than the smallest amount in the settlement currency; otherwise, the API call fails.

The payment method that is used to collect the payment.

Note: In this scenario, the value of the paymentMethodType parameter must be set to CONNECT_WALLET .

Factors that impact payment-related items such as service fee, interchange fee (also known as interpartner fee), and regulatory reporting. This parameter is used to identify the payment scenario.

Note: In this scenario, the following child parameters must be set to the specific values as shown below:

• isInStorePayment: set the value to false 
• isCashierPayment: set the value to true
• presentmentMode: set the value to UNIFIED

The time after which the payment order is expired. If the payment order is not completed before the time that is specified for this parameter, Alipay+ closes the order and calls the notifyPayment API to notify the ACQP of the payment result.

Note: 

• Required if the ACQP wants the payment order to be completed before a specific time.
• If this parameter is not required in your situation, exclude it from the request.
• In this scenario, the default value of this parameter is 10 minutes.
• The specified expiration time must be shorter than the default expiration time; otherwise, the default expiration time takes effect instead of the specified expiration time.

The URL that is used to receive the payment result notification from Alipay+.

The URL where the user is redirected from the MPP side to after the user proceeds with the payment order to a status of success, failure or unknown (for example, give up the payment order).

Specify this parameter if the user needs to be redirected from the MPP's payment result page to a predetermined page, for example, the merchant payment result page.

The settlement strategy that is applied to the payment order, for example, specify the currency that the ACQP wants to be settled against.

Important: If the settlement currency is different from the payment currency that is specified on the paymentAmount.currency parameter, you must specify this parameter correctly; otherwise, you can

• set the value of this parameter to that of the paymentAmount.currency parameter.
• set the value of this parameter to null (without double quotation marks). 
• exclude this parameter from the request body.

In the latter case, the value of the paymentAmount.currency parameter is used as that of the settlementCurrency parameter.

This parameter is used to sort the payment method list in descending order based on the relevance between the MPP and the user region on the Alipay+ checkout page. The value of this parameter is a 2-letter country/region code according to ISO 3166 Country Codes.

Note: 

• Required if the ACQP wants to sort the payment method list on the Alipay+ checkout page based on the user region.
• If this parameter is not required in your situation, exclude it from the request.

The 16-digit, unique ID that is assigned by Alipay+ to the ACQP for multi-batch reconciliation. For each unique value of this parameter, Alipay+ performs a batch of clearing and settlement, and transfers a batch of funds to the ACQP's bank account.

Note:

• Required if the ACQP needs to split its settlement for transactions in one region and one currency into multiple batches.
• If this parameter is not required in your situation, exclude it from the request.

The result of the business processing, including the result status, result code, and result message. For more information about how to handle the result of the pay API, see Result processing logic.

The unique ID that is assigned by Alipay+ to identify an ACQP.

Note: Returned by Alipay+ if the value of the result.resultCode parameter is PAYMENT_IN_PROCESS, which means that the request is accepted. 

The unique ID that is assigned by Alipay+ to identify a payment order.

Note: Returned by Alipay+ if the value of the result.resultCode parameter is PAYMENT_IN_PROCESS, which means that the request is accepted. 

The payment URL that redirects users to a WAP or Web page in the browser or in the WebView.

Note:

• Returned by Alipay+ if the value of the result.resultCode parameter is PAYMENT_IN_PROCESS.
• The auth client needs to trust all URLs returned by Alipay+, instead of adding them to the whitelist.

The amount that the ACQP requests to receive from Alipay+. The currency of the amount is the one that the ACQP uses to create the payment order.

Note: Returned if the value of the result.resultCode parameter is PAYMENT_IN_PROCESS, which means that the request is accepted. 

The payment data that is used by the Alipay+ client SDK to render the checkout page.

Note: Returned if the merchant app has integrated the Alipay+ client SDK, the value of the order.env.terminalType parameter is APP, and the value of the paymentMethod.paymentMethodType parameter is CONNECT_WALLET. After receiving this parameter, the ACQP must send it to the merchant app so the app can call the showPaymentSheet API of the Alipay+ client SDK.

The unique ID that is assigned by Alipay+ to identify an MPP.

Note: Returned by Alipay+ if the value of the result.resultCode parameter is PAYMENT_IN_PROCESS and the value of the paymentMethod.paymentMethodType parameter is not CONNECT_WALLET.