İzibiz Developer Portal
E-Müstahsil REST API

SMS Doğrulama Kodunu Doğrulama

POST{{baseUrl}}/{{v2}}/ecreditnotes/outbox/verify-sms-code

Müstahsilin telefonuna POST {{baseUrl}}/{{v2}}/ecreditnotes/outbox/send-sms-code servisi ile gönderilen SMS kodunu, telefon numarası ile birlikte doğrular. Başarılı doğrulamada status değeri VERIFIED döner.

e-Müstahsil Makbuzuna yansıtma: Doğrulama yanıtında dönen değerler, GİB e-Müstahsil Makbuzu Teknik Kılavuzu V1.1'e göre belgede aşağıdaki alanlara yazılır ve POST {{baseUrl}}/{{v2}}/ecreditnotes/send servisi ile gönderilir:

Doğrulama yanıtı REST gönderim alanı (JSON) UBL-TR alanı
phoneNumber customerParty.address.telephone AccountingCustomerParty/Party/Contact/Telephone
"SMS" (sabit değer) customerParty.address.name AccountingCustomerParty/Party/Contact/Name
code customerParty.address.id AccountingCustomerParty/Party/Contact/ID
"SMS_PROVIDER" (sabit değer) supplierParty.address.otherCommunication.name .../OtherCommunication/ChannelCode/@name
smsProvider supplierParty.address.otherCommunication.channelCode AccountingSupplierParty/Party/Contact/OtherCommunication/ChannelCode
smsProviderVkn supplierParty.address.otherCommunication.value AccountingSupplierParty/Party/Contact/OtherCommunication/Value

Yanıt alanları:

Alan Açıklama
status İşlemin durum değeri. Başarılı doğrulamada VERIFIED döner.
phoneNumber Doğrulanan telefon numarası.
smsProvider SMS'i gönderen sağlayıcının adı.
smsProviderVkn SMS sağlayıcının VKN'si.
code Doğrulanan SMS kodu.

Header Parametreleri

AdTipZorunluAciklama
Authorization text Evet v1/auth/token endpointten alınan token

Body Parametreleri

AdTipZorunluAciklama
phoneNumber text Evet SMS kodunun gönderildiği müstahsilin telefon numarası.
code text Evet Müstahsilin ilettiği SMS doğrulama kodu. Örnek: "123456".

Ornek Yanit

{
    "data": {
        "status": "VERIFIED",
        "phoneNumber": "0537***5258",
        "smsProvider": "EKO_SMS",
        "smsProviderVkn": "6220669058",
        "code": "123456"
    },
    "error": null,
    "warning": null
}

Yanit Kodlari

KodAciklama
200SMS kodu doğrulandı (status: VERIFIED)