Başlangıç Rehberi

SanalTahsilat API'si ile dakikalar içinde ödeme almaya başlayabilirsiniz. Bu rehber, entegrasyon sürecinizi adım adım açıklamaktadır.

Not: API anahtarınızı almak için önce bir SanalTahsilat hesabı oluşturmanız gerekmektedir.

API Referans

Tüm API istekleri https://api.gotahsilat.com/v1 temel URL'si üzerinden yapılır. Kimlik doğrulama için Bearer token kullanılır.

Kimlik Doğrulama

HTTP
POST /v1/auth/token
Content-Type: application/json

{
  "api_key": "your_api_key",
  "secret": "your_secret_key"
}

Ödeme Oluşturma

cURL
curl -X POST https://api.gotahsilat.com/v1/payments \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 150.00,
    "currency": "TRY",
    "description": "Siparis #1234"
  }'

Webhooks

Webhook'lar, ödeme durumu değişikliklerinde sisteminize otomatik bildirim gönderir. Aşağıdaki olaylar desteklenmektedir:

payment.completed — Ödeme başarıyla tamamlandığında
payment.failed — Ödeme başarısız olduğunda
payment.refunded — ade işlemi gerçekleştiğinde
payment.pending — Ödeme beklemede olduğunda

SDK'lar

Entegrasyon sürecinizi hızlandırmak için resmi SDK'larımızı kullanabilirsiniz:

Node.js — npm install @gotahsilat/node-sdk
PHP — composer require gotahsilat/php-sdk
Python — pip install gotahsilat
C#/.NET — dotnet add package GoTahsilat.SDK

Hata Kodları

API, standart HTTP durum kodları ve özel hata kodları döndürür:

400 — Geçersiz istek parametresi
401 — Kimlik doğrulama hatası
403 — Yetkilendirme hatası
404 — Kaynak bulunamadı
429 — Rate limit aşıldı
500 — Sunucu hatası