Get single-use token

This endpoint returns a single-use access token. This type of token authorizes a single request to access API endpoints and data associated with a particular user

POST /cards/single_use_token

Get single-use token

cURL

curl --request POST \
  --url https://api-sandbox.synctera.com/v0/cards/single_use_token \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
  "customer_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7"
}
'

201

{
  "customer_account_mapping_id": "user_token",
  "expires": "2000-01-23T04:56:07.000+00:00",
  "token": "token"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key · string

An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry.

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

Body

application/json

User token details

account_id · string<uuid> · required

The ID of the account to which the token will be linked

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

customer_id · string<uuid> · required

The ID of the customer to whom the token will be issued

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

Response

201

application/json

Token Created

expires · string<date-time> · required

yyyy-MM-ddTHH:mm:ssZ

customer_account_mapping_id · string

token · string