E-Commerce & tokenized transactionsCustomer Management

Generate Auth Token

API Explorer
https://auth.ipospays.tech/v1/authenticate-token
POST

Exchanges your API key and secret key for a token.

Steps to Generate Keys on iPOSpays

  1. Log in to the iPOSpays portal using an Merchant account

This API works exclusively with merchant credentials and cannot be used with ISO credentials.

  1. Go to: Settings → Generate API & Secret Key

  2. Under the Generate Keys section:

    • Click Generate Keys

    • Click the Copy icon to copy the keys

    • Click Reset Secret Key if you wish to regenerate the Secret Key

  3. Use the generated API and Secret Key for API authentication

Header Parameters

apiKey*string

The apiKey can be generated from the iPOSpays portal using an Merchant account. These keys are required for authentication.

secretKey*string

The secret key can be generated from the iPOSpays portal using an Merchant account. These keys are required for authentication.

TokenExpiryMinutes?integer

Token expiry time in minutes. For this API the token expires after 10 minutes.

Default10

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com" \  -H "apiKey: your_api_key_here" \  -H "secretKey: your_secret_key_here" \  -H "TokenExpiryMinutes: 10"
{
  "responseCode": "00",
  "responseMessage": "Success",
  "createdDt": 1791465138566,
  "tokenExpiresInMinutes": 10,
  "token": "<JWT – masked in docs>"
}

{
  "errorCode": "AUTH_ERR_001",
  "errorMessage": "API Key is required."
}

{
  "errorCode": "AUTH_ERR_004",
  "errorMessage": "Invalid Credentials, Please Contact Support Team."
}
{
  "timestamp": 1791465141552,
  "status": 405,
  "error": "Method Not Allowed",
  "path": "/v1/authenticate-token"
}
Customer ManagementCreate Customer