Query of User Card Information

Brief Description

Query user card information (only return card of normal status)

Environmental Information

Test environment domain name: https://sbx-card-api.alchemypay.org

Production environment domain name: https://card-api.alchemypay.org

Request URL

/open/merchant/api/findUserCard

Request method

  • post
  • Content-Type: application/json

Request Parameter

ParameterSignatureRequiredTypeLengthDescription
emailYesNostring64Email
appIdYesYesstring32Merchant appid
signYesYesstring512Signature

Note: "Signature" indicates whether the parameter needs to be included in the signature calculation.

Note: Please upload the email field after you confirm the user's email. If you cannot guarantee the authenticity of the user's email, please do not upload this field.

Request Parameter Example

{
  "email": "[email protected]",
  "appId": "qmamnbodyqzbdr0w",
  "sign": "8979EEB59CF15246A04E033962CA4084973A9D0F2F5CC08F07B99E9D0338F4486ED7700CF78F6365C2E399ED593B3EF9059F2EC808B5107CED8CC17BA0475962"
}

Response Parameter

ParameterTypeDescription
codestringCode - code description for details
msgstringReturn message
+modelarrayReturned when successful
└ cardIdstringCard ID
└ cardNumberstringCard number
└ cardTypestring1: Virtual card, 2: Physical card
└ cardStatusint1: Normal, 2: Abnormal
└ statusint0: Card creation in progress, 1: Available for use
└ cardCreatestringCard creation time
traceIdstringtraceId
successbooleanSuccess status
errorbooleanFailure status

Successful Response Example

{
  "code": "0",
  "msg": "success",
  "model": [
    {
      "cardNumber": "5580684317191565",
      "cardPattern": 1,
      "cardId": "c_53cd2815de6142acb54d",
      "cardStatus": 2,
      "status": 1,
      "cardCreate": "2023-12-01 13:00:00",
      "monthlyFlag": false
    },
    {
      "cardNumber": "5567665606016354",
      "cardPattern": 1,
      "cardId": "c_322265aa46c04cd8bc38",
      "cardStatus": 1,
      "status": 1,
      "cardCreate": "2023-12-01 14:00:00",
      "monthlyFlag": false,
    }
  ]
  "traceId": "656804e04e64df0d3c229a42662b1f2e",
  "error": false,
  "success": true
}

Failure Response example

{
  "code": "2606",
  "msg": "user does not exist",
  "model": null,
  "traceId": "644622ad97df9eed485ae837c9a48d5a",
  "error": true,
  "success": false
}

Remark

For more return error codes, please see the code description.