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