İzin Yönetimi

İYS kapsamında müşteri izinlerini Verimor API üzerinden yönetebilirsiniz.

İzin Gönderme

Topladığınız onayları İYS’ye bildirmek için /v2/iys_consents.json endpoint’ini kullanın.

POST https://sms.verimor.com.tr/v2/iys_consents.json

{
  "username": "[email protected]",
  "password": "api_sifreniz",
  "source_addr": "BASLIGINIZ",
  "consents": [
    {
      "recipient": "905001234567",
      "status": "ONAY",
      "type": "MESAJ",
      "source": "HS_WEB",
      "consent_date": "2024-01-15 10:30:00",
      "recipient_type": "BIREYSEL"
    }
  ]
}

source_addr boş bırakılırsa hesabınızdaki İYS kodları tanımlı ilk başlık kullanılır.

İzin Parametreleri

Parametre	Değerler	Açıklama
`recipient`	string	Alıcı telefon numarası (type=EPOSTA ise e-posta adresi)
`status`	`ONAY` / `RET`	İzin durumu
`type`	`MESAJ` / `ARAMA` / `EPOSTA`	İleti türü
`source`	Aşağıdaki tabloya bakın	İzin kaynağı
`recipient_type`	`BIREYSEL` / `TACIR`	Alıcı tipi
`consent_date`	`YYYY-MM-DD HH:MM:SS`	İzin tarihi (1 Mayıs 2015’ten önce olamaz, `BIREYSEL` için zorunlu)

İzin Kaynağı (source) Değerleri

Değer	Açıklama
`HS_WEB`	Web Sitesi
`HS_FIZIKSEL_ORTAM`	Fiziksel Ortam
`HS_ISLAK_IMZA`	Islak İmza
`HS_CAGRI_MERKEZI`	Çağrı Merkezi
`HS_SOSYAL_MEDYA`	Sosyal Medya
`HS_EPOSTA`	E-posta Yoluyla
`HS_MESAJ`	Mesaj Yoluyla
`HS_MOBIL`	Mobil Uygulama
`HS_EORTAM`	Elektronik Ortam
`HS_ETKINLIK`	Etkinlik
`HS_ATM`	ATM
`HS_KARAR`	HS Kararıyla (yalnızca `RET` ile kullanılır)

İzin Kampanya Sorgulama

İYS’ye gönderilen izinlerin işlenme durumunu sorgulayın.

GET https://sms.verimor.com.tr/v2/iys/campaigns

curl "https://sms.verimor.com.tr/v2/iys/[email protected]&password=api_sifreniz"

Kampanya Detayı

GET https://sms.verimor.com.tr/v2/iys/campaigns/{id}/consents

curl "https://sms.verimor.com.tr/v2/iys/campaigns/123/[email protected]&password=api_sifreniz"

Vatandaşlar her gün E-Devlet, İYS web/mobil veya çağrı merkezi üzerinden izin değişikliği yapabilir. Bu değişiklikler gün sonunda toplu bir kampanya olarak oluşturulur ve Verimor, OİM’de tanımladığınız URL’ye bildirim gönderir.

OİM’de URL tanımlamak için: SMS Ayarlarım → İYS Push URL

POST https://sizin.adresiniz.com.tr/iys_push
Content-Type: application/json

{
  "iys_campaign_id": 1234,
  "report_date": "2025-06-01",
  "source_addr": "BASLIGINIZ"
}

Alan	Açıklama
`iys_campaign_id`	Oluşturulan kampanyanın ID’si
`report_date`	Değişikliklerin ait olduğu tarih
`source_addr`	İlgili başlık

Bildirimi aldıktan sonra iys_campaign_id ile Kampanya Detayı endpoint’ini sorgulaarak değişen izinlerin listesini alabilirsiniz.

İYS Hata Kodları

Kod	Açıklama	Çözüm
`MISSING_IYS_BRAND_CODE`	Marka kodu tanımlanmamış	OİM’den başlığa marka kodu ekleyin
`AHS_AUTHORIZATION_ERROR`	İYS yetkilendirme hatası	İYS’den Verimor’a AHS izni verin
`NO_AHS_BRAND_ERROR`	VKN’ye kayıtlı marka yok	İYS’de marka kaydı yapın
`INVALID_IYS_RECIPIENT_TYPE`	Geçersiz alıcı tipi	`BIREYSEL` veya `TACIR` kullanın
`INVALID_CONSENT_DATE`	Geçersiz onay tarihi	1 Mayıs 2015’ten önce olamaz
`NOT_ALLOWED_BY_IYS`	İYS izni yok	Alıcının onayı bulunmuyor