Geliştirici

Teknik güven oluşturan geliştirici sayfası

Bu sayfa canlı bir API referansı değil; Vegüvenli’nin geliştirici portalı için önerilen bilgi mimarisini ve örnek içerik yapısını göstermek için hazırlanmıştır.

Önerilen ana bölümler

  • Hızlı başlangıç
  • Kimlik doğrulama
  • Ödeme oluşturma
  • İşlem sorgulama
  • Webhook olayları
  • Hata kodları
Not: Aşağıdaki endpoint ve JSON örnekleri temsilidir. Canlıya alınmadan önce gerçek teknik doküman ile güncellenmelidir.

Örnek hızlı başlangıç akışı

1. API anahtarınızı alın
2. Test ortamında ödeme isteği gönderin
3. Dönen ödeme URL veya token bilgisini kullanın
4. Webhook ile işlem sonucunu sisteminizde işleyin
5. Başarılı / başarısız durumlarını loglayın

Örnek ödeme isteği

POST /v1/payments
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "order_id": "ORD-1001",
  "amount": 1250.50,
  "currency": "TRY",
  "customer": {
    "name": "Örnek Müşteri",
    "email": "musteri@example.com",
    "phone": "905551112233"
  },
  "callback_url": "https://ornek-site.com/webhook/veguvenli"
}

Örnek webhook cevabı

POST /webhook/veguvenli

{
  "event": "payment.success",
  "order_id": "ORD-1001",
  "transaction_id": "TX-987654",
  "status": "success",
  "amount": 1250.50,
  "currency": "TRY"
}
01

Test ortamı

Geliştirici sayfasında test ve canlı ayrımı net verilmelidir. Anahtar, örnek kart ve sandbox bilgileri görünür olmalıdır.

02

Hata yönetimi

Başarısız istekler, validasyon hataları ve webhook imza kontrol mantığı açıkça anlatılmalıdır.

03

İletişim

Teknik ekip ile görüşmek isteyen müşteriler için açık bir destek/iletişim CTA’sı bulunmalıdır.

Kurumsal iletişim

Vegüvenli ile büyümeye hazır mısınız?

Online tahsilat sürecinizi daha güvenli, daha düzenli ve daha görünür hale getirmek için bizimle iletişime geçin.

info@veguvenli.com 0850 888 35 88
Onuk Plaza İş Merkezi, Halkapınar, 1203. Sk. No:13, 35170 Konak/İzmir