Hızlı Başlangıç

VakıfBank Sanal POS API entegrasyonuna hoş geldiniz. Bu doküman, provizyon API'si üzerinden gerçekleştirilebilecek tüm işlem tiplerini kapsamaktadır.

⚠️

Dikkat: Bu doküman test ortamı içindir. Production entegrasyonu için lütfen canlı ortam bilgilerinizi kullanın.

Temel Gereksinimler

Vakıfbank üye işyeri hesabı
Merchant ID ve Terminal numarası
SSL sertifikası (production için)
HTTPS destekli web sunucusu

Entegrasyon Adımları

1

Test Bilgilerinizi Alın

Vakıfbank'tan test ortamı için gerekli bilgileri temin edin.

2

Enrollment API'yi Entegre Edin

3D Secure doğrulama için enrollment servisini kullanın.

3

3D Secure Akışını Tamamlayın

Müşterinizi banka doğrulama sayfasına yönlendirin.

4

Provizyon İsteği Gönderin

Son adımda ödemeyi tamamlayın.

Kimlik Doğrulama

Her istek XML body içinde aşağıdaki üç alan ile kimlik doğrulanır:

Alan	Açıklama	Test Değeri
`MerchantId`	15 haneli üye işyeri numarası	`000000000007955`
`Password`	Üye işyeri şifresi	`123Ab456`
`TerminalNo`	Terminal numarası	`VP000123`

ℹ️

Güvenlik: Password alanını asla client-side kodda saklamayın. İstekleri mutlaka sunucu tarafından oluşturun.

Test Ortamı

Endpoint'ler

Servis	URL	Method
Ana İşlemler	`https://apiportalprep.vakifbank.com.tr:8443/virtualPos/Vposreq`	POST
Sigorta	`https://apiportalprep.vakifbank.com.tr:8443/virtualPos/transaction/insurance`	POST
İşlem Sorgulama	`https://apiportalprep.vakifbank.com.tr:8443/virtualPos/Search`	POST
Settlement	`https://apigw.vakifbank.com.tr:8443/virtualPos/Settlement`	POST
SettlementDetail	`https://apigw.vakifbank.com.tr:8443/virtualPos/SettlementDetail`	POST
OpenBatch	`https://apiportalprep.vakifbank.com.tr:8443/virtualPos/SucceededOpenBatchTransactions`	POST
Token (JSON)	`https://apiportalprep.vakifbank.com.tr:8443/virtualPos/token`	POST
Müşteri Ekle	`https://apiportalprep.vakifbank.com.tr:8443/virtualPos/CreateCustomer`	POST
Müşteri Güncelle	`https://apiportalprep.vakifbank.com.tr:8443/virtualPos/UpdateCustomer`	POST
Kart Ekle	`https://apiportalprep.vakifbank.com.tr:8443/virtualPos/CreateCustomerPan`	POST
Kart Güncelle	`https://apiportalprep.vakifbank.com.tr:8443/virtualPos/UpdateCustomerPan`	POST
Kart Sil	`https://apiportalprep.vakifbank.com.tr:8443/virtualPos/DeleteCustomerPan`	POST
SOAP	`https://apiportalprep.vakifbank.com.tr:8443/virtualPos/TransactionServices.asmx`	POST

Test Kimlik Bilgileri

Test Credentials

MerchantId : 000000000007955
Password   : 123Ab456
TerminalNo : VP000123

İstek Formatı

Tüm ana işlem istekleri multipart/form-data veya application/x-www-form-urlencoded olarak gönderilir. İstek gövdesi tek bir prmstr anahtarı içerir ve değeri URL-encode edilmiş XML string'dir.

Form-data İstek Yapısı

POST https://apiportalprep.vakifbank.com.tr:8443/virtualPos/Vposreq
Content-Type: application/x-www-form-urlencoded

prmstr=<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>Sale</TransactionType>
  <CurrencyAmount>10.5</CurrencyAmount>
  <CurrencyCode>949</CurrencyCode>
  <Pan>5521010140829928</Pan>
  <Expiry>202912</Expiry>
  <Cvv>000</Cvv>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

Ortak Alanlar

Alan	Tip	Zorunlu	Açıklama
`MerchantId`	String(15)	✓	Üye işyeri numarası
`Password`	String	✓	Üye işyeri şifresi
`TerminalNo`	String	✓	Terminal numarası
`TransactionType`	String	✓	İşlem tipi (Sale, Auth, Capture, Cancel, Refund…)
`CurrencyAmount`	Decimal	✓	İşlem tutarı (örn: 10.5)
`CurrencyCode`	String	✓	Para birimi kodu (949=TRY, 840=USD, 978=EUR)
`Pan`	String(16)	✓*	Kart numarası (*PanCode kullanılmıyorsa zorunlu)
`Expiry`	String(6)	✓	Son kullanma tarihi (YYYYMM formatı, örn: 202912)
`Cvv`	String(3-4)	-	Kart güvenlik kodu
`ClientIp`	String	✓	Kart sahibinin IP adresi
`TransactionDeviceSource`	Int	✓	0=Web, 1=Mobil

3D Enrollment

3D Secure ödeme akışının ilk adımıdır. Kart bilgileri bu servise gönderilir; servis kartın 3D Secure'e kayıtlı olup olmadığını kontrol eder ve banka doğrulama sayfasına yönlendirmek için gerekli verileri döner.

ℹ️

Akış: Enrollment → ACS Form Post (banka sayfası) → Kullanıcı doğrulama → SuccessUrl/FailureUrl callback → Provizyon (Sale/Auth)

Endpoint'ler

Yöntem	URL	Content-Type
Form-Data	`https://inbound.apigatewaytest.vakifbank.com.tr:8443/threeDGateway/Enrollment`	multipart/form-data
JSON	`https://inbound.apigatewaytest.vakifbank.com.tr:8443/threeDGateway/ProcessEnrollment`	application/json

3D Enrollment — Form-Data İsteği

Kart bilgileri multipart/form-data olarak gönderilir. Klasik HTML form entegrasyonları için tercih edilen yöntemdir.

Enrollment — Form-Data Request

POST https://inbound.apigatewaytest.vakifbank.com.tr:8443/threeDGateway/Enrollment
Content-Type: multipart/form-data

Pan=5521010140829928
ExpiryDate=2912
PurchaseAmount=10.50
Currency=949
VerifyEnrollmentRequestId=123fdsfdassdsddsadsddddh
MerchantId=000000000007955
MerchantPassword=123Ab456
BrandName=100
SessionInfo=abc123xyzsdsdsddfdfsssssssssaasdasd
SuccessUrl=http://google.com
FailureUrl=http://vakifbank.com.tr
Language=tr-TR
BrowserIpAddress=192.168.1.1

Request Parametreleri

Alan	Tip	Zorunlu	Açıklama
`Pan`	String(16)	✓	Kart numarası
`ExpiryDate`	String(4)	✓	Son kullanma tarihi — YYMM formatı (örn: `2912` → Aralık 2029)
`PurchaseAmount`	Decimal	✓	İşlem tutarı (örn: `10.50`)
`Currency`	String(3)	✓	Para birimi ISO kodu (949=TRY, 840=USD, 978=EUR)
`VerifyEnrollmentRequestId`	String	✓	Benzersiz istek kimliği — her istekte farklı olmalı
`MerchantId`	String(15)	✓	Üye işyeri numarası
`MerchantPassword`	String	✓	Üye işyeri şifresi
`BrandName`	String	✓	Kart markası (100=VISA, 200=Mastercard)
`SessionInfo`	String	-	Oturum bilgisi — işlemi takip etmek için kullanılır, callback URL'de geri döner
`SuccessUrl`	String	✓	Başarılı doğrulama sonrası yönlendirme URL'i
`FailureUrl`	String	✓	Başarısız doğrulama sonrası yönlendirme URL'i
`Language`	String	-	Banka doğrulama sayfası dili (örn: `tr-TR`, `en-US`)
`BrowserIpAddress`	String	-	Kart sahibinin tarayıcı IP adresi

3D Enrollment — JSON İsteği

application/json body ile gönderilen alternatif yöntemdir. Alt bayi (sub-merchant) senaryolarında MerchantType ve SubMerchantId ek olarak iletilir.

ProcessEnrollment — JSON Request

POST https://inbound.apigatewaytest.vakifbank.com.tr:8443/threeDGateway/ProcessEnrollment
Content-Type: application/json

{
  "Pan": "4938410109068353",
  "ExpiryDate": "2912",
  "PurchaseAmount": 100.0,
  "Currency": "949",
  "VerifyEnrollmentRequestId": "emocanankssarass7",
  "MerchantId": "000000000011445",
  "MerchantPassword": "Ab123456",
  "MerchantType": "2",
  "SubMerchantId": "000100000012805",
  "SuccessUrl": "http://google.com",
  "FailureUrl": "http://vakifbank.com.tr"
}

Ek JSON Parametreleri

Alan	Tip	Zorunlu	Açıklama
`MerchantType`	String	-	Bayi tipi: `1`=Ana Bayi, `2`=Alt Bayi. Belirtilmezse standart merchant kabul edilir.
`SubMerchantId`	String(15)	-	Alt bayi numarası. `MerchantType=2` ise zorunludur.
`PurchaseAmount`	Number	✓	JSON yönteminde sayısal değer olarak gönderilir (string değil)

⚠️

Dikkat: JSON yönteminde PurchaseAmount string değil sayısal (100.0) olarak gönderilmelidir. Form-data yönteminde ise string olarak iletilir.

3D Enrollment — Response Alanları

Başarılı enrollment yanıtında ACS form post için gereken değerler döner.

Enrollment — Örnek Response

{
  "Status": "Y",
  "ResponseCode": "00",
  "ResponseMessage": "Success",
  "IsEnrolled": true,
  "AcsUrl": "https://inbound.apigatewaytest.vakifbank.com.tr:8443/threeDGateway/startThreeDFlow",
  "PaReq": "eJxVUttuwjAM/JWK90KS0oZWiILGpqFtXA...",
  "TermUrl": "https://inbound.apigateway.vakifbank.com.tr:8443/threeDGateway/startThreeDFlow",
  "MD": "G8kk8MZ8tS8kk8MZ8tS8kk8MZ8tS8...",
  "VerifyEnrollmentRequestId": "123fdsfdassdsddsadsddddh"
}

Alan	Açıklama
`Status`	`Y`=Kayıtlı ve doğrulama gerekli, `N`=Kayıtlı değil (doğrulama yapılmadan devam), `U`=Bilinmiyor
`IsEnrolled`	Kartın 3D Secure'e kayıtlı olup olmadığı
`AcsUrl`	Kullanıcının yönlendirileceği banka doğrulama sayfası URL'i
`PaReq`	Payer Authentication Request — ACS sayfasına POST edilecek şifreli doğrulama isteği
`TermUrl`	Banka doğrulaması tamamlandığında bankanın POST edeceği callback URL
`MD`	Merchant Data — işlem oturumunu tanımlayan şifreli veri, ACS'e gönderilir

ACS Form Post

Enrollment response'undan gelen AcsUrl, PaReq, TermUrl ve MD değerleri kullanılarak kullanıcı otomatik olarak bankanın doğrulama sayfasına yönlendirilir.

⚠️

Önemli: Bu POST işlemi sunucudan değil, kullanıcının tarayıcısından (client-side) yapılmalıdır. Sayfa yüklendiğinde form otomatik submit edilir.

ACS Form Post — HTML

<!-- Enrollment response'undan gelen değerlerle doldurulur -->
<form id="acsForm" method="POST" action="{AcsUrl}">
    <input type="hidden" name="PaReq"  value="{PaReq}" />
    <input type="hidden" name="TermUrl" value="{TermUrl}" />
    <input type="hidden" name="MD"     value="{MD}" />
</form>

<script>
    // Sayfa yüklenir yüklenmez formu otomatik gönder
    document.getElementById('acsForm').submit();
</script>

ASP.NET Core — Razor ile Dinamik ACS Yönlendirme

// Controller
[HttpPost]
public IActionResult RedirectToAcs(EnrollmentResponseModel response)
{
    ViewBag.AcsUrl  = response.AcsUrl;
    ViewBag.PaReq   = response.PaReq;
    ViewBag.TermUrl = response.TermUrl;
    ViewBag.MD      = response.MD;
    return View("AcsRedirect");
}

// AcsRedirect.cshtml
@{
    Layout = null; // Temiz sayfa, sadece form
}
<!DOCTYPE html>
<html>
<body onload="document.getElementById('acsForm').submit()">
    <form id="acsForm" method="POST" action="@ViewBag.AcsUrl">
        <input type="hidden" name="PaReq"  value="@ViewBag.PaReq" />
        <input type="hidden" name="TermUrl" value="@ViewBag.TermUrl" />
        <input type="hidden" name="MD"     value="@ViewBag.MD" />
    </form>
</body>
</html>

ACS Sonrası Gelen Callback

Kullanıcı doğrulamayı tamamladıktan sonra banka, Success veya FailUrl'e aşağıdaki alanları POST eder:

Alan	Açıklama
`MerchantId`	İşlem yapılan üye işyeri numarası
`Pan`	İşlem yapılan kartın ilk 8 ve son 4 hanesi.
`PanEncrypted`	Şifrelenmiş kart bilgisi.
`Expiry`	İşlem yapılan kartın son kullanma tarihi.
`PurchAmount`	İşlem tutarı.
`PurchCurrency`	İşlem para birimi kodu.
`VerifyEnrollmentRequestId`	İşlem numarası.
`SessionInfo`	İşlem session bilgisi.
`Status`	İşlem durumu.
`Cavv`	İşlem CAVV bilgisi.
`Eci`	İşlem ECI bilgisi.
`ExpSign`	İşlem ExpSign bilgisi.
`InstallmentCount`	İşlem taksit sayısı.
`SubMerchantNo`	Alt üye işyeri numarası.
`SubMerchantName`	Alt üye işyeri adı.
`SubMerchantNumber`	Alt üye işyeri numarası.
`MdStatus`	MD durumu.(1 = Başarılı, 0 = Başarısız.
`Hash`	İşlem hash bilgisi.
`ErrorCode`	Hata kodu.
`ErrorMessage`	Hata mesajı.

ℹ️

Sonraki adım: Success veya FailUrl callback'inde alınan verilerle ECI, CAVV ve MpiTransactionId değerleri çözümlenir. Bu değerler provizyon isteğine (Sale, Auth) eklenerek 3D Secure satış tamamlanır.

Tam 3D Secure Akış Özeti

1

Enrollment İsteği

Kart bilgileri ve callback URL'leri /threeDGateway/Enrollment veya /threeDGateway/ProcessEnrollment'a gönderilir.

2

ACS Form Post

Response'dan gelen AcsUrl'e PaReq, TermUrl ve MD ile HTML form POST yapılır. Kullanıcı bankanın doğrulama sayfasına yönlendirilir.

3

Kullanıcı Doğrulama

Kullanıcı SMS OTP veya uygulama doğrulamasını tamamlar.

4

Success ve FailUrl Callback

Banka PaRes ve MD ile Success veya FailUrl'e POST eder. ECI, CAVV ve MpiTransactionId bu yanıttan alınır.

5

Provizyon (3D Sale)

ECI, CAVV ve MpiTransactionId değerleri eklenerek Vposreq'e 3D Sale isteği gönderilir.

Satış (Sale)

Standart tek çekim satış işlemidir. Müşteriden anında tahsilat yapılır.

Sale — XML Request (prmstr)

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>Sale</TransactionType>
  <CurrencyAmount>10.5</CurrencyAmount>
  <CurrencyCode>949</CurrencyCode>
  <Pan>5521010140829928</Pan>
  <Expiry>202912</Expiry>
  <Cvv>000</Cvv>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

3D Satış

3D Secure doğrulamasından geçirilmiş satış işlemidir. ECI, CAVV ve MpiTransactionId değerleri 3D Secure yanıtından alınır.

3D Sale — XML Request (prmstr)

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>Sale</TransactionType>
  <CurrencyAmount>10.5</CurrencyAmount>
  <CurrencyCode>949</CurrencyCode>
  <Pan>5521010140829928</Pan>
  <Expiry>202912</Expiry>
  <Cvv>000</Cvv>
  <ECI>05</ECI>
  <CAVV>AAABCSIlCAAAAAACfSIIAAAAAAA=</CAVV>
  <MpiTransactionId>97f34f85-1234-1234-1234-8ef7d517c2d7</MpiTransactionId>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

3D Alanları

Alan	Açıklama
`ECI`	Electronic Commerce Indicator (05=Visa tam doğrulama, 02=Mastercard tam doğrulama)
`CAVV`	Cardholder Authentication Verification Value — 3D Secure yanıtından gelen token
`MpiTransactionId`	MPI tarafından üretilen benzersiz işlem kimliği

Taksitli Satış

Kart sahibinin ödemesini belirtilen taksit sayısına yayar.

Taksitli Satış — XML Request

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>Sale</TransactionType>
  <NumberOfInstallments>3</NumberOfInstallments>
  <CurrencyAmount>10.5</CurrencyAmount>
  <CurrencyCode>949</CurrencyCode>
  <Pan>5521010140829928</Pan>
  <Expiry>202912</Expiry>
  <Cvv>000</Cvv>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

Alan	Açıklama
`NumberOfInstallments`	Taksit sayısı (2-12 arası, 0 veya 1 = tek çekim)

VFTSale (Esnek Taksit)

VakıfBank'a özgü esnek taksit satış işlemidir. Taksit sayısı ve taksit miktarları özelleştirilebilir.

VFTSale — XML Request

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>VFTSale</TransactionType>
  <NumberOfInstallments>3</NumberOfInstallments>
  <CurrencyAmount>10.5</CurrencyAmount>
  <CurrencyCode>949</CurrencyCode>
  <Pan>5521010140829928</Pan>
  <Expiry>202912</Expiry>
  <Cvv>000</Cvv>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

Ön Provizyon (Auth)

Karttan tutar bloke edilir, tahsilat daha sonra Capture ile tamamlanır. Otel, araç kiralama gibi senaryolarda kullanılır.

Auth — XML Request

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>Auth</TransactionType>
  <CurrencyAmount>10.5</CurrencyAmount>
  <CurrencyCode>949</CurrencyCode>
  <Pan>5521010140829928</Pan>
  <Expiry>202912</Expiry>
  <Cvv>000</Cvv>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

Capture (Satış Tamamlama)

Auth ile bloke edilen tutarın tahsil edilmesi için kullanılır. ReferenceTransactionId olarak Auth işleminin sonuç ID'si verilir.

Capture — XML Request

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>Capture</TransactionType>
  <ReferenceTransactionId>AUTH_ISLEM_ID</ReferenceTransactionId>
  <CurrencyAmount>10.5</CurrencyAmount>
  <CurrencyCode>949</CurrencyCode>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

İptal (Cancel)

Aynı gün içinde gerçekleştirilen bir işlemin iptal edilmesi için kullanılır. ReferenceTransactionId zorunludur.

Cancel — XML Request

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>Cancel</TransactionType>
  <ReferenceTransactionId>SATISLIN_ISLEM_ID</ReferenceTransactionId>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

İade (Refund)

Önceki bir işlemin kısmen veya tamamı iade edilir. İptalden farklı olarak farklı günlerde uygulanabilir.

Refund — XML Request

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>Refund</TransactionType>
  <ReferenceTransactionId>SATISLIN_ISLEM_ID</ReferenceTransactionId>
  <CurrencyAmount>10.5</CurrencyAmount>
  <CurrencyCode>949</CurrencyCode>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

Eşleniksiz İade (Credit)

Referans işlem numarası olmaksızın yapılan iadedir. Orijinal satış işlemi ile bağlantısı bulunmaz.

Credit — XML Request

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>Credit</TransactionType>
  <CurrencyAmount>10.5</CurrencyAmount>
  <CurrencyCode>949</CurrencyCode>
  <Pan>5521010140829928</Pan>
  <Expiry>202912</Expiry>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

Puan ile Satış (PointSale)

Müşterinin kart puanlarının bir kısmını veya tamamını kullanarak ödeme yapmasını sağlar.

PointSale — XML Request

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>Sale</TransactionType>
  <CurrencyAmount>10.5</CurrencyAmount>
  <CurrencyCode>949</CurrencyCode>
  <Pan>5521010140829928</Pan>
  <Expiry>202912</Expiry>
  <Cvv>000</Cvv>
  <PointAmount>5.00</PointAmount>
  <PointCode>1</PointCode>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

Alan	Açıklama
`PointAmount`	Kullanılacak puan miktarı
`PointCode`	Puan tipi kodu (1 = standart puan)

Surcharge Satış

İşlem tutarına ek masraf (surcharge) eklenerek yapılan satış işlemidir.

Surcharge — XML Request

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>Sale</TransactionType>
  <CurrencyAmount>10.5</CurrencyAmount>
  <CurrencyCode>949</CurrencyCode>
  <Pan>5521010140829928</Pan>
  <Expiry>202912</Expiry>
  <Cvv>000</Cvv>
  <SurchargeAmount>1.00</SurchargeAmount>
  <ECI>05</ECI>
  <ExpSign></ExpSign>
  <Extract></Extract>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

Alan	Açıklama
`SurchargeAmount`	Eklenen surcharge tutarı
`ECI`	Electronic Commerce Indicator
`ExpSign`	Açıklama imzası (opsiyonel)
`Extract`	Ekstre bilgisi (opsiyonel)

AmountShare Ödeme

İşlem tutarının birden fazla alıcıya paylaştırılarak yapılan ödeme türüdür.

AmountShare — XML Request

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>Sale</TransactionType>
  <CurrencyAmount>10.5</CurrencyAmount>
  <CurrencyCode>949</CurrencyCode>
  <Pan>5521010140829928</Pan>
  <Expiry>202912</Expiry>
  <Cvv>000</Cvv>
  <AmountShare>5.00</AmountShare>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

Sigorta Satışı

İki farklı yöntemle sigorta satışı yapılabilir: standart prmstr endpoint ve özel /transaction/insurance endpoint'i.

Yöntem 1 — prmstr ile

Sale Insurance — prmstr XML

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>Sale</TransactionType>
  <CurrencyAmount>10.5</CurrencyAmount>
  <CurrencyCode>949</CurrencyCode>
  <Pan>5521010140829928</Pan>
  <Expiry>202912</Expiry>
  <Cvv>000</Cvv>
  <InquiryValue>INQUIRY123</InquiryValue>
  <CardNoFirst>552101</CardNoFirst>
  <CardNoLast>9928</CardNoLast>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

Yöntem 2 — /transaction/insurance endpoint'i

Sale Insurance Copy — Endpoint

POST https://apiportalprep.vakifbank.com.tr:8443/virtualPos/transaction/insurance
Content-Type: application/x-www-form-urlencoded

prmstr=<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>Sale</TransactionType>
  <CurrencyAmount>10.5</CurrencyAmount>
  <CurrencyCode>949</CurrencyCode>
  <Pan>5521010140829928</Pan>
  <Expiry>202912</Expiry>
  <Cvv>000</Cvv>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

Alan	Açıklama
`InquiryValue`	Sigorta sorgu değeri
`CardNoFirst`	Kart numarası ilk 6 hane
`CardNoLast`	Kart numarası son 4 hane

Tarım Kart İşlemleri

Tarım Kredi Kooperatifi üyelerine özel taksitli ve esnek ödeme planı sunan işlem tiplerine aittir.

TKSale — Eşit Taksit

TKSale (Eşit Taksit) — XML Request

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>TKSale</TransactionType>
  <CurrencyAmount>100.00</CurrencyAmount>
  <CurrencyCode>949</CurrencyCode>
  <Pan>5521010140829928</Pan>
  <Expiry>202912</Expiry>
  <Cvv>000</Cvv>
  <CustomInstallments>3</CustomInstallments>
  <MaturityPeriod>30</MaturityPeriod>
  <Frequency>Monthly</Frequency>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

TKFlexSale — Esnek Taksit

TKFlexSale (Esnek Taksit) — XML Request

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>TKFlexSale</TransactionType>
  <CurrencyAmount>100.00</CurrencyAmount>
  <CurrencyCode>949</CurrencyCode>
  <Pan>5521010140829928</Pan>
  <Expiry>202912</Expiry>
  <Cvv>000</Cvv>
  <CustomInstallments>
    <Installment>
      <InstallmentDate>2025-03-01</InstallmentDate>
      <InstallmentAmount>40.00</InstallmentAmount>
    </Installment>
    <Installment>
      <InstallmentDate>2025-06-01</InstallmentDate>
      <InstallmentAmount>60.00</InstallmentAmount>
    </Installment>
  </CustomInstallments>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

TKLimitSearch — Limit Sorgu

TKLimitSearch — XML Request

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>TKLimitSearch</TransactionType>
  <Pan>5521010140829928</Pan>
  <Expiry>202912</Expiry>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

TKPlanSearch — Ödeme Planı Sorgu

TKPlanSearch — XML Request

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>TKPlanSearch</TransactionType>
  <ReferenceTransactionId>TKSALE_ISLEM_ID</ReferenceTransactionId>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

Alan	Açıklama
`CustomInstallments`	Taksit sayısı (TKSale için integer) veya taksit detayları dizisi (TKFlexSale için XML)
`MaturityPeriod`	Vade süresi (gün cinsinden, örn: 30)
`Frequency`	Ödeme sıklığı (Monthly, Weekly vb.)

Teknik İptal (Reversal)

Teknik bir hata nedeniyle işlemin geri alınması gerektiğinde kullanılır. İptalden farklı olarak işlem mali kayıtlara yansımadan silinir.

Reversal — XML Request

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>Reversal</TransactionType>
  <ReferenceTransactionId>IPTAL_EDILECEK_ISLEM_ID</ReferenceTransactionId>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

PanCode ile Satış

Kart numarası yerine PanCode (tokenize kart referansı) kullanılarak yapılan satış işlemidir.

PanCode Satış — XML Request

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>Sale</TransactionType>
  <CurrencyAmount>10.5</CurrencyAmount>
  <CurrencyCode>949</CurrencyCode>
  <PanCode>PANCODE_DEGERI</PanCode>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

Recurring İşlem

Belirli aralıklarla otomatik olarak tekrar eden ödeme talimatıdır. Abonelik sistemleri için uygundur.

Recurring — XML Request

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>Sale</TransactionType>
  <CurrencyAmount>10.5</CurrencyAmount>
  <CurrencyCode>949</CurrencyCode>
  <Pan>5521010140829928</Pan>
  <Expiry>202912</Expiry>
  <Cvv>000</Cvv>
  <IsRecurring>1</IsRecurring>
  <RecurringFrequencyType>Monthly</RecurringFrequencyType>
  <RecurringFrequency>1</RecurringFrequency>
  <TriggerDate>20250201</TriggerDate>
  <RecurringInstallmentCount>12</RecurringInstallmentCount>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

Alan	Açıklama
`IsRecurring`	1 = recurring işlem aktif
`RecurringFrequencyType`	Tekrar sıklığı tipi (Monthly, Weekly, Daily)
`RecurringFrequency`	Sıklık değeri (örn: 1 = ayda 1 kez)
`TriggerDate`	İlk çekim tarihi (YYYYMMDD formatı)
`RecurringInstallmentCount`	Toplam tekrar sayısı (örn: 12 ay)

Recurring — Müşteri Yönetimi

Recurring işlemlerde müşteri kayıt, güncelleme ve silme işlemleri.

Müşteri Ekle

CreateCustomer — Endpoint: /virtualPos/CreateCustomer

POST https://apiportalprep.vakifbank.com.tr:8443/virtualPos/CreateCustomer
Content-Type: application/x-www-form-urlencoded

prmstr=<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <CustomerName>Ali Veli</CustomerName>
  <CustomerEmail>ali.veli@email.com</CustomerEmail>
  <CustomerPhone>5551234567</CustomerPhone>
</VposRequest>

Müşteri Güncelle

UpdateCustomer — Endpoint: /virtualPos/UpdateCustomer

POST https://apiportalprep.vakifbank.com.tr:8443/virtualPos/UpdateCustomer
Content-Type: application/x-www-form-urlencoded

prmstr=<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <CustomerId>MUSTERI_ID</CustomerId>
  <CustomerName>Ali Veli Güncellendi</CustomerName>
  <CustomerEmail>yeni@email.com</CustomerEmail>
</VposRequest>

Recurring — Kart Yönetimi

Recurring müşterisine ait kartların eklenmesi, güncellenmesi ve silinmesi.

Kart Ekle

CreateCustomerPan — Endpoint: /virtualPos/CreateCustomerPan

POST https://apiportalprep.vakifbank.com.tr:8443/virtualPos/CreateCustomerPan
Content-Type: application/x-www-form-urlencoded

prmstr=<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <CustomerId>MUSTERI_ID</CustomerId>
  <Pan>5521010140829928</Pan>
  <Expiry>202912</Expiry>
</VposRequest>

Kart Güncelle

UpdateCustomerPan — Endpoint: /virtualPos/UpdateCustomerPan

POST https://apiportalprep.vakifbank.com.tr:8443/virtualPos/UpdateCustomerPan
Content-Type: application/x-www-form-urlencoded

prmstr=<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <PanCode>MEVCUT_PANCODE</PanCode>
  <Pan>5521010140829929</Pan>
  <Expiry>203001</Expiry>
</VposRequest>

Kart Sil

DeleteCustomerPan — Endpoint: /virtualPos/DeleteCustomerPan

POST https://apiportalprep.vakifbank.com.tr:8443/virtualPos/DeleteCustomerPan
Content-Type: application/x-www-form-urlencoded

prmstr=<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <PanCode>SILINECEK_PANCODE</PanCode>
</VposRequest>

Alt Bayi — NS (Non-3D) Satış

Ana bayi üzerinden alt bayi adına yapılan satış işlemidir. HostSubMerchantId ve MerchantType alanları zorunludur.

Alt Bayi NS Satış — XML Request

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>Sale</TransactionType>
  <CurrencyAmount>10.5</CurrencyAmount>
  <CurrencyCode>949</CurrencyCode>
  <Pan>5521010140829928</Pan>
  <Expiry>202912</Expiry>
  <Cvv>000</Cvv>
  <HostSubMerchantId>ALT_BAYI_ID</HostSubMerchantId>
  <MerchantType>2</MerchantType>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

Alan	Açıklama
`HostSubMerchantId`	Alt bayinin submerchnat ID / kodu
`MerchantType`	1 = Ana Bayi, 2 = Alt Bayi

Alt Bayi — 3D Satış

Alt bayi adına yapılan 3D Secure satış işlemi. Hem Bayi alanları hem de 3D alanları gereklidir.

Alt Bayi 3D Satış — XML Request

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>Sale</TransactionType>
  <CurrencyAmount>10.5</CurrencyAmount>
  <CurrencyCode>949</CurrencyCode>
  <Pan>5521010140829928</Pan>
  <Expiry>202912</Expiry>
  <Cvv>000</Cvv>
  <ECI>05</ECI>
  <CAVV>AAABCSIlCAAAAAACfSIIAAAAAAA=</CAVV>
  <MpiTransactionId>97f34f85-1234-1234-1234-8ef7d517c2d7</MpiTransactionId>
  <HostSubMerchantId>ALT_BAYI_ID</HostSubMerchantId>
  <MerchantType>2</MerchantType>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

Bayi İptal ve İade

Alt bayi işlemlerinin iptali için HostSubMerchantId ve MerchantType alanları eklenir.

Alt Bayi Cancel — XML Request

<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionType>Cancel</TransactionType>
  <ReferenceTransactionId>SATIS_ISLEM_ID</ReferenceTransactionId>
  <HostSubMerchantId>ALT_BAYI_ID</HostSubMerchantId>
  <MerchantType>2</MerchantType>
  <ClientIp>190.20.13.12</ClientIp>
  <TransactionDeviceSource>0</TransactionDeviceSource>
</VposRequest>

İşlem Sorgulama

Gerçekleştirilen işlemlerin detaylarını sorgulamak için /virtualPos/Search endpoint'i kullanılır.

Search — XML Request

POST https://apiportalprep.vakifbank.com.tr:8443/virtualPos/Search
Content-Type: application/x-www-form-urlencoded

prmstr=<SearchRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <TransactionId>SORGULANAN_ISLEM_ID</TransactionId>
</SearchRequest>

ℹ️

Root element <SearchRequest> olarak gönderilir, <VposRequest> değil.

Settlement (Mutabakat)

Gün sonu mutabakat sorgulama işlemleri. Bu endpoint farklı bir base URL kullanır: apigw.vakifbank.com.tr

Settlement (Kırılım)

Settlement — XML Request

POST https://apigw.vakifbank.com.tr:8443/virtualPos/Settlement
Content-Type: application/x-www-form-urlencoded

prmstr=<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <StartDate>2025-01-01</StartDate>
  <EndDate>2025-01-31</EndDate>
</VposRequest>

SettlementDetail (Detay)

SettlementDetail — XML Request

POST https://apigw.vakifbank.com.tr:8443/virtualPos/SettlementDetail
Content-Type: application/x-www-form-urlencoded

prmstr=<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
  <ReferenceTransactionId>ISLEM_ID</ReferenceTransactionId>
</VposRequest>

Günsonuna Girecek İşlemler

Gün sonu kapanışından önce bekleyen açık batch işlemlerini listeler.

SucceededOpenBatchTransactions — XML Request

POST https://apiportalprep.vakifbank.com.tr:8443/virtualPos/SucceededOpenBatchTransactions
Content-Type: application/x-www-form-urlencoded

prmstr=<VposRequest>
  <MerchantId>000000000007955</MerchantId>
  <Password>123Ab456</Password>
  <TerminalNo>VP000123</TerminalNo>
</VposRequest>

JSON API — Token Alma

Bearer token bazlı JSON API'ye erişmek için önce token alınmalıdır. Bu endpoint XML yerine JSON kabul eder.

Token Alma — JSON Request

POST https://apiportalprep.vakifbank.com.tr:8443/virtualPos/token
Content-Type: application/json

{
  "MerchantId": "000000000007955",
  "Password": "123Ab456",
  "TerminalNo": "VP000123"
}

Token Response

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}

JSON API — Recurring Yönetimi

Token alındıktan sonra Bearer auth ile recurring işlem detayları sorgulanabilir ve düzenlenebilir.

BatchTransactionSumDetail

BatchTransactionSumDetail — Bearer Auth

POST https://apiportalprep.vakifbank.com.tr:8443/virtualPos/BatchTransactionSumDetail
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "MerchantId": "000000000007955",
  "TerminalNo": "VP000123",
  "StartDate": "2025-01-01",
  "EndDate": "2025-01-31"
}

EditMerchantRecurringTransaction

EditMerchantRecurringTransaction — Bearer Auth

POST https://apiportalprep.vakifbank.com.tr:8443/virtualPos/EditMerchantRecurringTransaction
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "MerchantId": "000000000007955",
  "TransactionId": "RECURRING_ISLEM_ID",
  "Status": "P"
}

Ortak Ödeme & Link ile Ödeme

Tek bir API ile hem Ortak Ödeme Sayfası (hosted payment) hem de Link ile Ödeme (ödeme linki SMS/Mail/Push ile gönderme) işlemleri yapılır. Farkı TransactionSource alanı belirler.

ℹ️

Nasıl çalışır? Token oluşturulur → Müşteri ödeme sayfasına yönlendirilir (Ortak Ödeme) veya müşteriye link gönderilir (Link ile Ödeme) → Ödeme tamamlanınca SuccessUrl/FailUrl'e yönlendirme yapılır.

Endpoint'ler

İşlem	URL	Content-Type
Token Oluştur (URL-encoded)	`https://inbound.apigatewaytest.vakifbank.com.tr:8443/commonPayment/CreateToken`	application/x-www-form-urlencoded
Token Oluştur (JSON)	`https://inbound.apigatewaytest.vakifbank.com.tr:8443/commonPayment/CreateTokenCPY`	application/json
Token Sorgula	`https://inbound.apigatewaytest.vakifbank.com.tr:8443/commonPayment/GetVposTransaction`	application/json

TransactionSource Değerleri

Değer	Açıklama
`1`	Ortak Ödeme — Müşteri ödeme sayfasına yönlendirilir
`2`	Link ile Ödeme — Müşteriye bildirim (SMS/Mail/Push) gönderilir

TokenExpireTime Değerleri

Değer	Süre
`1`	1 Saat
`2`	3 Saat
`3`	6 Saat
`4`	12 Saat

Token Oluşturma — URL-Encoded Form

application/x-www-form-urlencoded ile token oluşturur. Genellikle sunucu taraflı form submit entegrasyonlarında kullanılır.

CreateToken — URL-Encoded Request

POST https://inbound.apigatewaytest.vakifbank.com.tr:8443/commonPayment/CreateToken
Content-Type: application/x-www-form-urlencoded

Amount=1.00
AmountCode=949
IsSecure=true
HostMerchantID=000000000007955
HostTerminalId=VP000123
MerchantPassword=123Ab456
TransactionType=Sale
SuccessUrl=http://www.vakifbank.com.tr
FailUrl=http://www.google.com.tr
AllowNotEnrolledCard=false
TokenExpireTime=1

Request Parametreleri

Alan	Tip	Zorunlu	Açıklama
`HostMerchantID`	String(15)	✓	Üye işyeri numarası
`HostTerminalId`	String	✓	Terminal numarası
`MerchantPassword`	String	✓	Üye işyeri şifresi
`Amount`	Decimal	✓	İşlem tutarı (örn: `1.00`)
`AmountCode`	String(3)	✓	Para birimi ISO kodu (949=TRY, 840=USD, 978=EUR)
`TransactionType`	String	✓	İşlem tipi (Sale, Auth)
`IsSecure`	Boolean	✓	`true`=3D Secure zorunlu, `false`=3D Secure opsiyonel
`AllowNotEnrolledCard`	Boolean	-	`true`=3D Secure'e kayıtlı olmayan kartlara izin ver
`SuccessUrl`	String	✓	Başarılı ödeme sonrası yönlendirme URL'i
`FailUrl`	String	✓	Başarısız ödeme sonrası yönlendirme URL'i
`TokenExpireTime`	Int	-	Token geçerlilik süresi: 1=1s, 2=3s, 3=6s, 4=12s
`TransactionSource`	Int	-	1=Ortak Ödeme, 2=Link ile Ödeme (belirtilmezse 1 kabul edilir)

CreateToken — Başarılı Response

{
  "CommonPaymentUrl": "https://inbound.apigatewaytest.vakifbank.com.tr:8443/commonPayment/index?Tokenid=76d2cfa3-86a3-4ec0-b826-22008b608c39",
  "PaymentToken": "76d2cfa3-86a3-4ec0-b826-22008b608c39",
  "StatusCode": 0,
  "StatusDescription": "Başarılı"
}

ℹ️

Sonraki adım: CommonPaymentUrl'e müşteriyi yönlendirin. Müşteri bu sayfada kart bilgilerini girer ve ödemeyi tamamlar.

Token Oluşturma — JSON

application/json body ile token oluşturur. Taksit, NumberOfInstallments gibi ek alanlar JSON yöntemiyle daha kolay gönderilebilir.

CreateTokenCPY — JSON Request Örneği

POST https://inbound.apigatewaytest.vakifbank.com.tr:8443/commonPayment/CreateTokenCPY
Content-Type: application/json

{
  "HostMerchantID": "000000000007955",
  "HostTerminalId": "VP000123",
  "MerchantPassword": "123Ab456",
  "Amount": 1.00,
  "AmountCode": "949",
  "TransactionType": "Sale",
  "IsSecure": true,
  "AllowNotEnrolledCard": false,
  "SuccessUrl": "http://www.vakifbank.com.tr",
  "FailUrl": "http://www.google.com.tr",
  "TokenExpireTime": 1,
  "TransactionSource": 1
}

Link ile Ödeme

TransactionSource: 2 ile oluşturulan tokenlarda müşteriye otomatik olarak bildirim gönderilir. Bildirim kanalı NotificationType ile belirlenir.

⚠️

Dikkat: NotificationType yalnızca TransactionSource=2 (Link ile Ödeme) olduğunda geçerlidir. Ortak Ödeme akışında görmezden gelinir.

NotificationType Değerleri

Değer	Açıklama
`1`	Yalnızca SMS
`2`	Yalnızca E-Mail
`3`	Yalnızca Push Notification
`4`	Hem SMS hem E-Mail

Link ile Ödeme — JSON Request Örneği

POST https://inbound.apigatewaytest.vakifbank.com.tr:8443/commonPayment/CreateTokenCPY
Content-Type: application/json

{
  "HostMerchantID": "000000000007955",
  "HostTerminalId": "VP000123",
  "MerchantPassword": "123Ab456",
  "Amount": 150.00,
  "AmountCode": "949",
  "TransactionType": "Sale",
  "IsSecure": true,
  "AllowNotEnrolledCard": false,
  "SuccessUrl": "http://www.vakifbank.com.tr",
  "FailUrl": "http://www.google.com.tr",
  "TokenExpireTime": 4,
  "TransactionSource": 2,
  "NotificationType": 4
}

Link ile Ödeme Ek Parametreleri

Alan	Tip	Zorunlu	Açıklama
`TransactionSource`	Int	✓	`2` olarak gönderilmelidir
`NotificationType`	Int	✓	Bildirim kanalı: 1=SMS, 2=Mail, 3=Push Not., 4=SMS+Mail
`TokenExpireTime`	Int	✓	Link geçerlilik süresi: 1=1s, 2=3s, 3=6s, 4=12s

Token Sorgulama (GetVposTransaction)

Oluşturulan token ya da işlem numarasına göre ödeme durumu sorgulanır. PaymentToken veya TransactionId ile sorgulama yapılabilir.

GetVposTransaction — JSON Request

POST https://inbound.apigatewaytest.vakifbank.com.tr:8443/commonPayment/GetVposTransaction
Content-Type: application/json
x-caller-information: ewogICJVc2VyQ29kZSI6ICJWQjM2MjU0IiwKICAiU2NyZWVuQ29kZSI...

{
  "MerchantNumber": "000000000007955",
  "Password": "123Ab456",
  "PaymentToken": "76d2cfa3-86a3-4ec0-b826-22008b608c39"
}

Request Parametreleri

Alan	Tip	Zorunlu	Açıklama
`MerchantNumber`	String(15)	✓	Üye işyeri numarası
`Password`	String	✓	Üye işyeri şifresi
`PaymentToken`	String (UUID)	✓*	CreateToken response'undan dönen token GUID'i
`TransactionId`	String	✓*	İşlem numarası (`PaymentToken` yerine kullanılabilir)

ℹ️

* PaymentToken veya TransactionId alanlarından en az biri zorunludur.

⚠️

x-caller-information header: Base64 encode edilmiş JSON objesidir. İçeriği: UserCode, ScreenCode, BranchCode, Channel gibi caller kimlik bilgilerini içerir. Değer sabit tutulabilir ya da entegrasyon sırasında VakıfBank'tan alınmalıdır.

GetVposTransaction — Başarılı Response

{
  "PaymentToken": "76d2cfa3-86a3-4ec0-b826-22008b608c39",
  "TransactionId": "TXN20250101123456",
  "TransactionType": "Sale",
  "Amount": 1.00,
  "AmountCode": "949",
  "Status": "Success",
  "ResponseCode": "0000",
  "ResponseMessage": "Approved",
  "AuthCode": "AUTH123",
  "HostReferenceNumber": "HOST123456",
  "MerchantNumber": "000000000007955",
  "TransactionSource": 1
}

Token İptali (canceledLink)

createToken ile oluşturulmuş bir ortak ödeme veya link ile ödeme tokenını iptal etmek için kullanılır. Token iptal edildikten sonra ilgili ödeme sayfasına/linkine erişim engellenir.

⚠️

Dikkat: İptal işlemi yalnızca henüz kullanılmamış (ödeme tamamlanmamış) tokenlar için geçerlidir. Tamamlanmış ödemeleri iptal etmek için Cancel veya Refund kullanın.

canceledLink — JSON Request

POST https://inbound.apigatewaytest.vakifbank.com.tr:8443/commonPayment/canceledLink
Content-Type: application/json

{
  "Token": "f18bf1b9-426d-49da-a037-4ecfbfb9d4da",
  "MerchantNumber": "000000000007955",
  "TerminalNumber": "VP000705",
  "Password": "123Ab456",
  "ClientIp": "192.168.10.10"
}

Request Parametreleri

Alan	Tip	Zorunlu	Açıklama
`Token`	String (UUID)	✓	`createToken` response'undan dönen token GUID'i
`MerchantNumber`	String(15)	✓	Üye işyeri numarası
`TerminalNumber`	String	✓	Terminal numarası
`Password`	String	✓	Üye işyeri şifresi
`ClientIp`	String	✓	İsteği yapan sunucunun IP adresi

Başarılı Response

JSON Response

{
    "StatusCode": 200,
    "IsSuccessful": true,
    "ResponseCode": 0000,
    "ResponseDescription": "İŞLEM BAŞARILI"
}

Hatalı Response

JSON Response (Hata)

{
    "StatusCode": 200,
    "IsSuccessful": true,
    "ResponseCode": 5011,
    "ResponseDescription": "Token daha önceden iptal edilmis."
}

ℹ️

Not: TerminalNumber alanı bu serviste TerminalNo değil TerminalNumber olarak gönderilmelidir. Token oluştururken kullanılan terminal numarasıyla aynı olmalıdır.

Hata Kodları

API yanıtlarında dönen yaygın kodlar ve anlamları:

Hata Kodu	Hata Kaynağı	Hata Kodu Açıklaması	Hata Detayı
`0000`	SANAL POS	İşlem Başarılı	Bir işlemin başarılı olduğunu gösterir.
`0001`	SANAL POS	Red-Bankanızı Arayın	Kart sahibi kredi kartını aldığı bankanın kredi kartları servisiyle görüşerek kartını e-ticarette kullanamadığını belirtmelidir.
`0002`	SANAL POS	Kategori Yok	Kart sahibi kredi kartını aldığı bankanın kredi kartları servisiyle görüşerek kartını e-ticarette kullanamadığını belirtmelidir.
`0003`	SANAL POS	Isyeri Kategorisi Hatalı/Tanımsız
`0004`	SANAL POS	Karta El Koyunuz/Sakıncalı	IP bloklanarak aynı IP den işlem gelmesi engellenebilir.
`0005`	SANAL POS	Red/Onaylanmadı	Kart sahibi kredi kartını aldığı bankanın kredi kartları servisiyle görüşerek kartını e-ticarette kullanamadığını belirtmelidir.
`0006`	SANAL POS	Hatalı İşlem
`0007`	SANAL POS	Karta El Koyunuz	IP bloklanarak aynı IP den işlem gelmesi engellenebilir.
`0008`	SANAL POS	Kimlik Kontrolü/Onaylandı
`0009`	SANAL POS	Tekrar Deneyiniz	Hatanın devam etmesi halinde Kart sahibi kredi kartını aldığı bankanın kredi kartları servisiyle görüşerek kartını e-ticarette kullanamadığını belirtmelidir.
`0010`	SANAL POS	Tekrar Deneyiniz	Hatanın devam etmesi halinde Kart sahibi kredi kartını aldığı bankanın kredi kartları servisiyle görüşerek kartını e-ticarette kullanamadığını belirtmelidir.
`0011`	SANAL POS	Tekrar Deneyiniz	Hatanın devam etmesi halinde Kart sahibi kredi kartını aldığı bankanın kredi kartları servisiyle görüşerek kartını e-ticarette kullanamadığını belirtmelidir.
`0012`	SANAL POS	Hatalı İşlem / Red	Kart sahibi kart bilgilerini doğru girdiğinden veya sanal limitinin yeterli olup olmadığından emin olduktan sonra işlemini tekrar denemelidir. Kart sahibi hata almaya devam ediyorsa kredi kartını aldığı bankanın kredi kartları servisiyle görüşerek kartını e-ticarette kullanamadığını belirtmelidir.
`0013`	SANAL POS	Geçersiz İşlem Tutarı
`0014`	SANAL POS	Geçersiz Kart Numarası
`0015`	SANAL POS	Müşteri Yok/Bin Hatalı
`0021`	SANAL POS	İşlem Yapılamadı	Kart sahibi kredi kartını aldığı bankanın kredi kartları servisiyle görüşerek kartını e-ticarette kullanamadığını belirtmelidir.
`0030`	SANAL POS	Format Hatası (Üye İşyeri)
`0032`	SANAL POS	Dosyasına Ulaşılamadı
`0033`	SANAL POS	Süresi Bitmiş/İptal Kart
`0034`	SANAL POS	Sahte Kart
`0038`	SANAL POS	Şifre Aşımı/Karta El Koy	IP bloklanarak aynı IP den işlem gelmesi engellenebilir.
`0041`	SANAL POS	Kayıp Kart- Karta El Koy	IP bloklanarak aynı IP den işlem gelmesi engellenebilir.
`0043`	SANAL POS	Çalıntı Kart-Karta El Koy	IP bloklanarak aynı IP den işlem gelmesi engellenebilir.
`0051`	SANAL POS	Bakiyesi-Kredi Limiti Yetersiz
`0052`	SANAL POS	Hesap Noyu Kontrol Edin
`0053`	SANAL POS	Hesap Yok
`0054`	SANAL POS	Vade Sonu Geçmiş Kart
`0055`	SANAL POS	Hatalı Kart Şifresi
`0056`	SANAL POS	Kart Tanımlı Değil.
`0057`	SANAL POS	Kart İşlem Tipine Kapalı	Kart sahibi kredi kartını aldığı bankanın kredi kartları servisiyle görüşerek kartını e-ticarette kullanamadığını belirtmelidir.
`0058`	SANAL POS	İşlem Tipi Terminale Kapalı	Girilen kart numarası hatalı veya rastgele girilmiş bir değer olabilir.
`0059`	SANAL POS	Sahtekarlık Şüphesi	IP bloklanarak aynı IP den işlem gelmesi engellenebilir.
`0061`	SANAL POS	Para Çekme Tutar Limiti Aşıldı
`0062`	SANAL POS	Yasaklanmış Kart	IP bloklanarak aynı IP den işlem gelmesi engellenebilir.
`0063`	SANAL POS	Güvenlik İhlali
`0065`	SANAL POS	Para Çekme Limiti Aşıldı	Kart sahibi kredi kartını aldığı bankanın kredi kartları servisiyle görüşerek kartını e-ticarette kullanamadığını belirtmelidir.
`0075`	SANAL POS	Şifre Deneme Sayısı Aşıldı	Kart sahibi kredi kartını aldığı bankanın kredi kartları servisiyle görüşerek kartını e-ticarette kullanamadığını belirtmelidir.
`0077`	SANAL POS	Şifre Script Talebi Reddedildi	Kart sahibi kredi kartını aldığı bankanın kredi kartları servisiyle görüşerek kartını e-ticarette kullanamadığını belirtmelidir.
`0078`	SANAL POS	Şifre Güvenilir Bulunmadı	Kart sahibi kredi kartını aldığı bankanın kredi kartları servisiyle görüşerek kartını e-ticarette kullanamadığını belirtmelidir.
`0089`	SANAL POS	İşlem Onaylanmadı	Kart sahibi kredi kartını aldığı bankanın kredi kartları servisiyle görüşerek kartını e-ticarette kullanamadığını belirtmelidir.
`0091`	SANAL POS	Kartı Veren Banka Hizmet Dışı	Kart sahibi kredi kartını aldığı bankanın kredi kartları servisiyle görüşerek kartını e-ticarette kullanamadığını belirtmelidir.
`0092`	SANAL POS	Bankası Bilinmiyor
`0093`	SANAL POS	Kartınız E-Ticaret İşlemlerine Kapalıdır. Bankanızı Arayınız.	Kart E-Ticarete Kapalı
`0096`	SANAL POS	Bankasının Sistemi Arızalı	Kart sahibi kredi kartını aldığı bankanın kredi kartları servisine yönlendirilmelidir. Farklı bankalarından da aynı hata alınıyorsa, hatayı vpos724@vakifbank.com.tr adresine bildiriniz.
`0312`	SANAL POS	Kartın Cvv2 Değeri Hatalı
`0315`	SANAL POS	Kartın Sanal Limiti Yeterli Değil
`0320`	SANAL POS	Önprovizyon Yok	Hatayı vpos724@vakifbank.com.tr adresine bildiriniz.
`0323`	SANAL POS	Önpr. Kapama Tutar Eşlenmedi	Hatayı vpos724@vakifbank.com.tr adresine bildiriniz.
`0357`	SANAL POS	Eksik Ödeme Sayacı:Nakit Red	Kart sahibi kredi kartını aldığı bankanın kredi kartları servisiyle görüşerek kartını e-ticarette kullanamadığını belirtmelidir.
`0358`	SANAL POS	Kart Kapalı
`0359`	SANAL POS	Aylık Ciro Limiti Aşıldı	Hatayı vpos724@vakifbank.com.tr adresine iletiniz.
`0381`	SANAL POS	Red Karta El Koy	IP bloklanarak aynı IP den işlem gelmesi engellenebilir.
`0382`	SANAL POS	Sahte Kart-Karta El Koyunuz	IP bloklanarak aynı IP den işlem gelmesi engellenebilir.
`0400`	SANAL POS	3D Secure Şifre Doğrulaması Yapılamadı	Hatayı vpos724@vakifbank.com.tr adresine bildiriniz.
`0501`	SANAL POS	Geçersiz Taksit/İşlem Tutarı	Taksit tanımı yok veya denenen işlem tutarı 1 TL nin altındadır.
`0503`	SANAL POS	Ekstre-Taksit Sayısı Uyumsuz
`0504`	SANAL POS	İşyerinin Storeu İçin Bu Kartın Bini Tanımlı Değil	Hatayı vpos724@vakifbank.com.tr adresine bildiriniz.
`0540`	SANAL POS	İade Edilecek İşlemin Orijinali Bulunamadı
`0541`	SANAL POS	Orj. İşlem Tamamı İade Edildi
`0542`	SANAL POS	Günlük İade Limiti Aşımı	Hatayı vpos724@vakifbank.com.tr adresine bildiriniz.
`0550`	SANAL POS	İşlem Ykb Pos Undan Yapılmalı
`0570`	SANAL POS	Yurtdışı Kart İşlem İzni Yok	Yurt dışı kart işlem izni için talebinizi şubenize iletmeniz gerekmektedir.
`0571`	SANAL POS	İşyeri Amex İşlem İzni Yok	Amex Kart işlem izni için Şubenize başvurunuz.
`0572`	SANAL POS	İşyeri Amex Tanımları Eksik	Hatayı vpos724@vakifbank.com.tr adresine bildiriniz.
`0574`	SANAL POS	Kampüs Karta Uygun İşyeri Değil	Hatayı vpos724@vakifbank.com.tr adresine bildiriniz.
`0575`	SANAL POS	Limitsiz Takip Kart	Kart sahibi kredi kartını aldığı bankanın kredi kartları servisiyle görüşerek kartını e-ticarette kullanamadığını belirtmelidir.
`0577`	SANAL POS	Taksite Kapalı Sektör
`0580`	SANAL POS	Cavv Veya Bkm Expsign Değeri Hatalı	ECI ve CAVV değerlerinin provizyon mesajında boş veya hatalı gönderilmektedir.
`0581`	SANAL POS	Ecı Veya Cavv Bilgisi Eksik	ECI ve CAVV değerlerinin provizyon mesajında boş veya hatalı gönderilmektedir.
`0582`	SANAL POS	Cavv Acs Error	ECI ve CAVV değerlerinin provizyon mesajında boş veya hatalı gönderilmektedir.
`0583`	SANAL POS	Bkm Expsign Mükerrer	ECI ve CAVV değerlerinin provizyon mesajında boş veya hatalı gönderilmektedir.
`0961`	SANAL POS	Debit Kartla İade Yapılamaz
`0962`	SANAL POS	Terminalid Tanımsız
`0963`	SANAL POS	Üye İşyeri Tanımlı Değil
`0966`	SANAL POS	Duplicate İşlem Numarası Hatası
`0971`	SANAL POS	Eşleşmiş (Capture) Bir İşlem İptal Edilemez
`0972`	SANAL POS	Para Kodu Geçersiz. Onus Kart İle Yp İşlem Yapılamaz.
`0973`	SANAL POS	İşlem Onaylanmadı
`0974`	SANAL POS	Reversal Farklı Günde Gelmiş.	Hatayı vpos724@vakifbank.com.tr adresine bildiriniz.
`0975`	SANAL POS	İşlem İzni Yok	Sanal POS un bu işleme yetkisi yoktur.
`0976`	SANAL POS	Onus Kart Tanımlı Değil	Hatayı vpos724@vakifbank.com.tr adresine bildiriniz.
`0977`	SANAL POS	Onus Kart Tanımlı Değil	Hatayı vpos724@vakifbank.com.tr adresine bildiriniz.
`0978`	SANAL POS	Notonus Kart ile Taksitli İşlem	Diğer Banka kartları ile taksitli işlem yapılamaz.
`0980`	SANAL POS	Son Kur Bilgisi Bulunamadı
`0981`	SANAL POS	3D Secure Acquiring İle İlgili Eksik Güvenlik Alanı	ECI ve CAVV değerlerinin provizyon mesajında boş veya hatalı gönderilmelidir.
`0982`	SANAL POS	İşlem İptal Durumda. İade Edilemez
`0983`	SANAL POS	İade Edilecek İşlemin Orijinali Bulunamadı
`0984`	SANAL POS	İade Tutarı Satış Tutarından Büyük Olamaz	İade Tutarı Satış Tutarından Büyük Olamaz
`0985`	SANAL POS	İşyeri Store A Bağlı Olmalıdır	Hatayı vpos724@vakifbank.com.tr adresine bildiriniz.
`0986`	SANAL POS	Gib Taksit Hata
`0987`	SANAL POS	İşyeri Mp Taksit Tanımı Bulunamadı	Hatayı vpos724@vakifbank.com.tr adresine bildiriniz.
`1001`	SANAL POS	Sistem Hatası.
`1006`	SANAL POS	Bu İşlem Numarası İle Daha Önce Bir İşlem Gerçekleştirilmiş, İşleme Yeni Bir Numara Verebilir Yada Bu Alanı Boş Bırakabilirsiniz
`1007`	SANAL POS	Referans Transaction Alinamadi	Genel olarak iade işlemlerinde, iade edilecek işlemin ReferansTransactionId değeriyle uyuşmadığı durumlarda alınır.
`1044`	SANAL POS	Debit Kartlarla Taksitli İşlem Yapılamaz
`1046`	SANAL POS	Toplam İade Tutarı Orjinal Tutarı Aştı.
`1047`	SANAL POS	İşlem Tutarı Geçersiz.
`1049`	SANAL POS	Geçersiz Tutar.	Üye işyerinin CurrencyAmount alanında XX.YY formatında kayıt ilettiği kontrol edilmelidir. Virgül kullanılmamalı, noktadan sonra 2 hane olmalıdır. 1 tl lik işlem için 1.00 gönderilmelidir.
`1050`	SANAL POS	Cvv Hatali.	CVV nin formatının hatalı gönderilmesinden ya da hiç gönderilmemesinden dolayı alınan hatadır.
`1051`	SANAL POS	Kredi Karti Numarasi Hatali.
`1052`	SANAL POS	Kart Vadesi Hatalı Veya Vade Formatı Hatalı
`1053`	SANAL POS	Gönderilen Pancode Kayıtlı Değil
`1054`	SANAL POS	İslem Numarasi Hatali.
`1059`	SANAL POS	İşlemin Tamamı İade Edilmiş.
`1060`	SANAL POS	Hatali Taksit Sayisi.
`1061`	SANAL POS	Ayni Siparis Numarasiyla Daha Önceden Basarili İslem Yapilmis
`1065`	SANAL POS	Ön Provizyon Daha Önceden Kapatilmis
`1073`	SANAL POS	Terminal Üzerinde Aktif Olarak Bir Batch Bulunamadi
`1074`	SANAL POS	İslem Henüz Sonlanmamis Yada Referans İslem Henüz Tamamlanmamis.
`1075`	SANAL POS	Sadakat Puan Tutari Hatali
`1076`	SANAL POS	Sadakat Puan Kodu Hatali
`1077`	SANAL POS	Para Kodu Hatali
`1078`	SANAL POS	Geçersiz Siparis Numarasi
`1079`	SANAL POS	Geçersiz Siparis Açiklamasi
`1080`	SANAL POS	Sadakat Tutari Ve Para Tutari Gönderilmemis.
`1081`	SANAL POS	Puanla Satiş İşleminde Taksit Sayisi Gönderilemez
`1082`	SANAL POS	Geçersiz İslem Tipi
`1083`	SANAL POS	Referans İslem Daha Önceden İptal Edilmis.
`1087`	SANAL POS	Yabanci Para Birimiyle Taksitli Provizyon Kapama İslemi Yapilamaz
`1088`	SANAL POS	Önprovizyon İptal Edilmis
`1089`	SANAL POS	Referans İslem Yapilmak İstenen İslem İçin Uygun Degil
`1091`	SANAL POS	Recurring İslemin Toplam Taksit Sayisi Hatali
`1092`	SANAL POS	Recurring İslemin Tekrarlama Araligi Hatali
`1093`	SANAL POS	Sadece Satis (Sale) İslemi Recurring Olarak İsaretlenebilir
`1095`	SANAL POS	Lütfen Geçerli Bir Email Adresi Giriniz
`1096`	SANAL POS	Provizyon Talep Mesajına Clientip Değerini Gönderiniz.
`1097`	SANAL POS	Lütfen Geçerli Bir Cavv Degeri Giriniz
`1098`	SANAL POS	Lütfen Geçerli Bir Eci Degeri Giriniz
`1099`	SANAL POS	Lütfen Geçerli Bir Kart Sahibi İsmi Giriniz
`1100`	SANAL POS	Lütfen Geçerli Bir Brand Girisi Yapin.
`1101`	SANAL POS	Referans Transaction Reverse Edilmis.
`1102`	SANAL POS	Recurring İslem Araligi Geçersiz.
`1103`	SANAL POS	Taksit Sayisi Girilmeli
`1104`	SANAL POS	İzinsiz Taksitli İşlem.
`1105`	SANAL POS	Üye İşyeri Ip Si Sistemde Tanimlı Degil	Güvenlik nedeniyle uygulamaya gelen provizyon isteklerinde Statik IP kontrolü yapılmaktadır. Statik IP bilginizi üye işyeri numranızla birlikte vpos724@vakifbank.com.tr adresine iletmeniz gerekmektedir.
`1106`	SANAL POS	Extract Maksimum 40 Karakter Olmalıdır.	Extract maksimum 40 karakter olmalıdır.
`1107`	SANAL POS	Expsign Alanın Uzunluğu Hatalı
`1108`	SANAL POS	Mpitransactionıd Alanın Uzunluğu Hatalı
`1109`	SANAL POS	Valuelist Alanın Uzunluğu Hatalı
`1110`	SANAL POS	Bu Üye İşyerii 3D İşlem Yapamaz
`1111`	SANAL POS	Bu Üye İşyeri Non Secure İşlem Yapamaz
`1112`	SANAL POS	Terminal Aktif Değil
`1113`	SANAL POS	Terminalde Açık Reversal Bulunuyor
`1114`	SANAL POS	Mpitransactionıd Alanı Boş Gönderilmiş
`1115`	SANAL POS	Mpitransactionı Bulunamıyor
`1116`	SANAL POS	Eci Değeri Mpi İle Uyumsuz
`1117`	SANAL POS	Cavv Değeri Mpi ile Uyumsuz
`1118`	SANAL POS	3D Secure İşlemler Mailorder Olarak Gönderilemez
`1119`	SANAL POS	Otomatik Gün Sonu Tanımlı Üye İşyerleri Manuel Gün Sonu Yapamazlar
`1120`	SANAL POS	Geçersiz Security Code
`1121`	SANAL POS	Transactiondevicesource Alanının Gönderilmesi Zorunludur.
`1122`	SANAL POS	Surcharge Tutan 0 Dan Büyük Olmalı.
`1123`	SANAL POS	Kayıt İade Durumda	İade Edilmiş Bir Kayıt İptal Edilmeye Çalışılıyor
`1124`	SANAL POS	Kayıt İptal Durumda	İptal Edilmiş Bir Kayıt İade Edilmeye Çalışılıyor
`1125`	SANAL POS	Terminal Bulunamadi
`1126`	SANAL POS	Mpi İşlemindeki Veriler İle Uyumsuz
`1127`	SANAL POS	3Ds İşlemlerde Kart Bilgisi Veya Tutar Provizyon Mesajında Yer Almamalıdır
`1128`	SANAL POS	Mpitransactionıd Daha Önce Başka Bir İşlem için Kullanılmış
`1129`	SANAL POS	Express Ve 3D Secure İşlem Aynı Anda Gönderilemez.	Express ve 3D Secure işlem aynı anda gönderilemez.
`1130`	SANAL POS	Expsign Değeri İletilen İşlem İçin Eci Değeri Geçerli Değil	ExpSign değeri iletilen işlem için ECI değeri geçerli değil
`1131`	SANAL POS	Customıtems Alanının Uzunluğu Hatalı	Customıtems alanının uzunluğu hatalı
`1132`	SANAL POS	İşleme Ait Kanal Bilgisine Göre, Expsign Değeri Boş Olmalı	İşleme ait kanal bilgisine göre, Expsign değeri boş olmalı
`1133`	SANAL POS	Üye İş Yeri Yetkileri Arasında Ekstre Gönderme Yetkisi Bulunmamaktadır.	Üye İş Yeri Yetkileri Arasında Ekstre Gönderme Yetkisi Bulunmamaktadır.
`1134`	SANAL POS	Custom Items Name Alanının Uzunluğu Maksimum 100 Karakter Olmalı.	Custom Items Name Alanının Uzunluğu Maksimum 100 Karakter Olmalı
`1135`	SANAL POS	Customıtem İçerisinde Tutar Hatalı	CustomItem içerisinde Tutar Hatalı
`1136`	SANAL POS	Customıtem İçerisinde Telefon Hatalı	CustomItem içerisinde Telefon Hatalı
`1137`	SANAL POS	Customıtem İçerisinde E-Posta Hatalı	CustomItem içerisinde E-Posta Hatalı
`1138`	SANAL POS	Customıtem İçerisinde Tip Hatalı	CustomItem içerisinde Tip Hatalı
`1139`	SANAL POS	Tanımlı Customıtem Hatalı Customtype	Tanımlı CustomItem Hatalı CustomType
`1140`	SANAL POS	Sıra Numarası Zorunlu.	Sıra Numarası Zorunlu.
`1141`	SANAL POS	Vade Süresi(Ay) Zorunlu.	Vade Süresi(Ay) Zorunlu.
`1142`	SANAL POS	Ödeme Sıklığı(Ay) Zorunlu.	Ödeme Sıklığı(Ay) Zorunlu.
`1143`	SANAL POS	Öteleme Süresi(Ay) Zorunlu.	Öteleme Süresi(Ay) Zorunlu.
`1144`	SANAL POS	Vade Ödeme Sıklığı Zorunlu.	Vade Ödeme Sıklığı Zorunlu.
`1145`	SANAL POS	Sgk Tutarı Küsuratlı Olamaz.	Sgk Tutarı Küsuratlı Olamaz.
`1146`	SANAL POS	Ödeme Planı Bulunamadı.	Ödeme Planı Bulunamadı.
`1147`	SANAL POS	Üye İş Yeri Yetkileri Arasında Gib Taksit Yetkisi Bulunmamaktadır.	Üye İş Yeri Yetkileri Arasında Gib Taksit Yetkisi Bulunmamaktadır.
`1148`	SANAL POS	Üye İş Yeri Yetkileri Arasında Tekrarlı Tahsilat Yetkisi Bulunmamaktadır.	Üye İş Yeri Yetkileri Arasında Tekrarlı Tahsilat Yetkisi Bulunmamaktadır.
`1152`	SANAL POS	Customıtem İçerisindeki Vftbankreferansno Bu İşlem Tipi İçin Geçerli Değildir	CustomItem içerisindeki VFTBankReferansNo bu işlem tipi için geçerli değildir
`1153`	SANAL POS	Üye İş Yerinin Bkm Express İzni Yoktur.	Üye iş yerinin BKM express izni yoktur.
`2012`	SANAL POS	Batch Bulunamadı	Batch Bulunamadı
`2013`	SANAL POS	Terminal Bulunamadı.	Terminal Bulunamadı.
`2200`	SANAL POS	İş Yerinin İşlem İçin Gerekli Hakkı Yok.
`2202`	SANAL POS	İşlem İptal Edilemez. ( Batch Kapalı )
`2203`	SANAL POS	Batch Kapama İsteginden Once Batch E Ait Settlementqueue Daki İşlemler Tamamlanmış Olmalı.	Batch Kapama isteginden once Batch e ait SettlementQueue daki işlemler tamamlanmış olmalı.
`4000`	SANAL POS	İşlem Tipi Hatalı	İşlem Tipi Hatalı
`4001`	SANAL POS	Bitiş Tarihi, Başlangıç Tarihinden Küçük Olamaz	Bitiş Tarihi, Başlangıç Tarihinden Küçük Olamaz
`4002`	SANAL POS	Başlangıç Tarihi Zorunlu	Başlangıç Tarihi Zorunlu
`4003`	SANAL POS	Bitiş Tarihi Zorunlu	Bitiş Tarihi Zorunlu
`4004`	SANAL POS	Otorizasyon Kodu Zorunlu	Otorizasyon Kodu Zorunlu
`4005`	SANAL POS	En Az Bir Sorgu Kriteri Zorunlu	En Az Bir Sorgu Kriteri Zorunlu
`4006`	SANAL POS	En Az Bir Sorgu Kriteri Zorunlu	En Az Bir Sorgu Kriteri Zorunlu
`4007`	SANAL POS	Arama Kriteri Hatalı	Arama Kriteri Hatalı
`4008`	SANAL POS	Mutabakat Tarihi Zorunlu	Mutabakat Tarihi Zorunlu
`5000`	SANAL POS	En Az 1 Sayfa İçeriği Zorunlu	En Az 1 Sayfa İçeriği Zorunlu
`5001`	SANAL POS	Kimlik Doğrulama İşlemi Başarısız.	İşyeri numarasının veya İşyeri şifresinin veya istekte bulunulan url adresinin doğruluğundan emin olunuz.
`5002`	SANAL POS	İş Yeri Aktif Değil.
`5003`	SANAL POS	Sayfanın 1 Adet Tutar Tipinde İçeriği Olmalı	Sayfanın 1 Adet Tutar Tipinde İçeriği Olmalı
`5004`	SANAL POS	Sayfanın 1 Den Fazla Tutar Tipinde İçeriği Olamaz	Sayfanın 1 den Fazla Tutar Tipinde İçeriği Olamaz
`5005`	SANAL POS	Tutar Tipindeki Sayfa İçeriğinde Para Birimi Zorunlu	Tutar Tipindeki Sayfa İçeriğinde Para Birimi Zorunlu
`5006`	SANAL POS	Sayfa İçerik Başlığı Zorunlu	Sayfa İçerik Başlığı Zorunlu
`5007`	SANAL POS	Sayfa İçeriği Hatalı	Sayfa İçeriği Hatalı
`5008`	SANAL POS	Bağış Sayfası İçerik Etiket Uzunluğu Hatalı
`5009`	SANAL POS	Bağış Sayfası İçerik Etiket Değer Uzunluğu Hatalı
`5010`	SANAL POS	Girilen Değer 200 Karakteri Geçmemeli
`5011`	SANAL POS	Dikkate Alınacak Tutar Alanı Seçili İse, Para Birimi De Seçilebilmelidir.
`5012`	SANAL POS	Dikkate Alınacak Tutar Alanı Seçili İse, Dikkate Alınacak Adet Alanı Seçilmemelidir.
`5013`	SANAL POS	Dikkate Alınacak Tutar Alanı Seçili İse, Giriş Zorunlu Olmalıdır.
`5014`	SANAL POS	Dikkate Alınacak Adet Alanı Seçili İse, Para Birimi Seçilmemelidir.
`5015`	SANAL POS	Dikkate Alınacak Adet Alanı Seçili İse, Giriş Zorunlu Olmalıdır.
`5016`	SANAL POS	Değer Başlık Alanı Boş Bırakılamaz.
`5017`	SANAL POS	Sayfanın 1 Den Fazla Adet Tipinde İçeriği Olamaz.
`5018`	SANAL POS	İçerik Tipi Liste Yada Radyo Butonu Olan İçeriklere İçerik Değeri Atanabilir
`6000`	SANAL POS	Merchant Isactive Field Is Invalid
`6001`	SANAL POS	Merchant Contactaddressline1 Length Is Invalid
`6002`	SANAL POS	Merchant Contactaddressline2 Length Is Invalid
`6003`	SANAL POS	Merchant Contactcitylength Is Invalid
`6004`	SANAL POS	Merchant Contactemail Must Be Valid Email
`6005`	SANAL POS	Merchant Contactemail Length Is Invalid
`6006`	SANAL POS	Merchant Contactname Length Is Invalid
`6007`	SANAL POS	Merchant Contactphone Length Is Invalid
`6008`	SANAL POS	Merchant Hostmerchantid Length Is Invalid
`6009`	SANAL POS	Merchant Hostmerchantid Is Empty
`6010`	SANAL POS	Merchant Merchantname Length Is Invalid
`6011`	SANAL POS	Merchant Merchantpassword Length Is Invalid
`6012`	SANAL POS	Terminalinfo Hostterminalid Is Invalid
`6013`	SANAL POS	Terminalinfo Hostterminalid Length Is Invalid
`6014`	SANAL POS	Terminalinfo Hostterminalid Is Empty
`6015`	SANAL POS	Terminalinfo Terminalname Is Invalid
`6016`	SANAL POS	Üye İşyeri Departmanı Hatalı	Üye İşyeri Departmanı Hatalı
`6017`	SANAL POS	Üye İşyeri Departman No Hatalı	Üye İşyeri Departman No Hatalı
`6018`	SANAL POS	Merchant Not Found
`6019`	SANAL POS	Invalidrequest
`6020`	SANAL POS	Birim Zaten Mevcut	Birim Zaten Mevcut
`6021`	SANAL POS	Birim Bulunamadı	Birim Bulunamadı
`6022`	SANAL POS	Transaction Type Exist In Merchant Permission
`6023`	SANAL POS	Merchant Permission Exist In Merchant
`6024`	SANAL POS	Currency Code Exist In Merchant Currency Codes Permission
`6025`	SANAL POS	Terminal Exist In Merchantterminals
`6026`	SANAL POS	Terminal Can Not Be Found In Merchantterminals
`6027`	SANAL POS	Invalid Login Attempti. Please Check Clientid And Clientpassword Fields
`6028`	SANAL POS	Merchant Is Already Exist. You Should Try To Update Method
`6029`	SANAL POS	Üye İşyeri Eposta Hatalı	Üye İşyeri Eposta Hatalı
`6030`	SANAL POS	Üye İşyeri Web Adresi Hatalı	Üye İşyeri Web Adresi Hatalı
`6031`	SANAL POS	Otomatik Günsonu Zamanı Zorunlu	Otomatik GünSonu Zamanı Zorunlu
`6032`	SANAL POS	Otomatik Günsonu Zamanı Hatalı	Otomatik GünSonu Zamanı Hatalı
`6033`	SANAL POS	3D Üye İşyeri Tipi Hatalı	3D Üye İşyeri Tipi Hatalı
`6034`	SANAL POS	Parenthostmerchantid Dolu Olmamalıdır.	ParentHostMerchantId dolu olmamalıdır.
`6035`	SANAL POS	Parenthostmerchantid Dolu Olmalıdır.	ParentHostMerchantId dolu olmalıdır.
`6036`	SANAL POS	Yalnızca Ana Bayi, Alt Bayi İşlemlerini Görebilir.	Yalnızca Ana Bayi, Alt Bayi İşlemlerini Görebilir.
`6037`	SANAL POS	Ana Bayi Sistemde Tanımlı Değil.	Ana Bayi Sistemde Tanımlı Değil.
`6038`	SANAL POS	Alt Bayi Olan Bir İşyeri Başka Bir İşyerinin Parenthostmerchantid si Olamaz.	Alt Bayi Olan Bir İşyeri Başka Bir İşyerinin ParentHostMerchantId si Olamaz.
`6039`	SANAL POS	Tckn Veya Vkn Alanları Dolu Olmalıdır.	TCKN veya VKN alanları dolu olmalıdır.
`6040`	SANAL POS	Aynı Tckn Ye Sahip Sadece Bir Üye İşyeri Olabilir.	Aynı TCKN ye Sahip Sadece Bir Üye İşyeri Olabilir.
`6041`	SANAL POS	Aynı Vkn Ye Sahip Sadece Bir Üye İşyeri Olabilir.	Aynı VKN ye Sahip Sadece Bir Üye İşyeri Olabilir.
`6042`	SANAL POS	Tckn 11 Hane Olmalı.	TCKN 11 Hane Olmalı.
`6043`	SANAL POS	Tckn Numerik Olmalıdır.	TCKN Numerik Olmalıdır.
`6044`	SANAL POS	Vkn 10 Hane Olmalıdır.	VKN 10 Hane Olmalıdır.
`6045`	SANAL POS	Vkn Numerik Olmalıdır.	VKN Numerik Olmalıdır.
`6046`	SANAL POS	Tckn Ve Vkn 10 Veya 11 Hane Olmalıdır.	TCKN Ve VKN 10 veya 11 Hane olmalıdır.
`6047`	SANAL POS	Tckn Ve Vkn Alanı Boş Olamaz.	TCKN ve Vkn alanı boş olamaz.
`6048`	SANAL POS	Vkn Ve Tckn Boş Olmalıdır.	VKN ve TCKN Boş olmalıdır.
`6049`	SANAL POS	Merchantid Boş Olmalıdır.	Merchantid Boş olmalıdır.
`6050`	SANAL POS	Merchantid Boş Olamaz.	Merchantid boş olamaz.
`6051`	SANAL POS	Parent Hostmerchant Ana Bayi Olmalıdır.	Parent HostMerchant Ana Bayi Olmalıdır.
`6052`	SANAL POS	Kullanıcının Onaylama Yetkisi Yok	Kullanıcının Onaylama Yetkisi yok
`6053`	SANAL POS	Üye İş Yerinin Vade Ve Ödeme Sıklığı Tekil Olmalıdır.	Üye iş yerinin Vade ve Ödeme Sıklığı Tekil Olmalıdır.
`6054`	SANAL POS	Ödeme Sıklığı Nümerik Olmalı.	Ödeme Sıklığı Nümerik Olmalı.
`6055`	SANAL POS	Vade Süresi Nümerik Olmalı.	Vade Süresi Nümerik Olmalı.
`6056`	SANAL POS	Sıra Numarası Nümerik Olmalı.	Sıra Numarası Nümerik Olmalı.
`6057`	SANAL POS	Öteleme Süresi Nümerik Olmalı.	Öteleme Süresi Nümerik Olmalı.
`6058`	SANAL POS	Ödeme Sıklığı Zorunlu.	Ödeme Sıklığı Zorunlu.
`6059`	SANAL POS	Vade Süresi Zorunlu.	Vade Süresi Zorunlu.
`6060`	SANAL POS	Sıra Numarası Zorunlu.	Sıra Numarası Zorunlu.
`6061`	SANAL POS	Öteleme Süresi Zorunlu.	Öteleme Süresi Zorunlu.
`6063`	SANAL POS	Ana Bayi, Alt Bayi İlişkisi Bulunmuyor	Ana Bayi, Alt Bayi ilişkisi bulunmuyor
`6064`	SANAL POS	Hostmerchantid Veri Uzunluğu Geçersiz	HostMerchantId veri uzunluğu geçersiz
`6065`	SANAL POS	Hostsubmerchantid Veri Uzunluğu Geçersiz	HostSubMerchantId veri uzunluğu geçersiz
`6066`	SANAL POS	Hostsubmerchantid Must Not Be Empty.	HostSubMerchantId Must Not Be Empty.
`6067`	SANAL POS	Hostsubmerchantid Değeri Boş Olmalı	HostSubMerchantId Değeri Boş Olmalı
`7777`	SANAL POS	Banka Tarafında Gün Sonu Yapıldığından İşlem Gerçekleştirilemedi
`9000`	SANAL POS	İşlem Yükleme Limit Aşıldı
`9001`	SANAL POS	İşlem Yükleme Limit Aşıldı
`9025`	SANAL POS	Hatalı İstek.	Hatalı istek.
`9026`	SANAL POS	İstek Bilgisi Hatalı.	İstek bilgisi hatalı.
`9027`	SANAL POS	Kullanıcı Adı Veya Şifre Yanlış.	Kullanıcı adı veya şifre yanlış.
`9028`	SANAL POS	Rol Bulunamadı.	Rol bulunamadı.
`9029`	SANAL POS	Rol Adı Boş Bırakılamaz.	Rol adı boş bırakılamaz.
`9030`	SANAL POS	Rol İçerisinde Tanımlı User Varken Silemezsiniz.	Rol içerisinde tanımlı user varken silemezsiniz.
`9031`	SANAL POS	Kullanıcı Adı Veya Şifre Yanlış.	Kullanıcı adı veya şifre yanlış.
`9032`	SANAL POS	Kullanıcı Pasif	Kullanıcı Pasif
`9033`	SANAL POS	Kullanıcı Silinmiş	Kullanıcı Silinmiş
`9034`	SANAL POS	Üye İşyerinin Yönetici Kullanıcısı Bulunuyor.	Üye işyerinin yönetici kullanıcısı bulunuyor.
`9035`	SANAL POS	Üye İşyerine Ait Bir Yönetici Rolü Bulunuyor	Üye işyerine ait bir yönetici rolü bulunuyor
`9036`	SANAL POS	Bloklanmış Kullanıcı	Bloklanmış Kullanıcı
`9037`	SANAL POS	Kullanıcının Şifre Süresi Dolmuş	Kullanıcının şifre süresi dolmuş
`9038`	SANAL POS	Yeni Şifre Eski Şifreyle Aynı Olamaz	Yeni Şifre Eski Şifreyle Aynı Olamaz
`9039`	SANAL POS	Üye İşyeri Bulunamadı.
`9041`	SANAL POS	Üye İşyerine Tanımlanabilecek Maksimum Web Sitesi Sayısına Ulaştınız	Üye İşyerine Tanımlanabilecek Maksimum Web Sitesi Sayısına Ulaştınız
`9042`	SANAL POS	Üye İşyerinin 1 Adet Ekstre Tipinde E-Postası Olmak Zorundadır	Üye İşyerinin 1 adet Ekstre Tipinde E-Postası Olmak Zorundadır
`9043`	SANAL POS	Üye İşyerine Tanımlanabilecek Maksimum E-Posta Sayısına Ulaştınız	Üye işyerine Tanımlanabilecek Maksimum E-Posta Sayısına Ulaştınız
`9044`	SANAL POS	Üye İşyerinin Sadece 1 Adet Ekstre Tipinde E-Postası Olabilir	Üye İşyerinin sadece 1 Adet Ekstre Tipinde E-Postası Olabilir
`9045`	SANAL POS	Üye İşyeri E-Posta Adreslerinin E-Posta Tipi Değiştirilemez	Üye İşyeri E-Posta Adreslerinin E-Posta Tipi Değiştirilemez
`9046`	SANAL POS	Ip Tipi Bulunamadı	IP Tipi Bulunamadı
`9047`	SANAL POS	Ip Hatalıdır	IP Hatalıdır
`9048`	SANAL POS	Ip Aralık Sonu Hatalıdır	IP Aralık Sonu Hatalıdır
`9049`	SANAL POS	Banka Bulunamadı	Banka Bulunamadı
`9050`	SANAL POS	Kart Sağlayıcı Alanı Zorunlu	Kart Sağlayıcı alanı zorunlu
`9051`	SANAL POS	Bin Boş Bırakılamaz	Bin boş bırakılamaz
`9052`	SANAL POS	Bin 6 Karakter Olmalı	Bin 6 karakter olmalı
`9053`	SANAL POS	Kart Tipi Boş Bırakılamaz	Kart tipi boş bırakılamaz
`9054`	SANAL POS	Bin Kaydı Zaten Mevcut	Bin kaydı zaten mevcut
`9055`	SANAL POS	Bankaya Ait Bin Bulunamıyor	Bankaya ait bin bulunamıyor
`9056`	SANAL POS	Dosya Boş	Dosya boş
`9057`	SANAL POS	Zaman 4 Aydan Büyük Olamaz	Zaman 4 aydan büyük olamaz
`9058`	SANAL POS	Tutar Hatalı	Tutar Hatalı
`9059`	SANAL POS	Para Birimi Hatalı	Para Birimi Hatalı
`9060`	SANAL POS	Kredi Kartı Numarası Hatalı	Kredi Kartı Numarası Hatalı
`9061`	SANAL POS	Cvv2 Hatalı	Cvv2 Hatalı
`9062`	SANAL POS	Brand Hatalı	Brand hatalı
`9063`	SANAL POS	Son Kullanma Tarihi Hatalı	Son Kullanma Tarihi Hatalı
`9064`	SANAL POS	Referans Transaction Numarası Hatalı	Referans Transaction Numarası Hatalı
`9065`	SANAL POS	Üye İşyeri Bulunamadı	Üye işyeri bulunamadı
`9066`	SANAL POS	Üye İşyeri Pasif	Üye işyeri pasif
`9067`	SANAL POS	Transaction Numarası Hatalı	Transaction Numarası hatalı
`9068`	SANAL POS	Sipariş Numarası Hatalı	Sipariş Numarası Hatalı
`9069`	SANAL POS	Sipariş Açıklaması Hatalı	Sipariş Açıklaması Hatalı
`9070`	SANAL POS	Ip Adresi Hatalı	Ip adresi hatalı
`9071`	SANAL POS	Kart Sahibi Hatalı	Kart sahibi hatalı
`9072`	SANAL POS	Referans İşlem İade Edilmiştir.	Referans işlem iade edilmiştir.
`9073`	SANAL POS	Ön Provizyon İptal Edilmiş	Ön Provizyon İptal Edilmiş
`9074`	SANAL POS	İşlem Teknik Sebeplerden Dolayı İptal Edilmiş.	İşlem teknik sebeplerden dolayı iptal edilmiş.
`9075`	SANAL POS	Referans İşlem Geçersiz	Referans işlem geçersiz
`9076`	SANAL POS	Puan İle Satışta Taksit Sayısı Gönderilemez	Puan ile satışta taksit sayısı gönderilemez
`9077`	SANAL POS	İşlem Zaten İade Edilmiş	İşlem zaten iade edilmiş
`9078`	SANAL POS	İşlem Zaten İptal Edilmiş	İşlem zaten iptal edilmiş
`9079`	SANAL POS	Geçersiz İade Tutarı	Geçersiz iade tutarı
`9080`	SANAL POS	Puan Tutarı Hatalı	Puan Tutarı Hatalı
`9081`	SANAL POS	Terminal Bulunamadı	Terminal Bulunamadı
`9083`	SANAL POS	Kullanıcı Ldap Bilgileri Hatalı	Kullanıcı Ldap Bilgileri Hatalı
`9084`	SANAL POS	Tek Kullanımlık Şifre Girişi Yapılmalıdır	Tek Kullanımlık Şifre Girişi Yapılmalıdır
`9085`	SANAL POS	Kullanıcı Ldap Sisteminde Bulunamadı	Kullanıcı Ldap Sisteminde Bulunamadı
`9086`	SANAL POS	Tek Kullanımlık Şifre Bulunamadı	Tek Kullanımlık Şifre Bulunamadı
`9087`	SANAL POS	Girilen Tek Kullanımlık Şifre Yanlış	Girilen Tek Kullanımlık Şifre Yanlış
`9088`	SANAL POS	Tek Kullanımlık Şifrenin Süresi Doldu	Tek Kullanımlık Şifrenin Süresi Doldu
`9089`	SANAL POS	Mesaj Servisi Hata Aldı	Mesaj Servisi Hata Aldı
`9090`	SANAL POS	Hatalı Kullanıcı E-Posta	Hatalı Kullanıcı E-Posta
`9091`	SANAL POS	Puan Kodu Zorunlu	Puan Kodu Zorunlu
`9092`	SANAL POS	Hatalı E-Posta Tipi	Hatalı E-Posta Tipi
`9093`	SANAL POS	Rol Pasif Yapılamaz. Bu Role Sahip Aktif Kullanıcılar Bulunmaktadır.	Rol pasif yapılamaz. Bu role sahip aktif kullanıcılar bulunmaktadır.
`9094`	SANAL POS	Kullanıcı Rolü Aktif Değil Ya Da Silinmiş.	Kullanıcı rolü aktif değil ya da silinmiş.
`9096`	SANAL POS	Üye İşyeri Yönetici Rolü Eklemek İçin Üye İşyeri Seçmelisiniz.	Üye işyeri yönetici rolü eklemek için üye işyeri seçmelisiniz.
`9097`	SANAL POS	Geçersiz Müşteri Bilgisi	Geçersiz müşteri bilgisi
`9098`	SANAL POS	Geçersiz İşlem Tarihi	Geçersiz işlem tarihi
`9099`	SANAL POS	Geçersiz İşlem Tipi	Geçersiz işlem tipi
`9100`	SANAL POS	Geçersiz Tekrar Sayısı	Geçersiz Tekrar Sayısı
`9101`	SANAL POS	Geçersiz Tekrarlama Aralığı	Geçersiz Tekrarlama Aralığı
`9102`	SANAL POS	Geçersiz Periyot Tipi	Geçersiz periyot tipi
`9103`	SANAL POS	Kaydın Statüsü Bu İşlem İçin Uygun Değil	Kaydın Statüsü Bu işlem İçin Uygun Değil
`9104`	SANAL POS	City Information Is Not Found.	City Information Is Not Found.
`9105`	SANAL POS	Town Information Is Not Found.	Town Information Is Not Found.
`9106`	SANAL POS	Customer Name Information Is Not Found.	Customer Name Information Is Not Found.
`9107`	SANAL POS	Customer Surname Information Is Not Found.	Customer Surname Information Is Not Found.
`9108`	SANAL POS	Invalid Customer Number.	Invalid Customer Number.
`9109`	SANAL POS	Invalid Customer Email Information.	Invalid Customer Email Information.
`9110`	SANAL POS	Bu Müşteri Numarasına Sahip Zaten Bir Müşteri Mevcut	Bu müşteri numarasına sahip zaten bir müşteri mevcut
`9111`	SANAL POS	Role Atanan Üye İşyeri Numarası İle Kullanıcıya Atanan Numara Eşleşmiyor.	Role atanan üye işyeri numarası ile kullanıcıya atanan numara eşleşmiyor.
`9112`	SANAL POS	İşlem Numarası Zaten Mevcut	İşlem Numarası Zaten Mevcut
`9113`	SANAL POS	Tekrarlama Aralığı Değeri Boş Bırakılamaz.
`9114`	SANAL POS	Pancode Zorunlu	PanCode Zorunlu
`9115`	SANAL POS	Pancode Zaten Mevcut	PanCode Zaten Mevcut
`9116`	SANAL POS	Müşteri Ad-Soyad Uzunlugu Hatalı	Müşteri Ad-Soyad Uzunlugu Hatalı
`9117`	SANAL POS	3Dsecure İşlemlerde Eci Degeri Bos Olamaz	3DSecure İşlemlerde ECI degeri bos olamaz
`9118`	SANAL POS	Bu Batch Daha Önce Kapatılmıştır.	Bu batch daha önce kapatılmıştır.
`9121`	SANAL POS	Lütfen Geçerli Bir Ay / Yıl Giriniz.	Lütfen geçerli bir ay / yıl giriniz.
`9200`	SANAL POS	Gib Taksit Yetkisi Sadece Gib Üye İşyerlerine Verilebilir.	Gib Taksit Yetkisi Sadece Gib Üye İşyerlerine Verilebilir.
`9201`	SANAL POS	Girilen Üye İş Yeri Numarası Zaten Sisteme Kayıtlıdır.	Girilen üye iş yeri numarası zaten sisteme kayıtlıdır.
`9553`	SANAL POS	Response Kodu Boş	Response Kodu Boş
`9578`	SANAL POS	Client Request Id Boş	Client Request Id Boş
`9579`	SANAL POS	Client Request Id Çok Uzun	Client Request Id Çok Uzun
`9580`	SANAL POS	Client Id Boş	Client Id Boş
`9581`	SANAL POS	Client Şifre Boş	Client Şifre Boş
`9582`	SANAL POS	Client Şifre Çok Uzun	Client Şifre Çok Uzun
`9583`	SANAL POS	Client Request Zamanı Boş	Client Request Zamanı Boş
`9587`	SANAL POS	Client Id Ya Da Şifre Hatalı	Client Id ya da Şifre Hatalı
`9595`	SANAL POS	Kayıt Zaten Mevcut	Kayıt Zaten Mevcut
`9601`	SANAL POS	Kayıt Bulunamadı	Kayıt bulunamadı
`9602`	SANAL POS	Yeni Kayıt Silinmiş Olamaz
`9603`	SANAL POS	Kayıt Bilgisi Boş Olamaz
`9612`	SANAL POS	Sayfa No En Az 1 Olabilir	Sayfa No En Az 1 Olabilir
`9614`	SANAL POS	Sayfadaki Kayıt Sayısı En Az 1 Olabilir	Sayfadaki Kayıt Sayısı En Az 1 Olabilir
`9615`	SANAL POS	En Fazla 50 Kayıt Listelenebilir	En Fazla 50 Kayıt Listelenebilir
`9993`	SANAL POS	Url Formatı Yanlış
`9994`	SANAL POS	Doküman Başlığı Formatı Yanlış

3D Secure Aşaması Hata Kodları

Hata Kodu	Hata Kaynağı	Hata Kodu Açıklaması	Hata Detayı
`200`	GET 7/24	Enrollment ve Pares status değerleri Y ise başarılı. Aksi durumda doğrulama eksik.
`20`	GET 7/24	Kart 3D Secure programına dahil değil	Kart hamili bankasının çağrı merkeziyle görüşmelidir.
`33`	GET 7/24	Kartın 3D Secure doğrulaması yapılamadı	Kart hamili bankasının çağrı merkeziyle görüşmelidir.
`400`	GET 7/24	3D Şifre doğrulaması yapılamadı.
`1001`	GET 7/24	System Error	Sistem Hatası
`1002`	GET 7/24	Success url format is invalid
`1003`	GET 7/24	Brand Id format is invalid
`1004`	GET 7/24	Device category format is invalid
`1005`	GET 7/24	Session info format is invalid
`1006`	GET 7/24	Xid format is invalid
`1007`	GET 7/24	Currency format is invalid
`1008`	GET 7/24	Purchase amount format is invalid
`1009`	GET 7/24	Expire date format is invalid
`1010`	GET 7/24	Pan format is invalid
`1011`	GET 7/24	Merchant acquirer bin password format is invalid
`1012`	GET 7/24	Host merchant format is invalid
`1013`	GET 7/24	Bank Id format is invalid
`1014`	GET 7/24	Is recurring format is Invalid
`1015`	GET 7/24	Recurring frequency format is invalid
`1016`	GET 7/24	Recurring end date format is invalid
`1017`	GET 7/24	Installment count format is invalid
`1018`	GET 7/24	AcctId format is invalid
`1019`	GET 7/24	Protocol format is invalid
`1020`	GET 7/24	Acs url format is invalid
`1021`	GET 7/24	Error message format is invalid
`1022`	GET 7/24	Pares cavv format is invalid
`1023`	GET 7/24	Pares eci format is invalid
`1024`	GET 7/24	Pares cavv algorithm format is invalid
`1025`	GET 7/24	VeRes message Id does not match VeReq message Id
`1026`	GET 7/24	Invalid fail url
`1027`	GET 7/24	VeRes status format is invalid
`1028`	GET 7/24	Veres version format is invalid
`1029`	GET 7/24	Pares version format is invalid
`1030`	GET 7/24	Pares acquirer bin format is invalid
`1031`	GET 7/24	Pares merchant Id format is invalid
`1032`	GET 7/24	Pares pan format is invalid
`1033`	GET 7/24	Pares time format is invalid
`1034`	GET 7/24	Pares date format is invalid
`1035`	GET 7/24	Pares Xid format is invalid
`1036`	GET 7/24	Pares status format is invalid
`1037`	GET 7/24	Pares IReq format is invalid
`1038`	GET 7/24	Pares vendor code format is invalid
`1039`	GET 7/24	Pares exponent format is invalid
`1040`	GET 7/24	Invalid Xid
`2000`	GET 7/24	Acquirer info is empty
`2005`	GET 7/24	Merchant cannot be found for this bank	Api şifresi ve istek url adresi kontrol edilmeli.
`2006`	GET 7/24	Merchant acquirer bin password is required
`2009`	GET 7/24	Brand not found
`2010`	GET 7/24	Card holder info is empty
`2011`	GET 7/24	Pan is empty
`2012`	GET 7/24	Device category must be between 0 and 2
`2013`	GET 7/24	Threed secure message can not be found
`2014`	GET 7/24	Pares message id does not match threed secure message id
`2015`	GET 7/24	Signature verification failed
`2017`	GET 7/24	Acquire bin can not be found
`2018`	GET 7/24	Merchant acquirer bin password is wrong
`2019`	GET 7/24	Bank not found
`2020`	GET 7/24	Bank Id does not match merchant bank
`2021`	GET 7/24	Invalid currency code
`2022`	GET 7/24	Verify enrollment request Id cannot be empty
`2023`	GET 7/24	Verify enrollment request Id already exists for this merchant
`2024`	GET 7/24	Acs certificate cannot be found in database
`2025`	GET 7/24	Certificate could not be found in certificate store
`2026`	GET 7/24	Brand certificate not found in store
`2027`	GET 7/24	Invalid xml file
`2028`	GET 7/24	Threed secure message is in an invalid state
`2029`	GET 7/24	Invalid pan
`2030`	GET 7/24	Invalid expire date
`2031`	GET 7/24	Verification failed: No signature was found in the document
`2032`	GET 7/24	Verification failed: More that one signature was found for the document
`2033`	GET 7/24	Actual brand can not be found
`2034`	GET 7/24	Invalid amount
`2035`	GET 7/24	Invalid recurring information
`2036`	GET 7/24	Invalid recurring frequency
`2037`	GET 7/24	Invalid reccuring end date
`2038`	GET 7/24	Recurring end date must be earlier than expire date
`2039`	GET 7/24	Invalid x509 certificate data
`2040`	GET 7/24	Invalid installment
`2041`	GET 7/24	Pares exponent value does not match Pareq exponent
`2042`	GET 7/24	Pares acquirer bin value does not match Pareq acqiurer bin
`2043`	GET 7/24	Pares Merchant Id does not match Pareq Merchant Id
`2044`	GET 7/24	Pares Xid does not match Pareq Xid
`2045`	GET 7/24	Pares purchase amount does not match Pareq purchase amount
`2046`	GET 7/24	Pares currency does not match pareq currency
`2047`	GET 7/24	VeRes Xsd validation error
`2048`	GET 7/24	PaRes Xsd validation exception
`2049`	GET 7/24	Invalid request
`2050`	GET 7/24	File is empty
`2051`	GET 7/24	Custom error
`2052`	GET 7/24	Bank brand bin already exists
`2053`	GET 7/24	Directory server communication error	DS iletişiminde hata oluştu.
`2054`	GET 7/24	ACS error occurred	ACS hata bildirdi.
`2055`	GET 7/24	Encryption key not found
`2056`	GET 7/24	Hsm session not found
`2057`	GET 7/24	Max on us brand count is one
`9595`	GET 7/24	This record already exists
`9601`	GET 7/24	This record does not exist
`3000`	GET 7/24	Bank not found
`3001`	GET 7/24	Country not found
`3002`	GET 7/24	Invalid fail url
`3003`	GET 7/24	Host merchant number cannot be empty
`3004`	GET 7/24	Merchant brand acquirer bin cannot be empty
`3005`	GET 7/24	Merchant name cannot be empty
`3006`	GET 7/24	Merchant password cannot be empty
`3007`	GET 7/24	Invalid sucess url
`3008`	GET 7/24	Invalid merchant site url
`3009`	GET 7/24	Invalid acquirer bin length
`3010`	GET 7/24	Brand cannot be null
`3011`	GET 7/24	Invalid acquirer bin password length
`3012`	GET 7/24	Invalid host merchant number length
`3013`	GET 7/24	End date must be greater than start
`3014`	GET 7/24	Start date must be greater than DateTime MinVal
`3015`	GET 7/24	End date must be greater than DateTime MinVal
`3016`	GET 7/24	Invalid search period
`3017`	GET 7/24	Bin cannot be empty
`3018`	GET 7/24	Card type cannot be empty
`3019`	GET 7/24	Bank brand bin not found
`3020`	GET 7/24	Bin length must be six

Sık Sorulan Sorular

prmstr alanına XML'i nasıl göndereceğim?

XML string'ini URL-encode ederek application/x-www-form-urlencoded veya multipart/form-data body içinde prmstr key'i ile gönderin. Örnek: prmstr=<VposRequest>...</VposRequest>

Expiry formatı ne olmalı?

6 karakter YYYYMM formatında gönderilmelidir. Örneğin Aralık 2029 için: 202912

CurrencyCode değerleri nelerdir?

949 = TRY (Türk Lirası), 840 = USD (Dolar), 978 = EUR (Euro), 826 = GBP (Sterlin)

Refund ile Cancel arasındaki fark nedir?

Cancel: Gün sonu kapanmadan önce, aynı gün yapılan işlemi geri alır. Refund: Gün sonu kapandıktan sonra başka günlerde iade için kullanılır.

TransactionDeviceSource ne zaman 1 gönderilir?

Mobil uygulama veya native app üzerinden yapılan işlemlerde 1, web tabanlı işlemlerde 0 gönderilir.

Settlement endpoint'i neden farklı bir host kullanıyor?

Mutabakat servisleri (Settlement, SettlementDetail) farklı bir API Gateway üzerinde çalışır: apigw.vakifbank.com.tr:8443