inquiryUserAccountList

Overview

POST /v1/users/inquiryUserAccountList returns user bank account list based on scopes granted through my.getAuthCode. Pass the accessToken issued by applyToken; the response includes the list of bank accounts associated with the user when authorized.

The ACCOUNT_LIST scope provides a more privacy-conscious alternative to CARD_LIST by returning only account numbers without any sensitive card information such as masked card numbers.

Flow

1. User enters Mini-app - The buyer opens the merchant's Mini Program within the Super Qi App.
2. Call my.getAuthCode JSAPI - The Mini Program calls my.getAuthCode with scopes=['ACCOUNT_LIST'] to request user authorization.
3. Display authorization page - Super Qi App displays the authorization consent page to the user.
4. Confirm authorization - The user reviews and confirms the authorization request.
5. Call authorization service - Super Qi App sends the authorization request to Super Qi Backend.
6. Return authCode - Super Qi Backend generates and returns the authorization code.
7. Callback authCode - Super Qi App passes the authorization code back to the Mini Program.
8. Send authCode - The Mini Program sends the authorization code to the Merchant Backend.
9. Apply access token - Merchant Backend exchanges the authorization code for an access token via /v1/authorizations/applyToken.
10. Return accessToken - Super Qi Backend returns the access token to the Merchant Backend.
11. Get user account list - Merchant Backend calls /v1/users/inquiryUserAccountList with the access token.
12. Return user account list - Super Qi Backend returns the user's account list to the Merchant Backend.
13. Return user account list - Merchant Backend passes the account list to the Mini Program.
14. Business logic - The Mini Program processes the account information according to business needs.

Endpoint

API Structure

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

Request

{
  "accessToken": "281010033AB2F588D14B43238637264FCA5AAF35xxxx"
}

Response

AccountInfo

{
  "result": {
    "resultCode": "SUCCESS",
    "resultStatus": "S",
    "resultMessage": "Success"
  },
  "accountList": [
    {
      "accountNumber": "12340001"
    },
    {
      "accountNumber": "12340002"
    },
    {
      "accountNumber": "12340003"
    }
  ]
}

Result Processing Logic

Error Codes

Related Links

• my.getAuthCode
• applyToken
• inquiryUserCardList