Tüm metotlar GramPay-API-Token ister. Geçersiz token 401 UNAUTHORIZED, eksik scope 403 FORBIDDEN döndürür.

Metotlar

  • GET /api/getMe: uygulama UUID’si, adı ve durumu.
  • POST /api/createInvoice: zorunlu amount (USD, >0, en fazla 2 ondalık); isteğe bağlı public_description (1–256), internal_note (160’a kadar), payload, expires_in (60–86.400; varsayılan 1.800), paid_btn_name, paid_btn_url.
  • GET /api/getInvoice: önce payload, sonra public_id/hash/id ile arar.
  • GET /api/getInvoices: sayfa başına 50; page, status, virgülle ayrılmış public_ids.
  • POST /api/cancelInvoice: aktif faturayı public_id ile iptal eder; deleteInvoice aynı davranışın alias’ıdır.
  • GET /api/getStats: today, yesterday, week, month, previous_month, last_30_days, all_time.

Idempotency ve hatalar

Idempotency-Key 1–128 harf, rakam, -_.: içerebilir. Aynı parametreler özgün faturayı ve Idempotent-Replayed: true döndürür; farklı parametreler 409 IDEMPOTENCY_KEY_REUSED verir. Anahtar uygulamaya aittir ve token yenilemesinden etkilenmez.

Başlıca hatalar: INVALID_AMOUNT, INVALID_PARAMS, ROUTE_NOT_AVAILABLE, INVALID_IDEMPOTENCY_KEY, INVOICE_NOT_FOUND, INVALID_STATUS. 402 account_not_serviceable normal envelope’i kullanmaz; üst düzey error, message ve billing döndürür.

Fatura nesnesi

Alanlar: public_id/hash, status, USD/USDT/USDC tutarları, paid_token, ağ anahtarı olan paid_source, açıklama/not/payload, iki URL, tx_hash ve zaman alanları. Durumlar active, paid, expired, cancelled; elle ödenen de paid olarak serialize edilir. Tutarlar string’dir; decimal kullanın.

← Tüm bölümler ← Hızlı başlangıç: kimlik doğrulama ve ilk fatura Sonraki bölüm: Webhook'lar: imza, doğrulama ve tekrarlar →

Sonraki adım

Onaylanan ilk 50 ödeme bizden.

5$ krediyle başla ↗