Introduction - Tavvio Docs

Authentication

All requests must be authenticated using your API key in the Authorization header.

Authorization: Bearer tv_live_xxxxxxxxxxxx

Use tv_live_ prefixed keys for production and tv_test_ prefixed keys for sandbox. API keys are generated and managed in the Tavio Dashboard under Settings > API Keys.

Base URL

https://api.tavio.io/v1

Core Endpoints

Method	Endpoint	Description
`POST`	`/payments`	Create a new payment
`GET`	`/payments/:id`	Retrieve a payment
`POST`	`/quotes`	Get a conversion quote
`POST`	`/payment-links`	Create a payment link
`GET`	`/payment-links/:id`	Retrieve a payment link
`POST`	`/invoices`	Create an invoice
`POST`	`/invoices/:id/send`	Send an invoice by email
`POST`	`/payouts`	Create a single payout
`POST`	`/payouts/bulk`	Bulk payout disbursement
`GET`	`/payouts/:id`	Retrieve payout status
`POST`	`/refunds`	Initiate a refund
`GET`	`/transactions`	List all transactions
`POST`	`/webhooks`	Register a webhook endpoint

Error Handling

All errors follow a consistent format with an HTTP status code, error code, and human-readable message.

{
  "error": {
    "code": "insufficient_liquidity",
    "message": "Unable to find a conversion path for the requested amount.",
    "docs": "https://docs.tavio.io/errors/insufficient_liquidity"
  }
}

HTTP Code	Error Code	Meaning
400	`invalid_request`	Missing or malformed request parameters
401	`unauthorized`	Invalid or missing API key
404	`not_found`	Resource does not exist
409	`quote_expired`	Quote has expired, request a new one
422	`insufficient_liquidity`	No path found for conversion
429	`rate_limited`	Too many requests
500	`internal_error`	Tavio-side error

​Authentication

​Base URL

​Core Endpoints

​Error Handling

Authentication

Base URL

Core Endpoints

Error Handling