Transfer to Another VakıfBank Account (to IBAN)

This API makes money transfer to another VakıfBank account (to IBAN) and between your account. You have to use “Execute Transaction API” for complete your transaction.

API Information

URL

/remittancetoIBAN

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

IBAN

String (26) Receiver IBAN 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


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

IBAN

String Receiver IBAN

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.

ACBH000059

Receiver IBAN format is incorrect.

ACBH000074

Receiver IBAN cannot be empty.

ACBH000085

Payment purpose is invalid.

ACBH000104

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

ACBH000138

Sender and recevier account currency code must be same.

ACBH000208

Amount must be greater than zero.

ACBH000209

Description cannot be empty.

ACBH000210

Description cannot be greater than 200.

ACBH000232

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

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": {
        "IBAN": "TR520001500158000000000002"
    },
      "FeeInformation": {
        "AccountNumber": "00158000000000001"
    },
    "Transaction": {
        "Amount" : 9,
        "PaymentPurpose": 3,
        "MaskSender": false,
        "Description": "Havale"
    }
}

Responses:

      
{
    "Header": {
        "StatusCode": "APIGW000000",
        "StatusDescription": "Tamamlandı",
        "StatusDescriptionEn": "Completed",
        "ObjectID": "0dabab77-e2b8-4ba5-a543-82b96eb4cae6"
    },
    "SecurityInformation": {
        "OTPTransactionId": 163313,
        "OTPStatus": "ApprovementWaiting"
    },
    "Data": {
        "Transaction": {
            "Amount": 9
        },
        "Receiver": {
            "NameSurnameTitle": "B*L*N G*R*N*E*"
        }
    },
    "FeeInformation": {
        "TotalFeeAmount": 1.05,
        "CurrencyCode": "TL",
        "Fee": {
            "CurrencyCode": "TL",
            "Amount": 1.05,
            "FeeDescription": "HESAPTAN HESABA HAVALE ÜCRETİ"
        },
        "AccountNumber": "00158000000000001"
    }
}

Execute Transaction

{
    "Header": {
        "StatusCode": "APIGW000000",
        "StatusDescription": "Tamamlandı",
        "StatusDescriptionEn": "Completed",
        "ObjectID": "57abab77-e2b8-4ba5-a543-82b96eb4cae6"
    },
    "Data": {
        "Sender": {
            "CurrencyCode": "TL",
            "AccountNumber": "00158000000000001"
        },
        "Transaction": {
            "Description": "TR nolu FATMA  hesabından TR nolu BİLUN hesabına 2021030700000009 referans nolu havale yapılmıştır.",
            "Amount": 9,
            "Date": "2021-07-03T15:16:34",
            "TransactionId": 2021000006841195
        },
        "Receiver": {
            "CurrencyCode": "TL",
            "IBAN": "TR520001500158000000000002"
        }
    },
    "FeeInformation": {
        "TotalFeeAmount": 1.05,
        "CurrencyCode": "TL",
        "AccountNumber": "00158000000000001"
    }
}