COTA eSIM
COTA PARTNER API

Trafiği bizden alın, markayı siz koyun.

Seyahat eSIM kataloğumuzun tamamı tek bir REST API’nin arkasında. Toptan fiyattan satın alın, kendi fiyatınızla satın; teslimat, kullanım takibi ve iade akışı bizde kalsın. Entegrasyon bir öğleden sonra sürüyor.

Partner portalına girAPI dokümanını aç

Sandbox ortamı ücretsiz — canlıya geçmeden önce siparişi uçtan uca deneyin.

İlk siparişiniz
curl -X POST https://api.cotaesim.com/partner/v1/orders \
  -H "Authorization: Bearer $COTA_TOKEN" \
  -H "Idempotency-Key: PO-2026-00931" \
  -H "Content-Type: application/json" \
  -d '{ "planSlug": "fr-7d-1gb", "quantity": 2 }'

{
  "orderId": "por_7f3a…",
  "status": "completed",
  "unitPriceCents": 499,
  "requestedQuantity": 2,
  "fulfilledCount": 2,
  "esims": [
    { "esimId": "esim_1a2b…",
      "lpa": "LPA:1$smdp.example.com$ABC-123-XYZ",
      "universalLink": "https://esimsetup.apple.com/…",
      "qrUrl": "/partner/v1/esims/esim_1a2b…/qr.png" }
  ]
}
  • SandboxCanlıyla aynı uçlar, ayrı bakiye ve sahte eSIM
  • Tek uçSipariş, teslimat ve QR aynı yanıtta
  • Webhookİmzalı olaylar, 8 basamaklı yeniden deneme
  • MobilSiparişlerinizi telefondan takip edin
BAŞLANGIÇ

Dört adımda satışa başlayın

  1. 01

    Kimliğinizi alın

    Sizin için bir partner hesabı açıyoruz. clientId ve clientSecret ile 24 saatlik erişim jetonu alıyorsunuz; jeton opak, yani gerektiğinde tek hamlede iptal edilebiliyor.

  2. 02

    Sandbox’ta uçtan uca deneyin

    Sandbox modu canlıyla aynı uçları, aynı doğrulamaları ve aynı hata kodlarını verir; farkı ayrı bir bakiyeden düşmesi ve test eSIM’i döndürmesi. Entegrasyonu para harcamadan bitirirsiniz.

  3. 03

    Canlıya geçiş talebi

    Portaldan tek düğmeyle canlıya geçiş isteyin. Ekibimiz hesabınızı açar, canlı kimliğiniz aynı kod yolundan çalışır — değiştirmeniz gereken tek şey ortam değişkeni.

  4. 04

    Hesabınızı açın, satın

    İki çalışma biçimi var: ön ödemeli bakiye ya da tanımlı bir kredi limiti. Hangisi olursa olsun her sipariş anında düşer ve her hareket yalnız-eklemeli deftere yazılır — ne harcadığınızı ay sonunu beklemeden görürsünüz.

FARKIMIZ

Toptan eSIM’de alışılmış olan ve bizim yaptığımız

Aşağıdaki satırların çoğu, entegrasyonun ilk haftasında değil altıncı ayında canınızı yakan şeyler. Onları baştan çözdük.

  • Test ortamı

    Sektörde alışılmışSandbox ya hiç yok ya da canlıdan farklı davranıyor; entegrasyonu gerçek parayla deniyorsunuz.

    COTA Partner APISandbox canlıyla aynı kod yolunu kullanır — aynı doğrulama, aynı hata kodları, ayrı bakiye. Ortam, idempotency anahtarının da parçasıdır: sandbox’taki bir sipariş canlı isteğe asla karışmaz.

  • Kısmi teslimat

    Sektörde alışılmışOn adet istediniz, yedisi geldi. Kalan üçün parası hesabınızda “kayıp” kalıyor, destek bileti açıyorsunuz.

    COTA Partner APITeslim edilemeyen her birimin tutarı aynı işlemin içinde bakiyenize geri yazılır. Yanıtta requestedQuantity ve fulfilledCount ayrı ayrı döner — ne olduğunu tahmin etmezsiniz.

  • Tekrarlanan istek

    Sektörde alışılmışZaman aşımında yeniden denemek ikinci siparişi ve ikinci faturayı doğuruyor.

    COTA Partner APIIdempotency-Key gönderin; aynı anahtar ilk yanıtın aynısını döndürür, ikinci kez ücret çıkmaz. Eşzamanlı iki istekte biri kilidi alır, diğeri bekler.

  • Tedarikçi arızası

    Sektörde alışılmışTedarikçi düşünce sipariş düşer; ne olduğunu size kimse söylemez.

    COTA Partner APIKesin olumsuz cevapta otomatik olarak yedek tedarikçiye geçeriz. Cevap hiç gelmediyse GEÇMEYİZ ve satırı “belirsiz” işaretleriz — çünkü aynı birimi iki kez satın almak sizin de bizim de maliyetimiz.

  • Hesap görünürlüğü

    Sektörde alışılmışAy sonu ekstresi. Aradaki her şey kara kutu.

    COTA Partner APIYalnız-eklemeli defter: her borç ve alacak satırı, sebebiyle birlikte anında GET /ledger üzerinden okunabilir. Ön ödemeli de çalışabilirsiniz, tanımlı kredi limitiyle de; ikisinde de canlı ve sandbox hesapları ayrı tutulur.

  • Olay bildirimi

    Sektörde alışılmışYoklama (polling). Siparişin durumunu öğrenmek için sürekli sorarsınız.

    COTA Partner APIİmzalı webhook: olay iş işleminin İÇİNDE üretilir, yani sipariş kapanıp bildirim kaybolmaz. Ulaşamazsak 8 basamaklı artan aralıkla yeniden deneriz, adresiniz sağlıksız işaretlenirse size e-posta gider.

  • İade

    Sektörde alışılmışE-posta trafiği ve belirsiz süre. Talebin nerede olduğunu bilmezsiniz.

    COTA Partner APIAPI’den iade TALEBİ açarsınız; durumunu GET /refunds ile izlersiniz. Onaylandığında alacak, durum değişikliğiyle aynı işlemde deftere düşer — “onaylandı ama para yatmadı” hâli tanım gereği imkânsız.

  • Operasyon takibi

    Sektörde alışılmışMasaüstü panel. Ofisten çıkınca görünürlük biter.

    COTA Partner APIAynı hesapla mobil uygulamamızdan partner tarafına geçip siparişlerinizi, eSIM’lerinizi ve defterinizi telefondan izlersiniz.

MOBİL TAKİP

Operasyonunuz cebinizde

Partner tarafı yalnız masaüstünde kalmıyor. COTA E-SIM uygulamasına kendi partner e-postanızla girdiğinizde “partner hesabına geç” seçeneği çıkar ve aynı uygulamanın içinde ticari tarafınıza geçersiniz.

  • Yalnızca yetkili görür

    E-postanız tanımlı bir partner kullanıcısı değilse uygulamada partnerle ilgili hiçbir düğme, hiçbir ipucu görünmez. Sıradan bir müşteri için uygulama hiç değişmemiştir.

  • Takip için, satış için değil

    Mobil taraf bilerek salt-izleme: sipariş açmak, kimlik döndürmek gibi geri alınamaz işler portalda ve API’de kalır. Telefonda yanlışlıkla basılan bir düğme para harcayamaz.

  • iOS ve Android’de birebir aynı

    İki platformda da aynı ekranlar, aynı sırayla. Ekibinizin hangi telefonu kullandığı eğitim farkı yaratmaz.

  • Davetle açılan erişim

    Ekip arkadaşınızı e-postayla davet edersiniz; hesap ancak o kişi kendi posta kutusundaki bağlantıyı onayladıktan sonra aktif olur. Yanlış yazılmış bir adres kimseye kapı açmaz.

Aynı ekranlar partner.cotaesim.com üzerindeki web portalında da var — kimlik yönetimi, webhook ayarları ve canlıya geçiş talebi orada.

API YÜZEYİ

Öğrenmesi bir öğleden sonra süren bir yüzey

Toplam yirmiden az uç: kimlik, katalog, sipariş, eSIM yaşam döngüsü, hesap hareketleri ve webhook. Hepsi aynı kimlik doğrulamasını, aynı hata sözleşmesini ve aynı sayfalama biçimini kullanıyor — birini öğrendiğinizde hepsini öğrenmiş olursunuz.

  • İş hataları makine tarafından okunabilen bir code ile 422 döner; 429 yalnızca hız sınırı demektir, başka hiçbir anlamı yoktur.
  • Sipariş, teslimat ve QR tek yanıtta gelir — ikinci bir çağrı beklemezsiniz.
  • Her uç hem sandbox hem canlı kimlikle aynı şekilde çalışır.
OpenAPI

Uçların tamamı, istek/yanıt şemaları ve hata kodları OpenAPI dokümanında — deneyebileceğiniz canlı bir referans.

Tam API dokümanını aç
SIK SORULANLAR

Merak edilenler

Fiyatı ben mi belirliyorum?

Evet. Size toptan fiyattan satarız, son müşteriye uyguladığınız fiyat tamamen sizin kararınız. Katalogda gördüğünüz tutar bizim sizden alacağımız tutardır.

Kendi markamla satabilir miyim?

Evet — API ham teslimat verisi döndürür (LPA dizesi, iOS evrensel bağlantısı, QR görseli). Bunları kendi uygulamanızda, kendi e-postanızda, kendi tasarımınızla sunarsınız. Son müşteri bizi görmez.

Ön ödemeli mi, kredili mi?

İkisi de var. Ön ödemelide yüklediğiniz bakiye her siparişte anında düşer ve bakiye bitince sipariş açılmaz — hiç beklemediğiniz bir borç birikmez. Kredili çalışmada ise size tanımlı bir limit kadar bakiyenizin altına inebilirsiniz; hangi biçimde olduğunuz hesabınızda tanımlıdır ve GET /balance bunu size de bildirir. Kredi yalnızca canlı hesapta geçerlidir, sandbox her zaman kendi test bakiyesiyle çalışır. Her iki biçimde de eşiğin altına inince uyarılırsınız.

İade otomatik mi işliyor?

Hayır, bilerek. POST /refunds yalnızca bir TALEP açar; kararı ekibimiz verir. Onaylandığı anda alacak, durum değişikliğiyle aynı işlemde defterinize yazılır. Kararın gerekçesi de talebin üzerinde görünür.

Sandbox gerçekten canlıyla aynı mı?

Aynı uçlar, aynı doğrulama kuralları, aynı hata kodları ve aynı webhook olayları. Farkı: ayrı bakiyeden düşer ve test alanına işaret eden sahte bir eSIM döndürür. Gerçek bir hat kurulmaz.

Ekibimden birden fazla kişi girebilir mi?

Evet. Portala ve mobil tarafa istediğiniz sayıda kullanıcı davet edebilirsiniz; giriş e-posta + tek kullanımlık kodla yapılır, parola yok. Her davet, sahibinin posta kutusundan onaylanana kadar pasif kalır.

Teknik ekibim yoksa?

Portalın kendisi API’nin yaptığı işlerin çoğunu ekrandan yapmanızı sağlar: katalog, sipariş geçmişi, eSIM detayları, defter ve iade talepleri. API’yi hiç yazmadan da çalışmaya başlayabilirsiniz.

Kataloğu görmek için konuşalım

Size özel fiyat kitabınızı çıkarıp sandbox kimliğinizi açalım; entegrasyonu kendi hızınızda deneyin. Canlıya geçiş, siz hazır olduğunuzda tek düğme.

Partner başvurusuPortala giriş