Kolay Adres Güncelle

Bu API anlık ödeme işlemleri için kolay adres bilgilerinin güncellenmesini sağlar.

API Bilgileri

URL

/updateKOLAS

Metot

POST

Versiyon

1.0

Scope

transfer

Yetkilendirme Yöntemi

Authorization Code


Girdi Bilgileri

Alan Adı Format Açıklama Zorunlu/Opsiyonel

SystemRefNo

Integer (30) Sistem Referans Numarası Zorunlu

AddressType

String (1) Kolay adres Tipleri içerisinde yer almaktadır.
K: T.C. Kimlik Numarası
T: Telefon Numarası
E: E-Posta
V: Vergi Kimlik Numarası
Y: Yabancı Kimlik Numarası
P: Pasaport Numarası
Zorunlu

AddressValue

String (30) Müşterinin eklediği, Katılımcısı tarafından doğrulanmış Kolay Adres değeridir. "Kolay Adres Tipi" ile uyumlu bir değer olmalıdır. Zorunlu

AccountOwner

String (30) Ad-Soyad/Unvan bilgisidir. Zorunlu

IBAN

String (30) IBAN Bilgisidir. Zorunlu

Description

String (30) Açıklama Opsiyonel


Çıktı Bilgileri

Alan Adı Format Açıklama

SystemRefNo

Integer Sistem Referans Numarası

AddressType

String(1) Kolay adres Tipleri içerisinde yer almaktadır.
K: T.C. Kimlik Numarası
T: Telefon Numarası
E: E-Posta
V: Vergi Kimlik Numarası
Y: Yabancı Kimlik Numarası
P: Pasaport Numarası

AddressValue

String Müşterinin eklediği, Katılımcısı tarafından doğrulanmış Kolay Adres değeridir. "Kolay Adres Tipi" ile uyumlu bir değer olmalıdır.

TradeName

String Ticari müşterilerde gözükecek Tabela Unvanı bilgisidir.

List< KOLASError >

Alan Adı Format Açıklama

ErrorCode

Integer Hata kodu

Information

String Hata açıklaması


Mesaj Kodları

Mesaj Kodu Açıklama

ACBH000022

IBAN formatı hatalıdır.

ACBH000055

IBAN boş olamaz.

ACBH000143

Ad / Soyad boş bırakılamaz.

ACBH000146

T.C. kimlik numarası uygun formatta girilmelidir.

ACBH000364

T.C. Kimlik Numarası boş bırakılamaz.

ACBH000267

Vergi kimlik numarası uygun formatta girilmelidir.

ACBH000365

Vergi Kimlik Numarası boş bırakılamaz.

ACBH000212

Cep telefonu 10 hane olmalı ve 5 ile başlamalıdır.

ACBH000366

Cep telefonu numarası boş bırakılamaz.

ACBH000367

Pasaport Numarası uygun formatta girilmelidir.

ACBH000368

Pasaport numarası boş bırakılamaz.

ACBH000369

Yabancı Kimlik Numarası uygun formatta girilmelidir.

ACBH000370

Yabancı kimlik numarası boş bırakılamaz.

ACBH000197

E-posta uygun formatta girilmelidir.

ACBH000199

E-posta boş olamaz.

ACBH000376

Adres Tipi alanı boş olamaz.

Örnek

İstek:

{
    "SystemRefNo": 527826687958712322,
    "AddressType":"K",
    "AddressValue":"12345678912",
    "AccountOwner":"KIZILCIM ŞERBET",
    "IBAN":"TR000000000000000000000000",
    "Description": "test"
} 

Cevap:

{
    "Header": {
        "StatusCode": "APIGW000000",
        "StatusDescription": "Tamamlandı",
        "StatusDescriptionEn": "Completed",
        "ObjectID": "9122f963-993a-4489-bf3c-97ef11ac63ba"
    },
    "Data": {
        "systemRefNo": 527826687958712322,
        "AddressValue": 12345678912,
        "KOLASError": "",
        "AddressType": "K"
    }
}