For developers

पार्टनर्स के लिए API.

REST API for partners. Single Bearer key, idempotent requests, JSON in/out — zero ceremony.

Swagger खोलें की लें

BASE URL

https://api.theopenmoney.info/api/v1

Auth

Authorization: Bearer

Format

REST · JSON

Quickstart

पहले ऑर्डर तक तीन क़दम.

Step 01

की प्राप्त करें

बॉट को /api भेजें — वो osk_… की देगा. इसे गुप्त रखें.

Step 02

रिक्वेस्ट भेजें

POST /orders/stars रिसीवर और मात्रा के साथ.

Step 03

रिज़ल्ट लें

रेस्पॉन्स में order_id, पेमेंट पता, memo और TTL.

POST /orders/stars

curl -X POST https://api.theopenmoney.info/api/v1/orders/stars \
  -H "Authorization: Bearer $KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient_username": "pandus",
    "quantity": 100,
    "payment_method": "ton_memo",
    "payment_currency": "TON",
    "client_reference": "invoice-42"
  }'

200 OK · JSON response

{
  "ok": true,
  "data": {
    "id": 10421,
    "status": "pending_payment",
    "order_type": "stars",
    "stars_amount": 100,
    "recipient_username": "pandus",
    "price_ton": 0.418,
    "payment_address": "UQBFJTkJ5hZdH7i6rWQTnm43zn6h2dPBV9lFZ2e98WvWABy_",
    "payment_memo": "STARS-a1b2c3",
    "expires_at": "2026-04-16T12:15:00Z",
    "created_at": "2026-04-16T12:00:00Z"
  }
}

Auth

एक हेडर.

हर रिक्वेस्ट Authorization: Bearer osk_… हेडर से ऑथेंटिकेट होती है. एक की = एक पार्टनर और एक TON टॉप-अप पता.

की को क्लाइंट कोड या URL में कभी मत डालें.
Rate limit प्रति की काम करता है.
लीक हो गई? रद्द करें और बॉट से नई लें.

HTTP request

GET /api/v1/balance HTTP/1.1
Host: api.theopenmoney.info
Authorization: Bearer osk_••••••••••••••••
Accept: application/json

Endpoints

सभी endpoints.

Swagger में

Orders

POST/orders/starsCreate a Stars order
POST/orders/premiumCreate a Premium order (3 / 6 / 12 months)
GET/orders/{id}Get order by ID
GET/ordersList orders
GET/orders/by-memo/{memo}Find order by payment_memo
GET/orders/by-reference/{ref}Find orders by your client_reference
GET/orders/stats/summaryAggregate stats
POST/orders/{id}/cancelCancel a pending_payment order

Pricing

GET/pricing/ton-rateCurrent TON/USD rate
GET/pricing/feeService fees and min/max limits
GET/pricing/estimate/starsEstimate Stars price in TON
GET/pricing/estimate/premiumEstimate Premium price in TON

Recipients

GET/recipients/starsCheck if a username can receive Stars
GET/recipients/premiumCheck if a username can receive Premium

Balance

GET/balancePartner balance and top-up address
GET/balance/transactionsBalance transactions history

Health

GET/healthService health probe

Examples

curl रेसिपी.

Stars ऑर्डर बनाएं

POST /orders/stars

curl -X POST https://api.theopenmoney.info/api/v1/orders/stars \
  -H "Authorization: Bearer $KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient_username": "pandus",
    "quantity": 100,
    "payment_method": "ton_memo",
    "payment_currency": "TON",
    "client_reference": "invoice-42"
  }'

ऑर्डर स्टेटस देखें

GET /orders/{id}

curl https://api.theopenmoney.info/api/v1/orders/10421 \
  -H "Authorization: Bearer $KEY"

रिसीवर जांचें

GET /recipients/stars

curl "https://api.theopenmoney.info/api/v1/recipients/stars?username=pandus" \
  -H "Authorization: Bearer $KEY"

क़ीमत हिसाब लगाएं

GET /pricing/estimate/stars

curl "https://api.theopenmoney.info/api/v1/pricing/estimate/stars?quantity=100" \
  -H "Authorization: Bearer $KEY"

Reliability

Retry-safe by design.

Idempotency-Key

Idempotency-Key हेडर में कोई भी UUID भेजें — उसी की के साथ retry वही ऑर्डर लौटाता है, नया नहीं बनाता. Timeout और retries के लिए ज़रूरी.

Header

Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000

client_reference

ऑर्डर बनाते समय वैकल्पिक रूप से अपनी ID (इनवॉइस नंबर, payment_id) जोड़ें. बाद में: GET /orders/by-reference/{ref} सभी जुड़े ऑर्डर लौटाता है.

Body field

{
  "client_reference": "invoice-42"
}

एक फ़ॉर्मेट.

सभी एरर एक ही JSON: ok=false, पठनीय error_code और error_message.

आम कोड

401: Bearer token नहीं या अमान्य
404: रिसोर्स नहीं मिला (या आपकी की का नहीं)
409: स्टेट कॉन्फ़्लिक्ट — जैसे, भुगतान हो चुका ऑर्डर रद्द नहीं हो सकता
422: रिक्वेस्ट पैरामीटर अमान्य
429: Rate limit पार

Error response

{
  "ok": false,
  "error_code": "VALIDATION_ERROR",
  "error_message": "quantity must be between 50 and 10000",
  "data": null
}

शुरू करने केलिए तैयार?

पूरा इंटरैक्टिव स्कीमा Swagger में है. की — बॉट में एक कमांड दूर.

Swagger की लें