Cebe Para Gönder
Bu API cep telefonuna para transferi işlemini gerçekleştirmektedir. İşlemin tamamlanabilmesi için İşlem Gerçekleştir API'ından OTP doğrulamasının yapılması gerekmektedir.
API Bilgileri
URL |
/remittanceToPhoneNumber |
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 |
PhoneNumber |
String (10) | Alıcının cep telefonu numarası | Zorunlu |
IdentityNumber |
String (11) | Alıcının T.C. kimlik numarası | 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) | İşlem tutarı | 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ı |
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ı |
Receiver
| Alan Adı | Format | Açıklama |
PhoneNumber |
String | Alıcının cep telefonu numarası |
IdentityNumber |
String | Alıcının T.C. kimlik numarası |
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. |
ACBH000070 |
Alıcının T.C. kimlik numarası boş olamaz. |
ACBH000071 |
Alıcının T.C. kimlik numarası uygun formatta girilmelidir. |
ACBH000098 |
Alıcının telefon numarası boş olamaz. |
ACBH000104 |
İşlem yapmak istediğiniz hesap oturumdaki müşteri numarasına ait değildir. |
ACBH000113 |
Ticari müşteri numarasıyla cebe para gönderme işlemi yapılamaz. |
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. |
ACBH000212 |
Cep telefonu 10 hane olmalı ve 5 ile başlamalıdır. |
ACBH000222 |
Kaynak hesabın döviz cinsi TL olmalıdır. |
ACBH000232 |
Açık Bankacılık kanalında para transferleri sadece vadesiz mevduat hesapları ile yapılabilmektedir. |
ACBH000264 |
Masraf hesabı türü TL olmalıdır. |
ACBH000270 |
Gönderen ve alıcının telefon numarası aynı olamaz. |
ACBH000277 |
Masraf hesap numarası uygun formatta girilmelidir. |
ACBH000283 |
Masraf hesabı oturumdaki müşteri numarasına ait değildir. |
ACBH000288 |
{0} T.C. kimlik numarasına sahip müşteri bulunamadı. |
Örnek
İstek:
{
"Sender": {
"AccountNumber": "00158000000000001"
},
"Receiver": {
"IdentityNumber": "10000000000",
"PhoneNumber": "5000000000"
},
"FeeInformation": {
"AccountNumber": "00158000000000001"
},
"Transaction": {
"Amount": 20,
"Description": "Cebe para gönder"
}
}
Cevap:
{
"Header": {
"StatusCode": "APIGW000000",
"StatusDescription": "Tamamlandı",
"StatusDescriptionEn": "Completed",
"ObjectID": "7b40c4cd-205c-4f67-9bc4-572aab6b930e"
},
"SecurityInformation": {
"OTPTransactionId": 195936,
"OTPStatus": "ApprovementWaiting"
},
"Data": {
"Transaction": {
"Amount": 20
},
"Receiver": {
"NameSurnameTitle": "E*H*N M*S*U*İ*"
}
},
"FeeInformation": {
"TotalFeeAmount": 5,
"CurrencyCode": "TL",
"Fee": {
"CurrencyCode": "TL",
"Amount": 5,
"FeeDescription": "CEBE PARA GÖNDER"
},
"AccountNumber": "00158000000000001"
}
}
İşlem Gerçekleştir
{
"Header": {
"StatusCode": "APIGW000000",
"StatusDescription": "Tamamlandı",
"StatusDescriptionEn": "Completed",
"ObjectID": "7945c4cd-205c-4f67-9bc4-572aab6b930e"
},
"Data": {
"Sender": {
"AccountNumber": "00158000000000001"
},
"Transaction": {
"Description": "Cebe para gönder",
"Amount": 20,
"Date": "2021-30-03T10:32:50",
"TransactionId": 2021000008813021
},
"Receiver": {
"PhoneNumber": 5000000000,
"IdentityNumber": 10000000000
}
},
"FeeInformation": {
"TotalFeeAmount": 5.0,
"CurrencyCode": "TL",
"AccountNumber": "00158000000000001"
}
}
-
API URL : https://apigw.vakifbank.com.tr:8443
-
-
-