User
Parameter | Type | Required | Description |
openId | String | No | The user ID that is encrypted. The encrypted ID of each user for a miniapp is unique. For different miniapps, a user has multiple encrypted IDs. The value can be up to 64 characters in length. |
status | String | No | The state of the user. Examples: ACTIVE, FROZEN, and INACTIVE. The value can be up to 32 characters in length. |
nickName | String | No | The nickname of the user. The value can be up to 256 characters in length. |
userName | UserName | No | The username of the user. You cannot leave the following parameters empty at the same time: userName, fullName, firstName, middleName, and lastName. |
userAddresses | Array<Address> | No | The address of the user. |
avatar | String | No | The URL of the profile picture of the user. The value can be up to 256 characters in length. |
gender | String | No | The gender of the user. Valid values: F and M. F specifies female and M specifies male. The value can be up to 32 characters in length. |
birthDate | String/Datetime | No | The date of birth of the user. The date must follow the ISO 8601 standard. The value can be up to 32 characters in length. |
nationality | String | No | The nationality of the user. The value must be a two-letter code from the ISO 3166 standard. Examples: JP and US. The value can be up to 32 characters in length. |
loginIdInfos | Array<LoginIdInfo> | No | The logon IDs of the user. |
contactInfos | Array<ContactInfo> | No | The contacts of the user. |
extendInfo | String | No | The extended information to be added, such as the information about wallets and vendors. The value can be up to 4,096 characters in length. |
UserName
Parameter | Type | Required | Description |
fullName | String | No | The full name of the user. The value can be up to 128 characters in length. |
firstName | String | No | The first name of the user. The value can be up to 32 characters in length. |
middleName | String | No | The middle name of the user. The value can be up to 32 characters in length. |
lastName | String | No | The last name of the user. The value can be up to 32 characters in length. |
Address
Parameter | Type | Required | Description |
region | String | Yes | The region. The value must be a two-letter code from the ISO 3166 standard. Examples: JP and US. The value can be up to two characters in length. |
state | String | No | The state, county, or province. The value can be up to eight characters in length. |
city | String | No | The city, district, suburb, town, or village. The value can be up to 32 characters in length. |
address1 | String | No | The primary address that is specified in Address Line 1, such as the street, post office box, or company name. The value can be up to 256 characters in length. |
address2 | String | No | The secondary address that is specified in Address Line 2, such as the apartment, suite, unit, or building. The value can be up to 256 characters in length. |
label | String | No | The tag of the address. Examples: Family and Company. The value can be up to 64 characters in length. |
zipCode | String | No | The postal code. The value can be up to 32 characters in length. |
extendInfo | String | No | The extended information about the commodity. The value can be up to 4,096 characters in length. |
LoginIdInfo
Parameter | Type | Required | Description |
loginIdType | String | Yes | The type of the logon ID. Valid values:
The value can be up to 64 characters in length. |
loginId | String | No | The unique logon ID that is used by the user to connect to the wallet. The logon ID can be a mobile phone number or an email address. A user can connect to a wallet by using a logon ID that does not contain hidden bits. The value can be up to 64 characters in length. |
maskLoginId | String | No | The logon ID that is masked to hide bits, such as phone number bits, to ensure privacy. The value can be up to 64 characters in length. |
extendInfo | String | No | The extended information to be added, such as the information about wallets and vendors. The value can be up to 4,096 characters in length. |
ContactInfo
Parameter | Type | Required | Description |
contactType | String | Yes | The contact method of the user. The following contact methods are available to all users:
Note: If you are a developer, you can add new contact methods that are compatible with your system. The value can be up to 32 characters in length. |
contactNo | String | Yes | The value that corresponds to the contact method specified by the contactType parameter. For example, the value can be a mobile phone number or an email address. The value can be up to 64 characters in length. |
extendInfo | String | No | The extended information to be added, such as the information about wallets and vendors. The value can be up to 4,096 characters in length. |
Amount
Parameter | Type | Required | Description |
currency | String | Yes | The three-character ISO-4217 currency code. Maximum length: 3 characters. |
value | String/Integer | Yes | A string that encloses apositive integer representing how much to charge in the smallest currency unit(e.g., 100 cents to charge $1.00 or 100 to charge $100, a zero-decimal currency). Maximum length: 16 characters. |
PaymentMethod
Parameter | Type | Required | Description |
paymentMethodType | String | Yes | Payment method type, used to identifier a payment method. Maximum length: 32 characters. |
paymentMethodId | String | No | The uniqueID of a customer belong to a paymentMethod. Maximum length: 128 characters. |
extendMetaData | String | No | Extended information. Maximum length: 2048 characters. |
PaymentFactor
Parameter | Type | Required | Description |
isPaymentEvaluation | Boolean | No | An indicator of the payment evaluation. If the value is TRUE, the payment is only to evaluate whether the payment can be successful and no actual funds deduction occurs. The default value is FALSE. |
isOrderCode | Boolean | No | If the payment senario is the user scan the code presented by merchant and identify the order, and make payment. The default value is FALSE. |
isPaymentCode | Boolean | No | An indicator of whether the payment scenario is the merchant scan the user payment code. The default value is FALSE. |
isAgreementPay | Boolean | No | An indicator of whether the payment is an agreement payment.The default value is FALSE. |
isCashierPayment | Boolean | No | An indicator of whether the payment is a cashier payment.The default value is FALSE. |
isAuthorizationAndPay | Boolean | No | An indicator of whether to do agreementPay authorization during the payment.The default value is FALSE. |
isAuthorizationPayment | Boolean | No | An indicator of whether the payment is an authorization payment.The default value is FALSE. |
EnvInfo
Parameter | Type | Required | Description |
terminalType | String | No | The terminal type of this request. Valid values are:
|
osType | String | No | OS type. Valid values are:
|
osVersion | String | No | OS version |
userAgent | String | No | User agent. Maximum length: 1024 characters. |
deviceTokenId | String | No | Token ID of the device. Maximum length: 128 characters. |
clientIp | String | No | IP address of the client device. Maximum length: 64 characters. |
cookieId | String | No | User cookie ID. Maximum length: 128 characters. |
manufacturer | String | No | sample: Apple |
clientVersion | String | No | Version of APP client, sample:1.0.0 |
extendInfo | String | No | Extend information. Maximum length: 4096 characters. |
ActionForm
Parameter | Type | Required | Description |
actionFormType | String | No | The action form type. Valid values are:
|
orderCode | String | No | The order code value. |
redirectionUrl | String | No | The URL of redirect. |