Alipay, China's leading third-party online payment solutionAlipay, China's leading third-party online payment solution

      inquiryRegistrationInfo

      Use the inquiryRegistrationInfo API to inquire a merchant's registration information. For successfully registered merchants, the latest merchant information is returned. If there are no successful registrations, only the request acceptance result will be returned. 

      Structure

      A message consists of a header and body. The following sections are focused on the body structure. For the header structure, see: 


      Note: Set the data type of each field (except array) as String. This means that you must use double quotation marks (" ") to enclose the field value. Examples:

      • If the data type of a field is Integer and its value is 20, set it as "20". 
      • If the data type of a field is Boolean and its value is true, set it as "true". 

      Request parameters

      referenceMerchantId StringRequired

      The secondary merchant ID that is assigned by the acquirer.

      More information about this field:

      • Maximum length: 64 characters

      Response parameters

      result ResultRequired

      The request result contains information such as status and error codes.

      resultCode StringRequired

      Result code

      More information about this field:

      • Maximum length: 64 characters
      resultStatus StringRequired

      Result status. Valid values are: 

      • S: Successful 
      • F: Failed 
      • U: Unknown

      More information about this field:

      • Maximum length: 2 characters
      resultMessage StringOptional

      Result message that describes resultCode in detail.

      More information about this field:

      • Maximum length: 256 characters
      merchantInfo MerchantRegistrationInfoRequired

      Merchant information

      referenceMerchantId StringRequired

      The secondary merchant ID that is assigned by the acquirer.

      More information about this field:

      • Maximum length: 64 characters
      merchantDisplayName StringOptional

      The display name of the merchant

      More information about this field:

      • Maximum length: 64 characters
      merchantMCC StringRequired

      Merchant category code, which is a four-digit number listed in MCC codes. 

      More information about this field:

      • Maximum length: 32 characters
      merchantAddress AddressOptional

      The address where the merchant business is registered.

      region StringRequired

      The two-character ISO 3166 country/region code.

      More information about this field:

      • Maximum length: 2 characters
      state StringOptional

      State, county or province

      More information about this field:

      • Maximum length: 8 characters
      city StringOptional

      City, district, suburb, town, or village.

      More information about this field:

      • Maximum length: 32 characters
      address1 StringOptional

      Address line 1 (such as street, PO Box, or company name)

      More information about this field:

      • Maximum length: 256 characters
      address2 StringOptional

      Address line 2 (such as apartment, suite, unit, or building)

      More information about this field:

      • Maximum length: 256 characters
      zipCode StringOptional

      ZIP or postal code

      More information about this field:

      • Maximum length: 32 characters
      label StringOptional

      Label for address, such as company or home.

      More information about this field:

      • Maximum length: 64 characters
      registrationDetail RegistrationDetailRequired

      Detailed registration information

      legalName StringRequired

      The legal name that is used in the registration.

      More information about this field:

      • Maximum length: 256 characters
      attachments Array<Attachment>Optional

      The attachments submitted

      attachmentType StringRequired

      The attachment type. Valid values are: 

      • ARTICLES_OF_ASSOCIATION: Articles of association
      • ENTERPRISES_ANNUAL_INSPECTION_REPORT: Enterprise annual inspection report
      • PROOF_OF_ADDRESS: The proof of address
      • REGISTRATION_CERTIFICATE: Registration certificate
      file StringRequired

      The attactment file

      More information about this field:

      • Maximum length: 1024 characters
      attachmentName StringOptional

      The name of the attachment

      More information about this field:

      • Maximum length: 128 characters
      contactInfo Array<ContactInfo>Optional

      The company contact information

      contactNo StringRequired

      Contact number, such as mobile phone number. Email address can also be used.

      More information about this field:

      • Maximum length: 64 characters
      contactType StringRequired

      Contact type. Valid values are:

      • MOBILE_PHONE: Mobile phone
      • TELEPHONE: Telephone
      • EMAIL: Email
      registrationType StringRequired

      The registration type. Valid values are: 

      • ENTERPRISE_REGISTRATION_NO: Merchant registration ID
      • INDEPENDENT_CONTRACTOR_LICENSE_NO: The license number of ride-share driver or taxi driver.
      • OTHER_IDENTIFICATION_NO: Other registration type.
      • US_FEDERAL_EIN:(Employer Identification Number) EIN of USmerchant
      registrationNo StringRequired

      The company registration number

      More information about this field:

      • Maximum length: 64 characters
      registrationAddress AddressRequired

      The company registration address

      region StringRequired

      The two-character ISO 3166 country/region code

      More information about this field:

      • Maximum length: 2 characters
      state StringOptional

      State, county or province.

      More information about this field:

      • Maximum length: 8 characters
      city StringOptional

      City, district, suburb, town, or village.

      More information about this field:

      • Maximum length: 32 characters
      address1 StringOptional

      Address line 1 (such as street, PO Box, or company name)

      More information about this field:

      • Maximum length: 256 characters
      address2 StringOptional

      Address line 2 (such as apartment, suite, unit, or building)

      More information about this field:

      • Maximum length: 256 characters
      zipCode StringOptional

      ZIP or postal code

      More information about this field:

      • Maximum length: 32 characters
      label StringOptional

      Label for address, such as company or home.

      More information about this field:

      • Maximum length: 64 characters
      businessType StringRequired

      The business type. Valid values are:

      • ENTERPRISE: The business type is enterprise.
      • INDIVIDUAL: The business type is individual.
      registrationEffectiveDate DatetimeOptional

      The date when the business registration is in effective.

      More information about this field:

      • The value follows the ISO 8601 standard format. For example, "2019-11-27T12:01:01+08:30".
      registrationExpireDate DatetimeOptional

      The date when the business registration expires.

      More information about this field:

      • The value follows the ISO 8601 standard format. For example, "2019-11-27T12:01:01+08:30".
      websites Array<WebSite>Optional

      Merchant websites

      name StringOptional

      The name of the website

      More information about this field:

      • Maximum length: 256 characters
      url URLRequired

      The URL of the website

      More information about this field:

      • Maximum length: 2048 characters
      desc StringOptional

      The description of the website

      More information about this field:

      • Maximum length: 512 characters
      logo LogoOptional

      Merchant logo

      logoName StringRequired

      The logo name

      More information about this field:

      • Maximum length: 128 characters
      logoUrl URLOptional

      The logo URL

      More information about this field:

      • Maximum length: 2048 characters
      productCodes StringRequired

      Product codes. For online payments, the valid values of this field are:

      productCodes: ["CASHIER_PAYMENT", "AGREEMENT_PAYMENT"]

      Responses for different cases

      This section provides responses for different cases of registration information inquiries.

      Error codes

      Error codes are usually classified into the following categories:

      • Common error codes: common for all online and in-store payment APIs.
      • API-specific error codes: listed in the following table.  

      Result/Error codes

      CodeValueMessageFurther action
      SUCCESSSSuccess

      The registration is successful, no further action is needed.

      INVALID_CLIENTFThe client is invalid.

      Check whether the clientId is correct.

      MEDIA_TYPE_NOT_ACCEPTABLEFThe server does not implement the media type that is acceptable to the client.

      Check whether the media type is correct.

      METHOD_NOT_SUPPORTEDFThe server does not implement the requested HTTP method.

      Check whether the HTTP method is correct.

      REPEAT_REQ_INCONSISTENTFRepeated requests are inconsistent.

      Change referenceMerchantId and call the interface again.

      RECORD_NOT_FOUNDFThe system is not able to find the registration record for the given referenceMerchantId and/or referenceStoreId.

      The registration record is not found. Please check whether referenceMerchantId or referenceStoreId is correct.

      Request/Response Code

      Request

      Method

      POST

      Endpoint

      /v1/merchants/inquiryRegistrationInfo

      Header

      Accept: application/json

      URL

      Domain name

      Request Body
      Request parameters
      Response Body
      Body content