API quick start

One request creates a payment and returns a page for your customer. Send the key in the X-API-Key header.

1. Create a payment

Request
curl https://gate.teleport.ltd/api/crypto-acquiring/v1/invoice/create/ \
  -H "X-API-Key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"amount": "100.00", "currency": "USDT", "order_id": "order_123", "description": "Order #123"}'
Response — 201
{
  "success": true,
  "payment_id": "pay_3f9a1c2b7d4e5f60",
  "bill_uid": "3f9a1c2b-7d4e-5f60-…",
  "payment_url": "https://…",
  "expires_at": "2026-11-18T10:00:00+00:00",
  "payment_methods": ["crypto"]
}

Send your customer to payment_url. Keep bill_uid: it identifies the payment in status checks and notifications. A payment created through the API expires 24 hours after creation.

Fields

FieldRequiredMeaning
amountyesAmount as a string or number. Crypto payments in USDT or USD start from 1.
currencyyesPayment currency, e.g. USDT.
order_idnoYour order reference; it comes back in notifications.
descriptionnoWhat the customer pays for.
customer_email, customer_namenoCustomer details for the payment page.
return_url, cancel_urlnoWhere the customer goes after paying or cancelling.
payment_methodsnoMethods to offer, e.g. ["crypto", "card"]. By default — everything the account allows.
webhook_urlnoNotification address for this payment; otherwise the key's default.

2. Check the status

Request
curl https://gate.teleport.ltd/api/crypto-acquiring/v1/invoice/<bill_uid>/ \
  -H "X-API-Key: <YOUR_API_KEY>"

The response carries the payment with its current status: draft, pending, verification, paid, expired and the others described in Link and payment statuses.

Mark an order paid only on a verified signal: a webhook whose signature you have checked, or this request returning status paid. See Webhooks for the signature.

Limits

  • One new payment every 5 seconds per user; faster requests get 429 with the wait time.
  • Errors come back as JSON with success: false and a message in error.

Teleport

Run your financial operations from one place.

Tell us how your business works. We'll show you the platform, map your current financial flow and discuss the right setup.