Ortak API Programı

Referans API'si (ref_id)

Satın alma isteğine bir ref_id ekle, aktivasyon onaylandığında cirodan pay kazan.

Nasıl çalışır

Her ref_id ödülünün arkasındaki mekanik.

ref_id'ni taşıyan her onaylanan aktivasyonun cirosundan %5 kazanırsın. İstisna: satışın kârı çok düşükse ödül o kârın bir payıyla sınırlanır. Bu sınır bugüne kadar hiç uygulanmadı.

Ödül SADECE aktivasyon onaylandığında, yani doğrulama kodu gerçekten geldiğinde oluşur. İptal edilen veya iadesi yapılan bir aktivasyon hiçbir kazanç sağlamaz.

Ödüller bekleme süresi olmadan, anında cüzdan bakiyene eklenir.

API kazançları cüzdan kredisidir: alt sınır ve çekim talebi yoktur, ancak nakde çevrilemez. Platformdaki her üründe harcayabilirsin.

ref_id gönderme

İki API rayı da aynı referans kodunu kabul eder; sadece taşıma biçimi farklıdır.

Modern API (v1, JSON gövdesi)

curl -X POST "https://smsbulk.net/api/v1/activations" \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "serviceCode": "wa",
    "countryIso": "US",
    "ref_id": "K7M2QXWP"
  }'

{
  "id": "act_9f1c...",
  "status": "PENDING",
  "phoneNumber": "+1...",
  "referral": {
    "accepted": true,
    "reason": null
  }
}

SMS-Activate uyumlu ray (query parametresi)

curl "https://smsbulk.net/stubs/handler_api.php\
?api_key=YOUR_KEY&action=getNumber&service=wa&country=187&ref_id=K7M2QXWP"

ACCESS_NUMBER:12345678:79991234567

Ortakların en çok yanlış anladığı iki kural

Bu iki koruma, programı kendi kendine ödeme ve çifte ödemeden korur. Bir ödül oluşmadıysa neredeyse her zaman sebep bunlardan biridir.

Kendi kendine ödeme (self-dealing) engellenir

ref_id, satın almayı yapan hesabın kendisine aitse hiçbir ödül oluşmaz. Kendi ref_id'ni kendi trafiğine koymak asla komisyon kazandırmaz.

Zaten bağlı hesaplar yok sayılır

Alıcı, kayıt sırasında zaten o ortağın referans bağlantısıyla kaydolduysa, satın almada aynı ortağın ref_id'sini göndermek yok sayılır: ilişki zaten var, ikinci bir ödül oluşmaz. Farklı bir ortağın ref_id'si normal şekilde çalışmaya devam eder.

Geçersiz bir ref_id satın almayı asla engellemez

Tanınmayan, hatalı biçimli veya süresi geçmiş bir ref_id sessizce yok sayılır. Satın alma, geçerli bir referans kodu olsun ya da olmasın her zaman normal şekilde tamamlanır.

v1 yanıtındaki referral alanı

POST /v1/activations, referral nesnesini SADECE istek bir ref_id gönderdiyse ekler. Hiç göndermeyen istekler öncekiyle birebir aynı yanıt biçimini alır.

accepted: true, ref_id'nin kabul edilip bu aktivasyona bağlandığı anlamına gelir. Ödülün kendisi daha sonra, aktivasyon onaylandığında yazılır.
accepted: false, hiçbir ödül oluşmadığı anlamına gelir; aşağıdaki reason değerine bak.

reason değerleri

reason	Anlamı
unknown_code	ref_id hiçbir ortağın koduyla eşleşmiyor. Geçersiz kod denemeleri hız sınırına tabidir.
self_dealing	ref_id, satın almayı yapan hesabın kendisine ait.
already_referred	Alıcı kayıt sırasında zaten bu ortağa bağlı; kod hata olarak değil, yok sayılarak ele alınır.
referrer_inactive	Bu ref_id'nin sahibi olan ortak hesabı pasif veya yasaklı.

SMS-Activate uyumlu rayda referral alanı yoktur

Bu protokol JSON değil, ACCESS_NUMBER:id:phoneNumber gibi düz metin bir satır döner; bu yüzden accepted/reason bilgisini taşıyacak bir alan yoktur. ref_id bu rayda da aynı şekilde çalışır, yalnızca sonucu yanıtta göremezsin. Onay için ortaklık panelini kontrol et.

API trafiğinden kazanmaya başla

Referans kodunu ortaklık panelinden al ve entegrasyonuna ekle.

Ortaklık panelini aç Dokümana Dön