API dokümantasyonu

Bağlantı yolu

1. Bu panelde mağaza oluşturun; API Key ve API Secret üretilir.
2. E-ticaret admininde (NovaShop: Ödeme ayarları) API adresini, key ve secret’i kaydedin.
3. Bağlantıyı test et GET /api/v1/merchant çağırır.
4. Ödeme anında POST /api/v1/checkout/initialize ile oturum açılır.

Kimlik doğrulama

X-Api-Key: pfk_...
X-Timestamp: 1735689600
X-Signature: hex(HMACSHA256(apiSecret, "{apiKey}|{timestamp}|{rawBody}"))

Zaman damgası UTC Unix saniye, ±5 dakika. API Secret tarayıcıya konmaz.

Ödeme oturumu

POST /api/v1/checkout/initialize — dönen paymentPageUrl adresine yönlendirin.

GET /api/v1/installments?bin=552879&amount=1299.90

GET /api/v1/payments/{id} · POST /api/v1/payments/{id}/refund