Initiate token conversion

Initiate a new token conversion - exchange virtual tokens for real currency.

Request
Security:
tilia_auth (write_tokens)
Request Body schema: application/json

Create Token Conversion request

account_id
required
string

The account owner requesting the token conversion.

amount
integer

The number of virtual tokens to convert. Specified in your virtual currency. If omitted, the full available conversion balance will be used.

currency
string

Your virtual currency code. If your integration has only one virtual token, this may be omitted.

Responses
201

Successfully created token conversion.

400

Invalid input

401

Unauthorized access.

403

Disallowed from transacting.

500

Service unavailable or server error.

post/v2/token/convert
Request samples
application/json
{
  • "account_id": 250,
  • "amount": 250,
  • "currency": "VCD"
}
Response samples
application/json
{
  • "status": "Success",
  • "payload": {
    }
}