Send Instant Transfer (FAST)

This API makes instant transfer (FAST). OTP confirmation must be done with “Execute Transaction” API for complete transaction.

API Information

URL

 /sendFAST

Metot

 POST

Version

 1.0

Scope

 transfer

Authorization Flow

 Authorization Code


Input Information

Sender

Name Format Description Required/Optional

SenderIBAN

 String (1) Sender IBAN. Required


Receiver

Name Format Description Required/Optional

ReceiverIBAN

 String (17) If TransferType value “1”, this input is required.
Receiver IBAN.		 Conditional required

ReceiverName

 String (50) If TransferType value “1”, this input is required.
Receiver Name Surname or Title		 Conditional required

KolasType

 String (1) If TransferType value “2”, this input is required.
K: T.R. Identity Number
T: Phone Number
E: E-Mail
V: Tax Identity Number
Y: Foreign Identity Number
P:Passport Number
P: Pasaport Numarası		 Conditional required

KolasValue

 String Easy Address value (KolasValue) which depends on KolasType. Conditional required

AddressReference

 String Easy Adress Query referance number information. Optional

TransferType

 Integer 1: IBAN
2: Eays Adress (KOLAS)		 Required


Transaction

Name Format Description Required/Optional

Amount

 Decimal (10,2) Amount. Required

PaymentPurpose

 String(2) 1: Residential Rent Payment
2: Office Rent Payment
3:Other Rent Payment
4: E-Commercial Payment
5: Employee Payment
6: Commercial Payment
7: Personal Paymet
8: Investment
9: Financial
10: Education Payment
11:Dues Payment		 Required

ReferenceInformation

 String Cotains information like bill number, tracking number, receipt number. Optional

Description

 String (200) Description. Optional

 

Output Information

SecurityInformation

Name Format Description

OTPTransactionId

 Integer OTP Transaction Id.

OTPStatus

 String OTP Status


FeeInformation

Name Format Description

TotalFeeAmount

 Decimal Total Fee Amount

CurrencyCode

 String Currency Code

AccountNumber

 String Fee Account Number

Fee

 List< Fee > Fee List

List< Fee >

Name Format Description

Amount

 Decimal Amount

CurrencyCode

 String Currency Code

FeeDescription

 String Fee Description


Transaction

Name Format Description

Amount

 Decimal Amount


Receiver

Name Format Description

NameSurnameTitle

 String Receiver name surname/tittle


Execute Transaction

Sender

Name Format Description

SenderIBAN

 String Sender IBAN.


Receiver

Name Format Description

ReceiverIBAN

 String Receiver IBAN.

ReceiverName

 String Receiver Name Surname/Title.

KolasType

 String TCKN: T.R. Identity Number
T: Phone Number
E:E-Mail
VKN:Tax Identity Number
YKN: Foreign Identity Number
P:Passport Number

KolasValue

 String Easy Address value (KolasValue) which depends on KolasType.


Transaction

Name Format Description

TransactionId

 String Transaction Id

QueryNumber

 Integer Transaction Query Number.

Date

 yyyy-MM-ddTHH24:mm:ss Date

Amount

 Decimal Amount

Description

 String Description


FeeInformation

Name Format Description

TotalFeeAmount

 Decimal Total fee amount

CurrencyCode

 String Currency Code

AccountNumber

 String Fee account number


Message Codes

Message Code Description

ACBH000208

 Amount must be greater than “0” (zero).

ACBH000359

 Amount limit is 2.000 TRY.

ACBH000059

 Receiver IBAN format is incorrect.

ACBH000074

 Receiver IBAN cannot be empty.

ACBH000361

 Sender IBAN cannot be empty.

ACBH000363

 Sender IBAN format is incorrect.

ACBH000354

 Sender account currency type must be TRY.

ACBH000085

 Payment purpose is invalid.

ACBH000360

 Payment purpose cannot be empty.

ACBH000090

 Receiver name surname cannot be empty.

ACBH000104

 Account number does not belong to customer in session.

ACBH000232

 Money transfers in open banking can be done with only currency accounts.

ACBH000146

 T.R. Identity number format is incorrect.

ACBH000364

 T.R. Identity number cannot be empty.

ACBH000267

 Tax Identity Number format is incorrect.

ACBH000365

 Tax Identity number cannot be empty.

ACBH000361

 Date cannot be empty.

ACBH000023

 Date format is incorrect.

ACBH000212

 Cell phone number must be 10 digits and start with 5 .

ACBH000366

 Cell phone cannot be empty.

ACBH000367

 Passport number format is incorrect.

ACBH000368

 Passport number cannot be empty.

ACBH000369

 Foreign identity number format is incorrect.

ACBH000370

 Foreign identity number cannot be empty.

ACBH000197

 E-Mail format is incorrect.

ACBH000199

 E-Mail cannot be empty.

ACBH000459

 Receiver Easy Address cannot be found.

Example

Request:

{
    "Sender": {
        "SenderIBAN":"TR000000000000000000000000"
    },
    "Receiver": {
        "ReceiverIBAN": "TR000000000000000000000000",
        "ReceiverName": "Cahit Uysal",
        "KolasType": "",
        "KolasValue": "",
        "TransferType": 1
    },
    "Transaction": {
        "Amount": 30,
        "PaymentPurpose": "07",
        "Description": "",
        "ReferenceInformation": ""
    }
}

Response:

      
{
    "Header": {
        "StatusCode": "APIGW000000",
        "StatusDescription": "Tamamlandı",
        "StatusDescriptionEn": "Completed",
        "ObjectID": "2b77d363-4fed-48fd-be8c-93f7a9d1475e"
    },
    "SecurityInformation": {
        "OTPTransactionId": 383884,
        "OTPStatus": "ApprovementWaiting"
    },
    "Data": {
        "Transaction": {
            "Amount": 30
        },
        "Receiver": {
            "NameSurnameTitle": "C*h*t U*s*l"
        }
    },
    "FeeInformation": {
        "TotalFeeAmount": 1.2,
        "CurrencyCode": "TL",
        "Fee": [
            {
                "CurrencyCode": "TL",
                "Amount": 0.98,
                "FeeDescription": "FAST EFT ÜCRETİ"
            },
            {
                "CurrencyCode": "TL",
                "Amount": 0.22,
                "FeeDescription": "FAST TCMB Ücreti"
            }
        ],
        "AccountNumber": "00000000000000000"
    }
}


Execute Transaction
{
    "Header": {
        "StatusCode": "APIGW000000",
        "StatusDescription": "Tamamlandı",
        "StatusDescriptionEn": "Completed",
        "ObjectID": "1e8bd363-4fed-48fd-be8c-93f7a9d1475e"
    },
    "Data": {
        "Sender": {
            "SenderIBAN": "TR000000000000000000000000"
        },
        "Transaction": {
            "QueryNumber": 948213,
            "Description": "(05/01/2022 tarihli 948213 sorgu no'lu KIZILCIM ŞERBET hesabından Türkiye İş Bankası A.Ş. Cahit Uysal hesabına giden FAST ödemesi)",
            "Amount": 30,
            "Date": "2022-01-05T00:00:00+03:00",
            "TransactionId": 2022000000046067
        },
        "Receiver": {
            "ReceiverIBAN": "TR000000000000000000000000",
            "KolasValue": "",
            "KolasType": "",
            "ReceiverName": "Cahit Uysal"
        }
    },
    "FeeInformation": {
        "TotalFeeAmount": 1.2,
        "CurrencyCode": "TL",
        "AccountNumber": "00000000000000000"
    }
}