API
Русский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
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"}'{
"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
| Field | Required | Meaning |
|---|---|---|
| amount | yes | Amount as a string or number. Crypto payments in USDT or USD start from 1. |
| currency | yes | Payment currency, e.g. USDT. |
| order_id | no | Your order reference; it comes back in notifications. |
| description | no | What the customer pays for. |
| customer_email, customer_name | no | Customer details for the payment page. |
| return_url, cancel_url | no | Where the customer goes after paying or cancelling. |
| payment_methods | no | Methods to offer, e.g. ["crypto", "card"]. By default — everything the account allows. |
| webhook_url | no | Notification address for this payment; otherwise the key's default. |
2. Check the status
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.