Geliştirici dostu ödeme entegrasyonu
Tahsilart Public API, ödeme başlatma, durum sorgulama, iade, iptal ve webhook callback süreçlerini provider bağımsız şekilde yönetmenizi sağlar.
API ile neler yapılabilir?
Public API, ödeme operasyonunun tüm temel süreçlerini provider bağımsız şekilde kapsar.
Ödeme başlatma
Provider bağımsız tek istekle ödeme akışını başlatın.
Ödeme durumu sorgulama
İşlemin güncel durumunu standart bir sözleşmeyle sorgulayın.
İade işlemi
Tam veya kısmi iade süreçlerini API üzerinden yönetin.
İptal işlemi
Uygun durumdaki işlemleri güvenli şekilde iptal edin.
Webhook callback alma
İşlem sonuçlarını asenkron callback ile anlık alın.
Idempotency key ile güvenli tekrar deneme
Aynı isteği güvenle tekrarlayın, çift işlem riskini ortadan kaldırın.
Tek standart, öngörülebilir istek yapısı
POST /api/v1/public/payments
Headers
X-Api-Key: <value>
X-Signature: <value>
Idempotency-Key: <value>
X-Correlation-Id: <value>
Body
{
"amount": 1250.00,
"currency": "TRY",
"merchantReference": "ORDER-10001",
"callbackUrl": "https://merchant.com/payment/callback"
}Asenkron callback yaşam döngüsü
Ödeme oluşturulduktan sonra sonuç, doğrulanmış webhook ile uçtan uca iletilir.
- 01
Payment created
- 02
Provider dispatched
- 03
Callback received
- 04
Signature validated
- 05
Transaction updated
- 06
Merchant notified
Sürdürülebilir entegrasyon için tasarlandı
Standart ve öngörülebilir bir API sözleşmesiyle entegrasyonu hızlandırın.
- Provider bağımsız sözleşme
- Tek API standardı
- Sabit response yapısı
- Problem details hata modeli
- Correlation id takibi
- Güvenli callback doğrulama
Teknik ekibinizle entegrasyon sürecini planlayalım.
Entegrasyon yaklaşımınızı birlikte değerlendirelim ve hızlıca başlayalım.
