Optional - Create chain token

POST

/dr/v1/auth/token/chain/{chainID}

const url = 'https://sender.sandbox-api.kivra.com/dr/v1/auth/token/chain/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/chain/example

Optional. A chain-scoped token only narrows what a token may access — your partner token can already manage every chain and store and send receipts for any store. Use this endpoint only for distributed integrations where you want to limit an integration point to a single chain; centralized integrations can keep using the partner token throughout.

Access scope

PARTNER

Parameters

Path Parameters

chainID

required

string

Chain 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"
}