Skip to main content
POST
/
payments
curl -X POST "https://api.tavio.io/v1/payments" \
     -H "Authorization: Bearer tv_live_xxxxxxxxxxxx" \
     -H "Content-Type: application/json" \
     -d '{
           "amount": 10000,
           "currency": "USD",
           "settlement_asset": "USDC",
           "settlement_network": "stellar",
           "payment_methods": ["card", "bank_transfer", "crypto"],
           "customer": {
             "email": "customer@example.com",
             "name": "Jane Doe"
           },
           "metadata": { "order_id": "ord_789" },
           "redirect_url": "https://yourapp.com/payment/success"
         }'

{
  "id": "pay_abc123",
  "status": "pending",
  "checkout_url": "https://checkout.tavio.io/pay/abc123",
  "amount": 10000,
  "currency": "USD",
  "expires_at": "2026-02-21T12:30:00Z"
}

​
Body

​
amount
number
required
Amount in smallest currency unit.
​
currency
string
required
Source currency (ISO 4217).
​
settlement_asset
string
required
Asset merchant receives.
​
settlement_network
string
required
Settlement destination. Only supports stellar.
​
payment_methods
array
required
Allowed payment methods. For example: ["card", "bank_transfer", "crypto"].
​
customer
object
required
Customer details including email and name.
​
metadata
object
Optional key-value pairs for internal use (e.g. order_id).
​
redirect_url
string
URL to redirect the user after payment.

​
Response

​
id
string
Payment ID (e.g. pay_abc123).
​
status
string
Status of the payment (e.g. pending).
​
checkout_url
string
Hosted checkout URL.
​
amount
number
Amount in smallest currency unit.
​
currency
string
Source currency.
​
expires_at
string
ISO-8601 timestamp for quote expiry.
curl -X POST "https://api.tavio.io/v1/payments" \
     -H "Authorization: Bearer tv_live_xxxxxxxxxxxx" \
     -H "Content-Type: application/json" \
     -d '{
           "amount": 10000,
           "currency": "USD",
           "settlement_asset": "USDC",
           "settlement_network": "stellar",
           "payment_methods": ["card", "bank_transfer", "crypto"],
           "customer": {
             "email": "customer@example.com",
             "name": "Jane Doe"
           },
           "metadata": { "order_id": "ord_789" },
           "redirect_url": "https://yourapp.com/payment/success"
         }'

{
  "id": "pay_abc123",
  "status": "pending",
  "checkout_url": "https://checkout.tavio.io/pay/abc123",
  "amount": 10000,
  "currency": "USD",
  "expires_at": "2026-02-21T12:30:00Z"
}