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"
    }
}