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 Parameters

Name	Type	Required	Description
`Authorization`	`text`	Yes	v1/auth/token endpointten alınan token

Body Parameters

Name	Type	Required	Description
`phoneNumber`	`text`	Yes	SMS kodunun gönderildiği müstahsilin telefon numarası.
`code`	`text`	Yes	Müstahsilin ilettiği SMS doğrulama kodu. Örnek: "123456".

Sample Response

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

Response Codes

Code	Description
`200`	SMS kodu doğrulandı (status: VERIFIED)