Vakıfbank Sanal POS Entegrasyonu
Test Ortamı Aktif! Bu sayfa test ortamında çalışmaktadır. Gerçek kartlar ile ödeme yapmayınız.
Endpoint'ler
| Endpoint |
Metod |
Açıklama |
/?do=payment |
POST |
Ödeme başlatma endpoint'i |
/?do=callback |
POST |
3D Secure işlem sonrası dönüş endpoint'i |
/?do=form |
GET |
Ödeme formu |
Ödeme Parametreleri
| Parametre |
Format |
Zorunlu |
Açıklama |
| cardNumber |
16 haneli sayı |
Evet |
Kredi kartı numarası |
| cardHolder |
Metin |
Evet |
Kart üzerindeki isim |
| expireMonth |
1-12 arası sayı |
Evet |
Son kullanma ayı |
| expireYear |
YYYY formatında |
Evet |
Son kullanma yılı |
| cvv |
3-4 haneli sayı |
Evet |
Güvenlik kodu |
| amount |
XX.XX formatında |
Evet |
İşlem tutarı |
| orderId |
Alfanumerik |
Evet |
Benzersiz sipariş numarası |
| currency |
3 haneli kod |
Evet |
Para birimi kodu (949: TRY, 840: USD, 978: EUR) |
Para Birimleri
| Kod |
Para Birimi |
Açıklama |
| 949 |
TRY |
Türk Lirası |
| 840 |
USD |
Amerikan Doları |
| 978 |
EUR |
Euro |
Test Kartları
Bu kartlar sadece test ortamında geçerlidir!
| Kart Numarası |
SKT |
CVV |
Sonuç |
| 4355084355084358 |
12/26 |
000 |
Başarılı İşlem |
| 4355084355084359 |
12/26 |
000 |
Başarısız İşlem |
| 5421190122090656 |
12/26 |
000 |
Başarılı İşlem (MasterCard) |
Örnek İstek
POST /?do=payment HTTP/1.1
Content-Type: application/x-www-form-urlencoded
cardNumber=4355084355084358&
cardHolder=John+Doe&
expireMonth=12&
expireYear=2026&
cvv=000&
amount=100.00&
orderId=ORD-123456&
currency=949
Hata Kodları
| Kod |
Açıklama |
| 1012 |
Üye işyeri bilgileri geçersiz |
| 1015 |
Kart numarası geçersiz |
| 1028 |
Geçersiz işlem tutarı |
| 1033 |
Kartınız 3D-Secure işlemine uygun değil |
| 1034 |
Üye işyeri 3D-Secure işlemine uygun değil |
| 2012 |
İşlem başarısız |
| 2046 |
Yetersiz bakiye |
Önemli Notlar
- Desteklenen para birimleri: TRY (949), USD (840), EUR (978)
- Para birimi kodu gönderilmezse işlem reddedilir
- Yabancı para birimleri ile işlem yapmak için üye işyeri ayarlarınızın uygun olması gerekir
- Son kullanma tarihi YYAA formatında gönderilmelidir (örn: 2503 -> 2025 Mart)
- Test ortamında SSL doğrulaması kapalıdır
- Gerçek ortamda SSL sertifikası zorunludur
- Tüm istekler için karakter kodlaması UTF-8 olmalıdır