Üye İşyeri(Alıcı) Talimat Oluştur
Bu API Üye işyerinin(Alıcı), müşterilerine(Borçlulara) talimat oluşturma işlemini gerçekleştirmektedir. İşlemin tamamlanması için Banka kanallarından(İnternet,Mobil Şube, Vinov App) Vinov Borçlusunun API üzerinden oluşturulan talimatı onaylaması gerekmektedir.
API Bilgileri
URL |
/vinov/createInstruction |
Metot |
POST |
Versiyon |
1.0 |
Scope |
payment |
Yetkilendirme Yöntemi |
b2b_credentials |
Girdi Bilgileri
Alan Adı | Format | Açıklama | Zorunlu/Opsiyonel |
InstructionCreationType |
Integer (1) |
Talimat oluşturma şekli Tckn = 1, Vkn = 2, CepTelefonu = 3, QR = 4 |
Zorunlu |
InstructionAmount |
Decimal (26,2) | Talimat tutarı | Zorunlu |
ExpiryDate |
yyyy-MM-ddTHH24:mm:ss |
Vade tarihi Taksit sayısı 2 ve üstünde ise alan gönderilmemelidir. |
Koşullu Zorunlu |
PaymentPurpose |
Integer (2) |
Ödeme amacı KonutKirasiOdemesi = 1, IsYeriKirasiOdemesi = 2, DigerKiraOdemesi = 3, EticaretOdemesi = 4, CalisanOdemesi = 5, TicariOdeme = 6, BireyselOdeme = 7, Yatirim = 8, Finansal = 9, EgitimOdemesi = 10, AidatOdemesi = 11, Diger = 99 |
Zorunlu |
WorkPlaceId |
Integer (19) |
İşyeri id Firmaya Vinov işyeri tanım esansında verilen benzersiz değerdir. |
Zorunlu |
NumberofInstallments |
Integer (3) |
Taksit sayısı Taksitli işlemi yapılmayacak ise alan değeri 1 gönderilmelidir. Taksitli işlem yapılacak ise alan değeri 2 ve üstünde iletilmelidir. |
Zorunlu |
IdentityTaxNumber |
String (11) |
Borçlu tckn veya vkn Talimat oluşturma şekli 1 ve 2 ise dolu olacaktır. Diğer durumlarda iletilmemelidir. Talimat oluşturma şekli 1 ise 11 hane iletilmelidir. Talimat oluşturma şekli 2 ise 10 hane iletilmelidir. |
Koşullu Zorunlu |
PhoneNumber |
String (10) |
Borçlu cep telefonu Talimat oluşturma şekli 3 ise dolu olmalıdır. Başına 0 eklenmeden iletilmelidir. |
Koşullu Zorunlu |
SellerProductCode |
String (50) | Satıcı Urun Kodu | Opsiyonel |
DealerNumber |
String (100) | Bayi No | Opsiyonel |
InvoiceNumber |
String (50) | Fatura No | Opsiyonel |
InstructionDescription |
String (1000) | Talimat Açıklaması | Opsiyonel |
CustomerNumber |
String (12) |
Borçlı müşteri numarası Alıcı Tckn Vkn / Alıcı Cep Telefon bilgisine ait Vinov tanımlı birden fazla müşteri var ise bu alan dolu olmalıdır. |
Opsiyonel |
Çıktı Bilgileri
Result
Alan Adı | Format | Açıklama |
IsSucceeded |
Bool | İşlem başarılı ise alan True gelecek, hatalı ise false gelecektir. |
Id |
Integer (19) | İşlem başarılı ise dolu gelecektir. |
QRCodeText |
String (1000) | Talimat oluşturma şekli 4 ise alan dolu gelecektir. |
List< FeeInfo >
Alan Adı | Format | Açıklama |
FeeType |
Integer |
Masraf tipi None = 0, Limit = 1, VgoOlusturmaUcreti = 2, BorcluGarantilemeKomisyon = 3, AlacakliGarantilemeKomisyon = 4, Alacakli(Isyeri)Islemucreti = 5 |
FeeAmount |
Decimal | Masraf tutarı |
Mesaj Kodları
Mesaj Kodu | Açıklama |
ACBH000085 |
Ödeme amacı alanına geçersiz bir değer girildi. |
ACBH000101 |
T.C. kimlik numarası boş bırakılamaz. |
ACBH000146 |
T.C. kimlik numarası uygun formatta girilmelidir. |
ACBH000365 |
Vergi Kimlik Numarası boş bırakılamaz. |
ACBH000267 |
Vergi kimlik numarası uygun formatta girilmelidir. |
ACBH000366 |
Cep telefonu numarası boş bırakılamaz. |
ACBH000212 |
Cep telefonu 10 hane olmalı ve 5 ile başlamalıdır. |
ACBH000466 |
Talimat oluşturma tipi alanına geçersiz bir değer girildi. |
ACBH000467 |
Vade Tarihi boş olamaz. |
ACBH000468 |
Vade Tarihi uygun formatta girilmelidir. |
ACBH000237 |
Müşteri numarası uygun formatta girilmelidir. |
Örnek
İstek:
{ "InstructionCreationType": 4, "InstructionAmount": 120, "NumberofInstallments": 1, "ExpiryDate": "2022-08-22T00:00:00", "PaymentPurpose": 1, "WorkPlaceId": 12001, "SellerProductCode": "", "DealerNumber": "", "InvoiceNumber": "", "InstructionDescription": "" }
Cevap:
{ "Header": { "StatusCode": "APIGW000000", "StatusDescription": "Tamamlandı", "StatusDescriptionEn": "Completed", "ObjectID": "1fc285d1-a762-4577-862c-bf3228484b11" }, "Data": { "FeeInfo": [ { "FeeType": 4, "FeeAmount": 2.1 }, { "FeeType": 5, "FeeAmount": 3.26 } ], "Result": { "IsSucceeded": true, "Id": 55018, "QRCodeText": "6303122200002804046304F19C" } } }
-
API URL : https://apigw.vakifbank.com.tr:8443
-
-
-