> For the complete documentation index, see [llms.txt](https://developer.nilvera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.nilvera.com/api/e-gider-api/sms-dogrulama.md).

# SMS Doğrulama

E-Gider Pusulası düzenlenirken alıcının onayı SMS ile alınabilir. Bu bölümdeki uçlar ile alıcının telefon numarasına 6 haneli, tek kullanımlık bir doğrulama kodu gönderilir ve alıcıdan alınan kod doğrulanır. Doğrulanan kod, gider pusulasının `VerificationInfo` alanına eklenerek belge ile birlikte gönderilir.

### SMS Doğrulama Sahibi

SMS doğrulamasının kim tarafından yapılacağı, Genel API altındaki [E-Gider SMS Doğrulama Sahibini Değiştirir](https://developer.nilvera.com/api/genel-api/mail-islemleri/e-gider-sms-dogrulama-sahibini-degistirir) ucu ile belirlenir. Bu uç iki değer alır:

* `Integrator`: Doğrulama, Nilvera (entegratör) tarafından yapılır. Kod gönderimi ve doğrulama, bu bölümdeki uçlar ile gerçekleştirilir. Bu durumda belgede `ServiceProviderInfo` alanı gönderilmez.
* `Customer`: Doğrulama, müşteri tarafından kendi altyapısı veya SMS sağlayıcısı ile yapılır. Bu durumda belgede `ServiceProviderInfo` alanının doldurulması zorunludur.

{% hint style="info" %}
Mail ayarlarından SMS doğrulama sahibi ayarı yapılmamışsa doğrulama **varsayılan olarak entegratör** (`Integrator`) tarafından yapılır.
{% endhint %}

{% hint style="warning" %}
SMS doğrulama sahibi `Customer` olarak ayarlanırsa SMS gönderimi, kodun alıcıdan alınması, doğrulanması ve doğrulama bilgilerinin belgede doğru gönderilmesi **tamamıyla müşterinin sorumluluğundadır**. Bu durumda Nilvera kodun gerçekten doğrulanıp doğrulanmadığını kontrol etmez; yalnızca `VerificationInfo` alanlarının eksiksiz ve doğru biçimde gönderilmesini bekler. `ServiceProviderInfo` alanının, doğrulama hizmetini sunan sağlayıcının unvanı ve vergi numarası ile doldurulması zorunludur.
{% endhint %}

### Doğrulama Akışı

Entegratör tarafından yapılan SMS doğrulaması üç adımdan oluşur:

1. **Kod gönderilir:** [Doğrulama Kodu Gönderir](https://developer.nilvera.com/api/e-gider-api/sms-dogrulama/dogrulama-kodu-gonderir) (`POST /SmsVerification/Send`) ucuna gider pusulasının `UUID` değeri ve alıcının telefon numarası (`Phone`) gönderilir. Alıcının telefonuna 6 haneli doğrulama kodu iletilir.
2. **Kod doğrulanır:** Alıcıdan alınan kod, aynı `UUID` ile [Kodu Doğrular](https://developer.nilvera.com/api/e-gider-api/sms-dogrulama/kodu-dogrular) (`POST /SmsVerification/Verify`) ucuna gönderilir.
3. **Belge gönderilir:** Doğrulanan kod; telefon numarası ve doğrulama yöntemi ile birlikte gider pusulasının `ExpenseInfo.VerificationInfo` alanına eklenir ve belge gönderilir.

```json
VerificationInfo: {
  Type: "SMS",
  Phone: "5551234567",
  Code: "123456"
}
```

{% hint style="info" %}
Kod gönderimi, kod doğrulama ve belge gönderiminde **aynı UUID** kullanılmalıdır. Belgedeki `ExpenseInfo.UUID` değeri, SMS gönderiminde kullanılan UUID ile aynı olmalıdır.
{% endhint %}

### Süre ve Gönderim Kuralları

* Aynı UUID için **180 saniye içinde yalnızca 1 kez** doğrulama kodu gönderilebilir. Bu süre dolmadan yapılan tekrar istekler `422` hatası ile reddedilir.
* Doğrulanan kodun geçerlilik süresi **180 saniyedir**. Kod, bu süre içinde ilgili gider pusulasında kullanılarak belge gönderilmelidir.
* Süre dolarsa kod geçersiz olur. Aynı UUID için yeni kod gönderilmeli ve doğrulama adımları tekrarlanmalıdır.

{% hint style="warning" %}
Kod doğrulandıktan sonra belgeyi **180 saniye içinde** gönderin. Aksi halde kodun süresi dolar ve belgedeki doğrulama bilgisi geçersiz sayılır.
{% endhint %}

### Senaryolara Göre Doğrulama Yöntemi

Doğrulama yöntemi, `VerificationInfo.Type` alanında `SMS` veya `IADEKODU` olarak belirtilir. Kullanılabilecek yöntem, belgenin senaryosuna göre değişir:

| Senaryo | SMS            | IADEKODU       |
| ------- | -------------- | -------------- |
| Satış   | Kullanılabilir | Kullanılamaz   |
| İade    | Kullanılabilir | Kullanılabilir |
