Token Exchange WebhookWebhook

Request
Request Body schema: application/json
token_exchange_id
string <TUID>

The id for this token exchange instance.

account_id
string <UUID4>

Account ID of the creator of this token exchange instance.

destination_wallet_id
string <UUID4>

The wallet ID that will receive funds as a result of this transaction. The owner of this wallet may or may not be the account ID of the creator.

direction
string

Defines whether this token exchange instance is a purchase or conversion. One of [token_purchase, token_convert]

invoice_id
string <TUID>

The underlying invoice ID associated with this transaction.

user_paid_amount
integer

The amount in fiat or virtual currency the user paid for the token exchange.

user_paid_currency
string

The currency of the paid amount.

user_received_amount
integer

The amount in fiat or virtual currency the user received after the token exchange.

user_received_currency
string

The currency of the received amount.

exchange_rate
number

The rate to convert between virtual and USD.

exchange_rate_direction
string

The direction that the exchange_rate field is defined in

tilia_fee_amount
integer

The Tilia fee amount associated with this transaction.

integrator_fee_amount
integer

The integrator fee amount associated with this transaction.

fee_currency
string

The currency that the Tilia fee is priced in.

status
string

The current status of this transaction.

created
string

Timestamp when this was created. The format is RFC 3339 (2006-01-02T15:04:05Z07:00).

updated
string

Timestamp when this was updated. The format is RFC 3339 (2006-01-02T15:04:05Z07:00).

Responses
2XX

Return a 2XX status to indicate that the data was received successfully

Request samples
application/json
{
  • "token_exchange_id": "vtok_1y9CqqiLJ6s0W2hsPgQqLkvR4og",
  • "account_id": "4ba04731-9f66-4123-a8a1-7ef815444444",
  • "destination_wallet_id": "4ba04731-9f66-4123-a8a1-7ef815444444",
  • "direction": "token_purchase",
  • "invoice_id": "inv_24Fs1IP1xkYlqNY465chmHlymZm",
  • "user_paid_amount": 250,
  • "user_paid_currency": "VCD",
  • "user_received_amount": 250,
  • "user_received_currency": "VCD",
  • "exchange_rate": 100.01,
  • "exchange_rate_direction": "usd_to_virtual",
  • "tilia_fee_amount": 25,
  • "integrator_fee_amount": 25,
  • "fee_currency": "VCD",
  • "status": "SUCCESS",
  • "created": "string",
  • "updated": "string"
}