Transfer to VakıfBank Account with Name

This API makes money transfer to another VakıfBank account (to name). You have to use “Execute Transaction API” for complete your transaction. One of Receiver T.R. Identity number or Tax Identity number is mandatory.

API Information

URL

 /remittancetoName

Method

 POST

Version

 1.0

Scope

 transfer

Authorization Flow

 Authorization Code


Input Information

Sender

Name Format Description Required/Optional

AccountNumber

 String (17) Sender account number Required


Receiver

Name Format Description Required/Optional

NameSurnameTitle

 String (250) Receiver name surname / title Required

IdentityNumber

 String (11) Receiver T.R. Identity number Conditionally Required

TaxNumber

 String (10) Receiver Tax Identity number Conditionally Required

BranchCode

 String (6) Receiver branch code Required

PhoneNumber

 String (10) Receiver phone number Required

Address

 String (50) Receiver address Required


FeeInformation

Name Format Description Required/Optional

AccountNumber

 String (17) Fee account number Optional


Transaction

Name Format Description Required/Optional

Amount

 Decimal (10,2) Transaction amount Required

PaymentPurpose

 Integer Payment purpose
1: Housing Rent, 2: Workplace Rent, 3: Other Rent, 4: Other, 5: E-Commerce Payment, 6: Commercial Payment, 7:Retail Payment, 8: Investing, 9: Financial, 10: Education Payment, 11:Dues Payment, 12: Employee Payment 		Required

MaskSender

 Boolean Mask sender
True: Mask account/IBAN on receipt.
False: Don’t mask account/IBAN on receipt. 		Required

Description

 String (200) Transaction description Required


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 Fee amount

CurrencyCode

 String Currency code

FeeDescription

 String Fee description


Transaction

Name Format Description

Amount

 Decimal Transaction amount

Information

 String Information


Receiver

Name Format Description

NameSurnameTitle

 String Masked receiver name surname / title


Execute Transaction

Sender

Name Format Description

AccountNumber

 String Sender account number

CurrencyCode

 String Sender currency code


Receiver

Name Format Description

NameSurnameTitle

 String Receiver name surname / title

IdentityNumber

 String Receiver T.R. Identity number

TaxNumber

 String Receiver Tax Identity number

CurrencyCode

 String Receiver currency code


Transaction

Name Format Description

TransactionId

 Integer Transaction id

Date

 yyyy-MM-ddTHH24:mm:ss Transaction date

Amount

 Decimal Transaction amount

Description

 String Transfer description


FeeInformation

Name Format Description

TotalFeeAmount

 Decimal Total fee amount

CurrencyCode

 String Currency code

AccountNumber

 String Fee account number


Message Codes

Message Code Description

ACBH000043

Sender account number cannot be empty.

ACBH000044

Sender account number format is incorrect.

ACBH000072

Receiver address cannot be empty.

ACBH000085

Payment purpose is invalid.

ACBH000088

One of T.R. Identity number or Tax Identity number is mandatory.

ACBH000089

Receiver T.R. Identity / Tax Identity number format is incorrect.

ACBH000090

Receiver name surname cannot be empty.

ACBH000091

Receiver branch code cannot be empty.

ACBH000098

Receiver phone number cannot be empty.

ACBH000099

Receiver phone number format is incorrect.

ACBH000104

Account that you want to make transaction is not belong to customer in session.

ACBH000110

Receiver branch code is invalid.

ACBH000140

T.R Identity / Tax Identity number you entered is not match receiver T.R Identity / Tax Identity number.

ACBH000208

Amount must be greater than zero.

ACBH000209

Description cannot be empty.

ACBH000210

Description cannot be greater than 200.

ACBH000211

Receiver address cannot be greater than 50.

ACBH000232

Money transfer transaction can be executed by only deposit accounts in Open Banking Channel.

ACBH000241

This transaction cannot be performed Altın Çağı account.

ACBH000264

Fee account currency code must be TRY.

ACBH000277

Fee account number format is incorrect.

ACBH000278

Sender account currency code {0}. Fee account must be entered TRY.

ACBH000283

Fee account number does not belong to customer in session.

Example

Request:

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

Response:

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

Execute Transaction

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