IBAN'a EFT
Bu API hesaptan IBAN'a EFT işlemini gerçekleştirmektedir. İşlemin tamamlanabilmesi için İşlem Gerçekleştir API'ından OTP doğrulamasının yapılması gerekmektedir.
API Bilgileri
URL |
/EFTtoIBAN |
Metot |
POST |
Versiyon |
1.0 |
Scope |
transfer |
Yetkilendirme Yöntemi |
Authorization Code |
Girdi Bilgileri
Sender
Alan Adı | Format | Açıklama | Zorunlu/Opsiyonel |
AccountNumber |
String (17) | Gönderen hesap numarası | Zorunlu |
Receiver
Alan Adı | Format | Açıklama | Zorunlu/Opsiyonel |
IBAN |
String (26) | Alıcı IBAN | Zorunlu |
NameSurnameTitle |
String (50) | Alıcı adı soyadı / unvanı | Zorunlu |
FeeInformation
Alan Adı | Format | Açıklama | Zorunlu/Opsiyonel |
AccountNumber |
String (17) | Masraf hesap numarası | Opsiyonel |
Transaction
Alan Adı | Format | Açıklama | Zorunlu/Opsiyonel |
Amount |
Decimal (10,2) | İşlem tutarı | Zorunlu |
PaymentPurpose |
Integer |
Ödeme amacı 1: Konut Kira, 2: İşyeri Kira, 3: Diğer Kira, 4: E-ticaret Ödemesi, 5: Çalışan Ödemesi, 6: Ticari Ödeme, 7: Bireysel Ödeme, 8: Yatırım, 9: Finansal, 10: Eğitim Ödemesi, 11: Aidat Ödemesi, 99: Diğer |
Zorunlu |
Description |
String (200) | İşlem açıklaması | Zorunlu |
Çıktı Bilgileri
SecurityInformation
Alan Adı | Format | Açıklama |
OTPTransactionId |
Integer | OTP İşlem id |
OTPStatus |
String | OTP durumu |
FeeInformation
Alan Adı | Format | Açıklama |
TotalFeeAmount |
Decimal | Toplam masraf tutarı |
CurrencyCode |
String | Döviz kodu |
AccountNumber |
String | Masraf hesap numarası |
Fee |
List< Fee > | Masraf listesi |
List< Fee >
Alan Adı | Format | Açıklama |
Amount |
Decimal | Masraf tutarı |
CurrencyCode |
String | Döviz kodu |
FeeDescription |
String | Masraf açıklaması |
Transaction
Alan Adı | Format | Açıklama |
Amount |
Decimal | İşlem tutarı |
Receiver
Alan Adı | Format | Açıklama |
NameSurnameTitle |
String | Alıcı adı soyadı / unvanı |
İşlem Gerçekleştir
Sender
Alan Adı | Format | Açıklama |
AccountNumber |
String | Gönderen hesap numarası |
Receiver
Alan Adı | Format | Açıklama |
IBAN |
String | Alıcı IBAN |
Transaction
Alan Adı | Format | Açıklama |
TransactionId |
Integer | İşlem id |
EFTNumber |
Integer | EFT sorgu numarası |
Date |
yyyy-MM-ddTHH24:mm:ss | İşlem tarihi |
Amount |
Decimal | İşlem tutarı |
Description |
String | Transfer işleminin açıklaması |
FeeInformation
Alan Adı | Format | Açıklama |
TotalFeeAmount |
Decimal | Toplam masraf tutarı |
CurrencyCode |
String | Döviz kodu |
AccountNumber |
String | Masraf hesap numarası |
Mesaj Kodları
Mesaj Kodu | Açıklama |
ACBH000043 |
Gönderen hesap numarası boş olamaz. |
ACBH000044 |
Gönderen hesap numarası uygun formatta girilmelidir. |
ACBH000059 |
Alıcı IBAN uygun formatta girilmelidir. |
ACBH000074 |
Alıcı IBAN boş olamaz. |
ACBH000085 |
Ödeme amacı alanına geçersiz bir değer girildi. |
ACBH000090 |
Alıcının adı soyadı boş olamaz. |
ACBH000104 |
İşlem yapmak istediğiniz hesap oturumdaki müşteri numarasına ait değildir. |
ACBH000139 |
Gönderen hesap döviz cinsi hatalıdır. |
ACBH000208 |
Tutar alanı sıfırdan büyük olmalıdır. |
ACBH000209 |
Açıklama boş olamaz. |
ACBH000210 |
Açıklama alanı 200 karakterden büyük olamaz. |
ACBH000223 |
Alıcı Banka Vakıfbank olamaz. |
ACBH000232 |
Açık Bankacılık kanalında para transferleri sadece vadesiz mevduat hesapları ile yapılabilmektedir. |
ACBH000264 |
Masraf hesabı türü TL olmalıdır. |
ACBH000277 |
Masraf hesap numarası uygun formatta girilmelidir. |
ACBH000283 |
Masraf hesabı oturumdaki müşteri numarasına ait değildir. |
Örnek
İstek:
{ "Sender": { "AccountNumber": "00158000000000001" }, "Receiver": { "IBAN": "TR100006400000000000000002", "NameSurnameTitle" : "Sinan" }, "FeeInformation": { "AccountNumber": "00158000000000001" }, "Transaction": { "Amount" : 1, "PaymentPurpose": 7, "Description": "EFT" } }
Cevap:
{ "Header": { "StatusCode": "APIGW000000", "StatusDescription": "Tamamlandı", "StatusDescriptionEn": "Completed", "ObjectID": "25b7849b-02e2-4d31-a43f-48b166cc5c5d" }, "SecurityInformation": { "OTPTransactionId": 196928, "OTPStatus": "ApprovementWaiting" }, "Data": { "Transaction": { "Amount": 1 }, "Receiver": { "NameSurnameTitle": "Sinan" } }, "FeeInformation": { "TotalFeeAmount": 7.09, "CurrencyCode": "TL", "Fee": [ { "CurrencyCode": "TL", "Amount": 6.88, "FeeDescription": "GİDEN EFT İŞLEM ÜCRETİ" }, { "CurrencyCode": "TL", "Amount": 0.21, "FeeDescription": "TCMB EFT KOMİSYONU" } ], "AccountNumber": "00158000000000001" } } İşlem Gerçekleştir { "Header": { "StatusCode": "APIGW000000", "StatusDescription": "Tamamlandı", "StatusDescriptionEn": "Completed", "ObjectID": "93b7849b-02e2-4d31-a43f-48b166cc5c5d" }, "Data": { "Sender": { "AccountNumber": "00158000000000001" }, "Transaction": { "EFTNumber": 6271940, "Description": "/FATMA HESABINDAN TÜRKİYE İŞ BANKASI A.Ş. - IBAN MERKEZ ŞUBE NEZDİNDEKİ TR NO'LU SİNAN HESABINA YAPILAN 6271940 SIRA NO'LU EFT", "Amount": 1, "Date": "2021-30-03T14:51:00", "TransactionId": 53970637 }, "Receiver": { "IBAN": "TR100006400000000000000002" } }, "FeeInformation": { "TotalFeeAmount": 7.09, "CurrencyCode": "TL", "AccountNumber": "00158000000000001" } }