Optional - Create store token

POST

/dr/v1/auth/token/store/{storeID}

const url = 'https://sender.sandbox-api.kivra.com/dr/v1/auth/token/store/example';
const options = {method: 'POST'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://sender.sandbox-api.kivra.com/dr/v1/auth/token/store/example

Optional. A store-scoped token only narrows what a token may access — your partner token can already send receipts for any store. Use this endpoint only for distributed integrations where you want to limit an integration point (e.g. a single POS terminal) to one store; centralized integrations can keep using the partner token throughout.

Access scope

PARTNER
CHAIN

Parameters

Path Parameters

storeID

required

string

Store ID

Responses

200

Token successfully created

application/json

TokenResponse

object

access_token

string

token_type

string

Allowed values: Bearer

expires_in

Expiration time in seconds

integer

Example

{
  "access_token": "<JWT token>",
  "token_type": "Bearer",
  "expires_in": 86000
}

400

Bad request

application/json

ErrorResponse

object

error_code

string

short_message

string

long_message

string

error_detail

Array<string>

Examples

{
  "error_code": "40000",
  "short_message": "bad request",
  "long_message": "body s missing required fields or has invalid fields"
}

{
  "error_code": "40002",
  "short_message": "bad request",
  "long_message": "missing required header or invalid header"
}

401

Unauthorized

application/json

ErrorResponse

object

error_code

string

short_message

string

long_message

string

error_detail

Array<string>

Examples

unauthorized

{
  "error_code": "40100",
  "short_message": "unauthorized",
  "long_message": "permission denied"
}

404

Not found

application/json

ErrorResponse

object

error_code

string

short_message

string

long_message

string

error_detail

Array<string>

Examples

resource_not_found

{
  "error_code": "40400",
  "short_message": "not found",
  "long_message": "the requested resource could not be found"
}

500

Internal server error

application/json

ErrorResponse

object

error_code

string

short_message

string

long_message

string

error_detail

Array<string>

Example

{
  "error_code": "50000",
  "short_message": "internal server error",
  "long_message": "unknown error ocurred"
}