Skip to content

Refresh Customer Token ​

Use this endpoint to obtain a new customer JWT access token and rotated refresh token when an existing session token expires.

Endpoint ​

POST /v1/auth/customer/refresh-token

Authentication ​

  • Requires X-MerchantApiKey: MERCHANT_API_KEY.
  • No Authorization Bearer header required.

Headers ​

json
{
  "X-MerchantApiKey": "MERCHANT_API_KEY",
  "Content-Type": "application/json"
}

Request body ​

Field NameTypeRequiredDescription
refreshTokenstringYesThe active refresh token issued during login or last rotation.
json
{
  "refreshToken": "d8e3b791-4c12-4f9e-a89b-90f7a5b5e4b0"
}

Responses ​

200 OK ​

json
{
  "customer": {
    "id": "67dfb8408bd13b35a66f42ed",
    "email": "customer@example.com",
    "fullName": "Jane Doe",
    "status": "active"
  },
  "token": "eyJhbGciOiJIUzI1NiIsIn...",
  "refreshToken": "e9f4c802-5d23-5a0f-b90c-01a8b6c6f5c1",
  "expiresIn": 86400,
  "refreshTokenExpiresIn": 2592000
}

401 Unauthorized ​

json
{
  "status": false,
  "message": "The refresh token has expired or is invalid. Please log in again."
}

Build with joy