Isme EFT

Bu API hesaptan isme EFT 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

 /EFTtoName

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 (50) Alıcı 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

BankCode

 String (4) Alıcının banka kodu Zorunlu

BranchCode

 String (5) Alıcının şube kodu Zorunlu

Address

 String (50) Alıcının adresi Zorunlu

FatherName

 String (50) Alıcının baba adı Zorunlu

PhoneNumber

 String (10) Alıcının cep telefonu numarası 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

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

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ı


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.

ACBH000072

Alıcının adresi boş olamaz.

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.

ACBH000092

Alıcının banka 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.

ACBH000111

Alıcının banka kodu alanına geçersiz bir değer girildi.

ACBH000120

Alıcının baba adı boş olamaz.

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.

ACBH000211

Alıcının adresi 50 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": {
        "NameSurnameTitle": "MUHAMMED",
        "IdentityNumber": "10000000000",
        "TaxNumber": "",
        "BankCode" : "0010",
        "BranchCode" : "00811",
        "Address" : "00111 Sokak",
        "FatherName" : "Ali",
        "PhoneNumber" : "5000000000"
    },
      "FeeInformation": {
        "AccountNumber": ""
    },
    "Transaction": {
        "Amount": 5,
        "Description": "EFT işlemi"
    }
}

Cevap:

      
{
    "Header": {
        "StatusCode": "APIGW000000",
        "StatusDescription": "Tamamlandı",
        "StatusDescriptionEn": "Completed",
        "ObjectID": "564ea269-b72d-47e3-9b1e-174ac9642a81"
    },
    "SecurityInformation": {
        "OTPTransactionId": 196930,
        "OTPStatus": "ApprovementWaiting"
    },
    "Data": {
        "Transaction": {
            "Amount": 5
        },
        "Receiver": {
            "NameSurnameTitle": "MUHAMMED"
        }
    },
    "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": "f556a269-b72d-47e3-9b1e-174ac9642a81"
    },
    "Data": {
        "Sender": {
            "AccountNumber": "00158000000000001"
        },
        "Transaction": {
            "EFTNumber": 6271943,
            "Description": "/FATMA HESABINDAN TÜRKİYE CUMHURİYETİ ZİRAAT BANKASI A.Ş. - KEÇİÖREN/ANKARA ŞUBESİ NEZDİNDEKİ  NO'LU MUHAMMED HESABINA YAPILAN 6271943 SIRA NO'LU EFT",
            "Amount": 5,
            "Date": "2021-30-03T15:08:45",
            "TransactionId": 53970640
        },
        "Receiver": {
            "NameSurnameTitle": "MUHAMMED",
            "TaxNumber": "",
            "IdentityNumber": 10000000000
        }
    },
    "FeeInformation": {
        "TotalFeeAmount": 7.09,
        "CurrencyCode": "TL",
        "AccountNumber": "00158000000000001"
    }
}