inter-API Money Transfer
Introduction
Money transfer services include the services to be used for money transfers to accounts , names or IBAN numbers.
Methods:
RequestWireToIBAN
RequestWireToAccount
ProcessEftRequestToIban
ProcessEftRequestToAccount
RequestWireToName
GetReturnedEftList
GetTransferStatus
How to Get Started
Step 1 - Sign Up & Register: To start building with our APIs, you'll need to sign up for account. Read our documentation on how to use the Inter-API services and secure your connection with the right electronic certificate
Step 2 - Get Subscription Key: To get your Subscription Key, you'll first need to Subscribe for a package on Products page.
Step 3 - Activate: Get your subscription key under profile menu. You can also add your applications here.
Step 4 - Test API Methods: Include your access token and the information needed for that API. From there, use the response for your application and you’re all set. Now you can start building applications with our API.
Step 5 - For Production: You 're now up and running on inter-API Portal. Submit for production When you’re finished testing, you may want to submit your app for production. If it seems like we’d be a good fit, we’ll look into it and do some testing together. Then, we’ll talk about next steps to move to production.
EFT/Wire Transfer Status
In order to query the status of EFT/Money Transfer transactions, the "TransferReferenceId" parameter must be filled in the request of the "RequestWireToIban, RequestWireToAccount, ProcessEftRequestToIban, ProcessEftRequestToAccount" API methods used in money transfer transactions. The type of this parameter is GUID and must be unique in every transaction.
If the type of TransferReferenceId parameter is not GUID in money transfer services, the following error is returned and the transaction is not executed.
{
"$type": "ServiceResponseMessage",
"Error": {
"$type": "ServiceExceptionMessage",
"Code": 1,
"Description": "InvalidJson [TransferReferenceId]",
"Parameters": null,
"ErrorId": null
}
}
• The “GetTransferStatus” method has been developed to query the status of EFT/Money Transfer transactions. The operation can be queried with the TransferReferenceId parameter as a unique. There is the "TransferStatusType" enum parameter to separate the operations. Enum value represents querying of “0:EFT, 1:Wire” transaction. API Documentation: https://api.intertech.com.tr/api-details#api=money-transfer-services&operation=post-gettransferstatus
Response Values for Wire:
"Explanation": "İşlem Başarısız"
"Explanation": "İşlem Başarılıdır"
Response Values for EFT:
Explanation: bekliyor, hatali, iade, iptal, tamamlandi.
“GetReturnedEftList” method has been developed to query canceled EFT transactions. EFTs returned on the sent date are returned with this service. API Documentation: https://api.intertech.com.tr/api-details#api=money-transfer-services&operation=post-getreturnedeftlist
EFT Refund Response Values:
Explanation :bekliyor, hatali, iade, iptal.
RequestWireToIBAN
With IBAN, the account is transferred to the account.
Request:
{
"Header": {
"Channel": "****",
"AppKey": "****",
"ChannelSessionId": "331eb5f529c74df2b800926b5f34b87412",
"ChannelRequestId": "4dsf55daadf23sdfds564gh564gf56jh"
},
"Parameters": [
{
"Explanation": "PARA TRANSFERI",
"Amount": 1,
"CustomerNo": 395,
"IBANNumber": "TR900013400090489900600354",
"SourceAccount": {
"AccountSuffix": 351,
"BranchCode": 9230,
"CustomerNo": 395,
"CurrencyCode": "TRY"
},
"ReceiverName": "TEST TEST",
"ForceDuplicate": true,
"TransferReferenceId":"0aad17ea-6abc-430f-96de-acd302ba60e5"
}
]
}Response:
{
"Data": {
"$type": "WireToIBANMessage",
"TransactionCode": "WireToIBAN",
"ForceDuplicate": true,
"ExpenseAmount": 4,
"SourceAccount": {
"$type": "Account",
"AccountSuffix": 351,
"BranchCode": 9230,
"CustomerNo": 395,
"CurrencyCode": "TRY"
},
"TransactionDate": "2020-05-20T16:13:58",
"AccountingReference": "123",
"TransactionID": 43698134,
"State": 2
}
}RequestWireToAccount
The account is transferred to the account.
RequestWireToIBAN service matches the TCKN parameter and the TCKN of the customer in the target IBAN. If the customer in the Iban number does not match the TCKN, the code “111198786” and “TCKN and IBAN number are incompatible.” error is returned.
This check is done when the “CitizenshipNumber” parameter is sent full. If the parameter is not sent or its value is passed as "0", there is no control.
The same service matches the TaxNumber parameter and the VKNof the customer in the target IBAN. If the customer in the Iban number does not match the VKN, the code “1111987866” and “Tax number and IBAN number are incompatible.” error is returned.
This check is done when the “TaxNumber” parameter is sent full. If the parameter is not sent or its value is passed as "0", there is no control.
Request:
{
"Header": {
"Channel": "****",
"AppKey": "****",
"ChannelSessionId": "331eb5f529c74df2b800926b5f34b87412",
"ChannelRequestId": "4dsf55daadf23sdfds564gh564gf56jh"
},
"Parameters": [
{
"Explanation": "PARA TRANSFERI",
"Amount": 1,
"CustomerNo": 1841498,
"SourceAccount": {
"AccountSuffix": 351,
"BranchCode": 9142,
"CustomerNo": 1841498,
"CurrencyCode": "TRY"
},
"DestinationAccount": {
"AccountSuffix": 351,
"BranchCode": 9142,
"CustomerNo": 1841498,
"CurrencyCode": "TRY"
},
"ReceiverName": "TEST TEST",
"ForceDuplicate": true,
"TransferReferenceId":"0aad17ea-6abc-430f-96de-acd302ba60e5"
}
]
}Response:
{
"$type": "ServiceResponseMessage",
"Data": {
"$type": "WireToAccountMessage",
"TransactionCode": "WireToAccount",
"ForceDuplicate": true,
"ExpenseAmount": 0.0,
"SourceAccount": {
"$type": "Account",
"AccountSuffix": 351,
"BranchCode": 9142,
"CustomerNo": 3487796
},
"TransactionDate": "2020-05-20T15:35:54",
"AccountingReference": "66",
"TransactionID": 171045,
"State": 2
}
}ProcessEftRequestToIban
It performs EFT transaction with IBAN account.
“MASAK Tedbirler Yönetmeliği, elektronik transferlerde; transfer emrinin verildiği finansal kuruluştan ödemeyi gerçekleştirecek finansal kuruluşa kadar oluşan mesaj zincirinde Amire ait bilgilerin aktarılması zorunlu hale gelmiştir.“
Bu yönetmeliğe uygun olarak aşağıdaki parametrelerin doldurulması zorunlu olmuştur.
----Amir Bilgisi
string OrdererName :Amir Adı
string OrdererAccountNumber :Amir Hesap Numarası
string OrdererIdentificationNumber :Amir Kimlik Numarası
string OrdererAddress :Amir Adresi
string OrdererCountryandCity :Ülke ve Şehir
string OrdererBirthPlace :Amir Doğum Yeri
DateTime OrdererBirthDate :Amir Doğum Tarihi
string OrdererCustomerNumber :Amir Müşteri Numarası
8 amir bilgisi alanından en az biri dolu ise "Amir Adı" alanının da doldurulması zorunludur. Diğer alanların doldurulması zorunlu değildir.
Request:
{
"Header": {
"Channel": "****",
"AppKey": "*****",
"ChannelSessionId": "null",
"ChannelRequestId": "null"
},
"Parameters": [
{
"Explanation": "test",
"IBANNo": "TR900001002533034585185045",
"DestinationBankCode": 1,
"Amount": 1,
"CustomerNo": 13188998,
"SourceAccount": {
"AccountSuffix": 351,
"BranchCode": 9142,
"CurrencyCode": "TRY",
"CustomerNo": 13188998,
"IBANNo": "-",
"ShortName": "-"
},
"ReceiverName": "HASAN GÜVEN",
"ForceDuplicate": true,
"TransferReferenceId":"0aad17ea-6abc-430f-96de-acd302ba60e5",
"OrdererName": "Ali Can",
"OrdererAccountNumber": "",
"OrdererIdentificationNumber": "",
"OrdererAddress": "",
"OrdererCountryandCity": "",
"OrdererBirthPlace": "",
"OrdererBirthDate": "0001-01-01T00:00:00",
"OrdererCustomerNumber": ""
}
]
}Response:
{
"$type": "ServiceResponseMessage",
"Data": {
"$type": "IBANEFTMessage",
"TransactionCode": "IBANEFT",
"ForceDuplicate": true,
"ExpenseAmount": 0.0,
"SourceAccount": {
"$type": "Account",
"AccountSuffix": 351,
"BranchCode": 9142,
"CustomerNo": 3487796
},
"TransactionDate": "2020-05-20T15:35:54",
"AccountingReference": "66",
"TransactionID": 171045,
"State": 2
}
}
ProcessEftRequestToAccount
This service is used to query billing debt.
“MASAK Tedbirler Yönetmeliği, elektronik transferlerde; transfer emrinin verildiği finansal kuruluştan ödemeyi gerçekleştirecek finansal kuruluşa kadar oluşan mesaj zincirinde Amire ait bilgilerin aktarılması zorunlu hale gelmiştir.“
Bu yönetmeliğe uygun olarak aşağıdaki parametrelerin doldurulması zorunlu olmuştur.
----Amir Bilgisi
string OrdererName :Amir Adı
string OrdererAccountNumber :Amir Hesap Numarası
string OrdererIdentificationNumber :Amir Kimlik Numarası
string OrdererAddress :Amir Adresi
string OrdererCountryandCity :Ülke ve Şehir
string OrdererBirthPlace :Amir Doğum Yeri
DateTime OrdererBirthDate :Amir Doğum Tarihi
string OrdererCustomerNumber :Amir Müşteri Numarası
8 amir bilgisi alanından en az biri dolu ise "Amir Adı" alanının da doldurulması zorunludur. Diğer alanların doldurulması zorunlu değildir.
Request:
{
"Header": {
"Channel": "****",
"AppKey": "*****",
"ChannelSessionId": "null",
"ChannelRequestId": "null"
},
"Parameters": [
{
"Explanation": "test",
"SenderName": "DENİZ KK YILDIZ KK",
"IBANNo": "TR900001002533034585185045",
"DestinationBankCode": 1,
"EFTDestinationAccount": "123456",
"DestinationBranchCode": 1362,
"Amount": 1,
"CustomerNo": 13188998,
"SourceAccount": {
"AccountSuffix": 351,
"BranchCode": 9142,
"CurrencyCode": "TRY",
"CustomerNo": 13188998,
"IBANNo": "-",
"ShortName": "-"
},
"ReceiverName": "HASAN GÜVEN",
"ForceDuplicate": true,
"TransferReferenceId":"0aad17ea-6abc-430f-96de-acd302ba60e5",
"OrdererName": "Ali Can",
"OrdererAccountNumber": "",
"OrdererIdentificationNumber": "",
"OrdererAddress": "",
"OrdererCountryandCity": "",
"OrdererBirthPlace": "",
"OrdererBirthDate": "0001-01-01T00:00:00",
"OrdererCustomerNumber": ""
}
]
}Response:
{
"$type": "ServiceResponseMessage",
"Data": {
"$type": "ToAccountEFTMessage",
"TransactionCode": "ToAccountEFT",
"ForceDuplicate": true,
"ExpenseAmount": 0.0,
"SourceAccount": {
"$type": "Account",
"AccountSuffix": 351,
"BranchCode": 9142,
"CustomerNo": 3487796
},
"TransactionDate": "2020-05-20T15:35:54",
"AccountingReference": "66",
"TransactionID": 171045,
"State": 2
}
}
RequestWireToName
It is the service that provides transfer to the name.
Request:
{
"Header": {
"AppKey": "****",
"Channel": "****",
"ChannelSessionId": "54dsaf4ds3h2g1jhg651d",
"ChannelRequestId": "a7f77648-dfb7-42ef-a4b8-db6b79c1cfab"
},
"Parameters": [
{
"DestinationBranchCode": 9300,
"DestinationName": "BEOR THE OLD",
"DestinationLastName": "ANGUİLLİFORMES",
"DestinationPhoneNo": "5468996863",
"DestinationMotherName": "GUĞU ÇİÇEĞİ",
"DestinationFatherName": "RAPHANUS RAPHANİSTRUM",
"DestinationBirthDate": "1936-07-19 14:43:24.480",
"ReceiverName": "ali",
"ForceDuplicate": true,
"CustomerNo": 3374562,
"Amount": 1,
"Explanation": "test",
"SourceAccount": {
"AccountSuffix": 355,
"BranchCode": 9142,
"CustomerNo": 3374562
}
}
]
}Response:
{
"$type": "ServiceResponseMessage",
"Data": {
"$type": "RequestWireToName",
"State": 2
}
}GetTransferStatus
It is the service where the status of EFT and money transfer transactions are questioned.
Request:
{
"Header": {
"AppKey": "****",
"Channel": "****",
"ChannelSessionId": "54dsaf4ds3h2g1jhg651d",
"ChannelRequestId": "a7f77648-dfb7-42ef-a4b8-db6b79c1cfab"
},
"Parameters": [
{
"TransferStatusType": 1, //0:EFt, 1:Wire
"TransferReferenceId": "0aad17ea-6abc-430f-96de-acd302ba60e5",
"TransactionDate": "2021-12-22T00:00:00",
"CustomerNo": 12695682
}
]
}Response:
{
"Data": {
"$type": "TransferStatusQueryMessage",
"Explanation": "İşlem Başarılıdır."
}
}GetReturnedEftList
It is the service where eft transactions returned on the selected date are returned.
Request:
{
"Header": {
"AppKey": "****",
"Channel": "****",
"ChannelSessionId": "54dsaf4ds3h2g1jhg651d",
"ChannelRequestId": "a7f77648-dfb7-42ef-a4b8-db6b79c1cfab"
},
"Parameters": [
{
"TransactionDate": "2021-12-22T00:00:00",
"CustomerNo": 12695682,
"AccountSuffix":351
}
]
}Response
{
"$type": "ServiceResponseMessage",
"Data": {
"$type": "ReturnedEftListQueryMessage",
"EftInfoList": [
{
"$type": "EftReturnInfo",
"TransferReferenceId": "3af14cf4-4f2e-4a4e-a352-214218d89060",
"TransactionDate": "2021-12-16T00:00:00",
"TransactionBranchCode": 9300,
"LogDate": "2021-12-16T00:00:00",
"LogBranchCode": 9300,
"LogNumber": 66,
"Amount": 1.00,
"EftStatus": {
"$type": "EftStatus",
"Explanation": "bekliyor" //bekliyor, hatali, iade, iptal, tamamlandi.
}
}
]
}
}MoneyOrder
It is the service used for transfer transactions between the customer.
Request:
{
"Header": {
"AppKey": "****",
"Channel": "*****",
"ChannelSessionId": "54dsaf4ds3h2g1jhg651d",
"ChannelRequestId": "a7f77648-dfb7-42ef-a4b8-db6b79c1cfab"
},
"Parameters": [
{
"CustomerNo": 18,
"SourceAccount": {
"AccountSuffix": 351,
"BranchCode": 1000,
"CustomerNo": 18
},
"DestinationAccount": {
"AccountSuffix": 362,
"BranchCode": 9300,
"CustomerNo": 18
},
"Amount": 10,
"Explanation": "Test"
}
]
}Response:
{
"Data": {
"$type": "MoneyOrderMessage",
"AccountingReference": "20",
"State": 2
}
}