Introduction

  • Need to provide the user’s real email address.
  • Use uid to generate user token, which is only supported for new users, and users must perform email verification when logging in for the first time.
  • The accessToken is valid for 10 days.

API Description

Request Method: POST

Request Path: /open/api/v4/merchant/getToken

Header Parameters:

ParameterMandatoryTypeRemarks
appidYstringApp unique identifier
timestampYstringCurrent UTC 13-digit timestamp, valid within 5 minutes
signYstringSignature, you can refer to the signature Click Here

Body Parameters:

ParameterMandatoryTypeLengthRemarks
emailConditional Mandatorystring/User's email
uidConditional Mandatorystring36User’s UUID from merchant side

Example

Request Parameters:

{
	"email": "[email protected]"
}

Response:

{
    "success": true,
    "returnCode": "0000",
    "returnMsg": "SUCCESS",
    "extend": "",
    "data": {
        "id": "kklzDn3K/BvuSXs559OQfQ==",
        "accessToken": "ACH8945766425@ACH@kklzDn3K/BvuSXs559OQfQ==@PAY@cwqgsiyILMYNuMjhxhaQLpCX1hnntIqfL+V7uEqNu6I=@IO@g5aBrOrzxrfzsqs8W0cKR4VBugBZBSH5gYLOoL1eHICLR3GTygMCaCN3RvIMaeOUmy9PAVmFImjz+4uXR1MpRg==",
        "email": "cwqgsiyILMYNuMjhxhaQLpCX1hnntIqfL+V7uEqNu6I="
    },
    "traceId": "642e6990f3481462c6185b310ba2120b"

Uid Example

Request Parameters:

{
	"uid": "1234567xxxxx"
}

Response:

{
    "success": true,
    "returnCode": "0000",
    "returnMsg": "SUCCESS",
    "extend": "",
    "data": {
        "id": "kklzDn3K/BvuSXs559OQfQ==",
        "accessToken": "ACH8945766425@ACH@kklzDn3K/BvuSXs559OQfQ==@PAY@cwqgsiyILMYNuMjhxhaQLpCX1hnntIqfL+V7uEqNu6I=@IO@g5aBrOrzxrfzsqs8W0cKR4VBugBZBSH5gYLOoL1eHICLR3GTygMCaCN3RvIMaeOUmy9PAVmFImjz+4uXR1MpRg=="
    },
    "traceId": "642e6990f3481462c6185b310ba2120b"

Error Message

CodeDescriptionReturnMsg
3108Missing ParameterMust send one of the parameters