Hediye kartlarını ve eSIM'leri tek çağrıyla temin edin
Tüm ürün aileleri için tek katalog. Bir sipariş, verdiğiniz anda fiyatlandırılır ve asla belirlediğiniz tavanın üzerine çıkmaz; ön ödemeli cüzdanınız üzerinde idempotent olarak işlenir ve webhook'lar imzalıdır — böylece yeniden denemeler güvenlidir ve lansman günü sıkıcı geçer.
Çalışma alanınız onaylandıktan sonra API anahtarları üye işyeri panelinde oluşturulur ve yönetilir.
Bir sipariş nasıl ilerler
Kısa tek bir döngü — üç çağrı ve imzalı bir webhook — ve tüm ürün aileleri için aynı döngü.
Bir ürün bulun
GET /products
Hediye kartları, eSIM planları ve TL yüklemelerden oluşan tek bir kataloğa kategoriye, ülkeye veya metne göre göz atın — ya da yalnızca sattığınız ürünleri ID ile yenileyin.
Siparişi verin
POST /orders
Ürünü gönderin: Tek çağrıda fiyatlandırılır ve sipariş edilir, asla belirlediğiniz tavanın üzerine çıkmaz. Aynı anahtarla yapılan tekrarlar aynı siparişi döndürür.
Webhook'u alın
order.fulfilled
İmzalı bir olay, teslimat tamamlandığı anda size haber verir. Yoklama döngülerine gerek yok.
Kodu görüntüleyin
POST /orders/{id}/fulfillment
Kodları ve PIN'leri özel, denetlenen bir uç noktadan alın — asla önbelleğe alınmaz, her görüntüleme kayda geçer.
Dilediğiniz dil, sade HTTPS
Temiz ve öngörülebilir bir REST API — JSON girer, JSON çıkar; bir X-Api-Key başlığı yeterli, SDK gerekmez. Bulun, sipariş verin, kodu görüntüleyin: ilk siparişiniz için üç çağrı yeter.
const BASE = "https://integration.xegora.com/api/v1";const response = await fetch(`${BASE}/orders`, { method: "POST", headers: { "X-Api-Key": process.env.XEGORA_API_KEY!, "Content-Type": "application/json", "Idempotency-Key": "order-10231", }, body: JSON.stringify({ clientReference: "po-10231", item: { productId, variantId, quantity: 1, currency: "USD" }, maximumTotal: 60.0, // the price your buyer saw }),});const order = await response.json();// 409 price_above_maximum carries quotedTotal — show the new price insteadconsole.log(order.status); // "reserved" — wait for "fulfilled", then reveal- Idempotent siparişler
- İmzalı webhook'lar
- Kapsamı sınırlı API anahtarları
- Ön yüklemeli cüzdan
Temel API yüzeyi, uçtan uca
Gerçek istek ve yanıt yapıları — herhangi bir satıra tıklayın. Para çekme, para yatırma geçmişi ve ürün görselleri de API'nin kapsamındadır; eksiksiz referans docs.xegora.com adresinde.
POST /api/v1/orders
Ön ödemeli cüzdanınız üzerinden sipariş verin: Ürünü tek çağrıda fiyatlandırıp sipariş etmek için gönderin (isteğe bağlı maximumTotal ile) ya da bir quoteId gönderin. Idempotency-Key başlığı zorunludur — yeniden deneme aynı siparişi döndürür. Kapsam: orders.create.
{
"id": "0198e000-1111-7abc-9def-222233334444",
"clientReference": "po-10231",
"status": "reserved",
"total": 58.50,
"currency": "USD",
"lines": [
{ "productId": "0198d72d-99d6-75a6-9f12-971050ba7a5f", "variantId": "0198d72d-a15b-7cbf-…",
"productName": "Everyday Digital Gift Card", "variantLabel": "50", "quantity": 1,
"unitPrice": 58.50, "currency": "USD", "faceValue": 50, "faceCurrency": "EUR" }
],
"createdAtUtc": "2026-09-05T12:01:02Z",
"updatedAtUtc": "2026-09-05T12:01:02Z"
}Aslında istediğiniz o sıkıcı altyapı
Bir kod temin entegrasyonunun gerçek trafiğe dayanması için gereken her şey — idempotency, imzalar, kapsamı sınırlı kimlik bilgileri ve bakiyesini aşamayan bir cüzdan.
Birleşik katalog
Hediye kartları, eSIM planları ve TL yüklemeler tek bir şemayı, tek bir fiyat akışını ve tek bir sipariş akışını paylaşır. Bir kez entegre olun; Xegora'nın eklediği her ürün otomatik olarak sizin de olsun.
Idempotent siparişler
Hem sipariş oluşturma hem de teslimat görüntüleme bir Idempotency-Key başlığı alır. Ağ kesintisi, zaman aşımı, agresif yeniden deneme döngüsü — isteği dilediğiniz kadar tekrarlayın, yalnızca tek bir sipariş oluşur.
İmzalı webhook'lar
order.processing, order.fulfilled, order.failed, order.refunded ve wallet.credited olayları HTTPS üzerinden HMAC-SHA256 imzasıyla (X-Xegora-Signature) iletilir, en az bir kez teslim ilkesiyle yeniden denenir ve sabit bir X-Xegora-Event-Id ile tekilleştirilir.
En az yetkili anahtarlar
Her anahtarın açıkça tanımlanmış bir kapsam kümesi vardır — katalog okuma, fiyat teklifi alma, sipariş verme, cüzdan okuma ve para hareketi kapsamlarının her biri ayrıdır — ayrıca isteğe bağlı bir CIDR izin listesi ve son kullanma tarihi de tanımlanabilir. İptal anında geçerli olur.
Ön yüklemeli cüzdan
Siparişler ön ödemeli bakiyenizden tutarı rezerve eder ve teslimatta tahsil eder; başarısız siparişlerde rezervasyon otomatik olarak serbest bırakılır. Bakiyenizi zincir üstünde kalıcı bir para yatırma adresine gönderim yaparak yükleyin; kullanılmayan tutarları yalnızca kendi kayıtlı ödeme bilgilerinize çekebilirsiniz.
Seçim için tasarlanmış katalog
Kategoriye, ülkeye veya metne göre göz atın; sabit ya da özel tutarlara göre daraltın ve sattığınız ürünleri tek çağrıda ID ile yenileyin — her üründe kullanım adımları ve markanın diğer ülkeleri yer alır, fiyatlar satış para biriminizdedir.
Toptan fiyatlar, sürpriz yok
Fiyat teklifi, fiyatın ta kendisidir. Ticari koşullarınıza ilişkin diğer her şey, üye işyeri çalışma alanınız kurulurken kararlaştırılır.
- Satış para biriminizde toptan ürün fiyatlandırması — cüzdanınızdan tam olarak fiyat teklifindeki toplam düşülür
- Çağrı başına gizli ücret yok; çalışma alanı başına dakikada sabit 120 istek sınırı
- Çalışma alanı planınız (kurulum ve koşullar) üye işyeri kaydı sırasında kararlaştırılır
- Kullanılmayan tutarların çekimi şeffaf biçimde fiyatlandırılır — ücret, net tutar ve ödeme tarihi baştan belli
İlk siparişinizi vermeye hazır mısınız?
Hesabınızdan üye işyeri çalışma alanı için başvurun, onay alın ve panelden kapsamı sınırlandırılmış API anahtarları oluşturun — ilk siparişiniz artık yalnızca üç çağrı uzağınızda. Eksiksiz referans docs.xegora.com adresinde sizi bekliyor.