İsme Havale
Bu API hesaptan isme havale işlemini gerçekleştirmektedir. İşlemin tamamlanabilmesi için İşlem Gerçekleştir API'ından OTP doğrulamasının yapılması gerekmektedir. Alıcının T.C. kimlik numarası veya vergi numarası alanlarından birinin girilmesi zorunludur.
API Bilgileri
URL |
/remittancetoName |
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 |
NameSurnameTitle |
String (250) | Alıcının adı soyadı / unvanı | Zorunlu |
IdentityNumber |
String (11) | Alıcının T.C. kimlik numarası | Koşullu Zorunlu |
TaxNumber |
String (10) | Alıcının vergi numarası | Koşullu Zorunlu |
BranchCode |
String (6) | Alıcının şube kodu | Zorunlu |
PhoneNumber |
String (10) | Alıcının telefon numarası | Zorunlu |
Address |
String (50) | Alıcının adresi | 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: Diğer, 5: E-Ticaret Ödemeleri, 6: Ticari Ödeme, 7: Bireysel Ödeme, 8: Yatırım, 9: Finansal, 10: Eğitim Ödemesi, 11: Aidat Ödemesi, 12: Çalışan Ödemesi |
Zorunlu |
MaskSender |
Boolean |
Maske göndericisi true: Dekontta gönderen hesap/IBAN bilgisi maskelenir, false: Dekontta gönderen hesap/IBAN bilgisi maskelenmez. |
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ı |
Information |
String | Bilgi notu |
Receiver
Alan Adı | Format | Açıklama |
NameSurnameTitle |
String | Maskeli alıcı adı soyadı / unvanı |
İşlem Gerçekleştir
Sender
Alan Adı | Format | Açıklama |
AccountNumber |
String | Gönderen hesap numarası |
CurrencyCode |
String | Gönderen döviz kodu |
Receiver
Alan Adı | Format | Açıklama |
NameSurnameTitle |
String | Alıcının adı soyadı / unvanı |
IdentityNumber |
String | Alıcının T.C. kimlik numarası |
TaxNumber |
String | Alıcının vergi numarası |
CurrencyCode |
String | Alıcının döviz kodu |
Transaction
Alan Adı | Format | Açıklama |
TransactionId |
Integer | İşlem id |
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. |
ACBH000072 |
Alıcının adresi boş olamaz. |
ACBH000085 |
Ödeme amacı alanına geçersiz bir değer girildi. |
ACBH000088 |
Alıcının T.C. kimlik numarası veya vergi numarası alanlarından birinin girilmesi zorunludur. |
ACBH000089 |
Alıcının T.C. kimlik numarası/vergi numarası uygun formatta girilmelidir. |
ACBH000090 |
Alıcının adı soyadı boş olamaz. |
ACBH000091 |
Alıcının şube kodu boş olamaz. |
ACBH000098 |
Alıcının telefon numarası boş olamaz. |
ACBH000099 |
Alıcının telefon numarası uygun formatta girilmelidir. |
ACBH000104 |
İşlem yapmak istediğiniz hesap oturumdaki müşteri numarasına ait değildir. |
ACBH000110 |
Alıcının şube kodu alanına geçersiz bir değer girildi. |
ACBH000140 |
Girilen T.C. / Vergi Kimlik Numarası bilgisi ile alıcı ad soyad / unvan bilgileri eşleşmemektedir. |
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. |
ACBH000211 |
Alıcının adresi 50 karakterden büyük olamaz. |
ACBH000232 |
Açık Bankacılık kanalında para transferleri sadece vadesiz mevduat hesapları ile yapılabilmektedir. |
ACBH000241 |
Bu işlem Altın Çağı hesabından yapılamamaktadır. |
ACBH000264 |
Masraf hesabı türü TL olmalıdır. |
ACBH000277 |
Masraf hesap numarası uygun formatta girilmelidir. |
ACBH000278 |
Gönderen hesabın döviz cinsi {0}. TL masraf hesabı girilmelidir. |
ACBH000283 |
Masraf hesabı oturumdaki müşteri numarasına ait değildir. |
Örnek
İstek:
{ "Sender": { "AccountNumber": "00158000000000001" }, "Receiver": { "NameSurnameTitle": "NERGİZ YER", "IdentityNumber": "10000000000", "TaxNumber": "", "BranchCode": "S00012", "PhoneNumber" : "5000000000", "Address": "A Mah." }, "FeeInformation": { "AccountNumber": "00158000000000001" }, "Transaction": { "Amount" : 1, "PaymentPurpose": 12, "MaskSender": true, "Description": "Havale" } }
Cevap:
{ "Header": { "StatusCode": "APIGW000000", "StatusDescription": "Tamamlandı", "StatusDescriptionEn": "Completed", "ObjectID": "50acab77-e2b8-4ba5-a543-82b96eb4cae6" }, "SecurityInformation": { "OTPTransactionId": 163314, "OTPStatus": "ApprovementWaiting" }, "Data": { "Transaction": { "Amount": 0.1, "Information": "Havale ödemesi yapılırken alıcıdan İsme Gelen Havale Ödenmesi masrafı tahsil edilecektir." }, "Receiver": { "NameSurnameTitle": "N*R*İ* *E*" } }, "FeeInformation": { "TotalFeeAmount": 3.68, "CurrencyCode": "TL", "Fee": { "CurrencyCode": "TL", "Amount": 3.68, "FeeDescription": "HESAPTAN İSME HAVALE ÜCRETİ" }, "AccountNumber": "00158000000000001" } } İşlem Gerçekleştir { "Header": { "StatusCode": "APIGW000000", "StatusDescription": "Tamamlandı", "StatusDescriptionEn": "Completed", "ObjectID": "a8acab77-e2b8-4ba5-a543-82b96eb4cae6" }, "Data": { "Sender": { "CurrencyCode": "TL", "AccountNumber": "00158000000000001" }, "Transaction": { "Description": "Havale / TR FATMA KARAKAYA hesabından NERGİZ YER () adina 0012 nolu şubeye yapilan 2021030700000010 ref. nolu isme havale", "Amount": 0.1, "Date": "2021-03-07T15:17:27", "TransactionId": 2021000006841198 }, "Receiver": { "CurrencyCode": "TL", "NameSurnameTitle": "NERGİZ YER", "TaxNumber": "", "IdentityNumber": 10000000000 } }, "FeeInformation": { "TotalFeeAmount": 3.68, "CurrencyCode": "TL", "AccountNumber": "00158000000000001" } }
-
API URL : https://apigw.vakifbank.com.tr:8443
-
-
-