SDK interfaces
The following sections introduce the interfaces that are provided by the Alipay+ ACQP Web/WAP SDK.
1. Overview
This section describes the interfaces that are used in the interaction between the SDK and your project.
Interface name | Description |
AlipayPlus.create() | Create an instance of the |
loadAlipayPlus() | Load the |
inquirePaymentOption() | Inquire about the availability of and how to render the Alipay+ payment method on the payment method page. |
2. APIs
AlipayPlus.create()
Use this API to create an instance of the Alipay+ Web/WAP SDK
object.
Syntax
AlipayPlus.create(config);
Arguments
Name | Type | Description | Required |
config | An object that includes the parameters for setting up the SDK. | M |
Returns
Type | Description |
AlipayPlus | An instance of the |
loadAlipayPlus()
Use this API to load the Alipay+ Web/WAP SDK
object.
Note: This API exists only in the alipayplus-sdk-acqp-web package.
Syntax
loadAlipayPlus();
Arguments
N/A
Returns
Type | Description |
AlipayPlus | The |
inquirePaymentOption()
Use this API to inquire whether the Alipay+ payment method is available and if so, related data about the Alipay+ payment method, such as the Alipay+ logo information and promotion information.
Syntax
alipayPlus.inquirePaymentOption(params);
Arguments
Name | Type | Description | Required |
params | An object that contains the parameters for querying the data about the Alipay+ payment method. | M |
Returns
Type | Description |
Promise<IPaymentOption> | The data about the Alipay+ payment method. This parameter is returned if the inquiry is successful. |
Errors
Type | Description |
The error code about the inquiry. |
3. Appendices
IConfig
Name | Type | Description | Required |
merchantId | String | The unique ID that is assigned by the ACQP to identify a merchant. Note: The value of this parameter must be the same as the one that is specified when calling the pay API. | M |
acquirerId | String | The unique ID that is assigned by Alipay+ to identify an ACQP. | M |
language | String | The language that is preferred by the user. The value of the parameter consists of a language code following the ISO-639 standard and a country code following the ISO-3166 standard. The codes are connected by an underscore. For example, Valid values are:
Note:
| O |
envType | String | The type of environment where the SDK is installed. The value of this parameter affects the gateway address of the requests that are initiated from the SDK. Valid values:
Default value: | O |
IInquirePaymentOptionParams
Name | Type | Description | Required |
paymentCurrency | String | The payment currency that is supported by the merchant. The value of this parameter must be an alphabetic code that follows the ISO 4217 standard, for example, "EUR" for Euros. | M |
IPaymentOption
Name | Type | Description | Required |
enabled | Boolean | Indicates whether the Alipay+ payment method is available. | M |
paymentMethodType | String | The payment method that is provided by Alipay+. Valid values are:
| M |
logos | Array<ILogo> | The list of logos of the Alipay+ payment method. Note: Nullable if the value of the enabled parameter is | O |
brandName | String | The brand name of the Alipay+ payment method. Note: Nullable if the value of the enabled parameter is | O |
disableReason | String | The reason why the Alipay+ payment method is unavailable. Note: The value of this parameter is null if the value of the enabled parameter is | O |
promoNames | Array<String> | The list of promotion campaigns in the language that is preferred by the user. Each element in the array is a string that indicates the promotion name, such as Currently, the array contains only one element indicating one specific promotion campaign, which is the best offer that Alipay+ recommends to be displayed alongside the logo, rather than multiple different promotion campaigns. | O |
ILogo
Name | Type | Description | Required |
logoName | String | The name of the logo. | O |
logoUrl | String | The URL of the logo. | O |
logoPattern | String | The pattern of the logo, such as
| O |
logoWidth | String | The width of the logo. | O |
logoHeight | String | The height of the logo. | O |
IErrorCode
Name | Type | Description | Required |
errorCode | number | The error code. | O |
errorMessage | String | The error message. | O |
Samples
errorCode | errorMessage | Description |
1001 | PARAM_ILLEGAL | Illegal parameters exist. |
1002 | INVALID_NETWORK | A network error occurs. |
1003 | SYSTEM_ERROR | A system error occurs. |