Dökümanlar API Uç Noktaları Payment Callback API

Payment Callback API

PayTR ve Shopier webhook'larını karşılayan uç nokta.

Ödeme sağlayıcılar ödeme sonuçlarını bu URL'ye POST ederler. Detaylı akış için Webhook Akışı sayfasına bak.

Endpoint

HTTP
POST /api/payment-callback.php

PayTR Payload

PayTR tarafından gönderilen form-encoded veri:

  • merchant_oid — sipariş ID
  • statussuccess veya failed
  • total_amount — kuruş cinsinden
  • hash — HMAC-SHA256 imza

Shopier Payload

  • platform_order_id
  • status
  • signature

Yanıt

Başarılı işleme sonucu:

RESPONSE
HTTP/1.1 200 OK
Content-Type: text/plain

OK

PayTR "OK" metnini bekler; başka bir şey dönersen isteği tekrar dener (4 sefere kadar).

Test

Geliştirme sırasında admin/api/test-payment.php endpoint'i manuel test için mevcuttur. Admin yetkisi gerektirir.

Sadece HTTPS: HTTP üzerinden gelen istekler reddedilir. Local'de test için tunneling (ngrok, cloudflared) kullan.

Teşekkürler! Geri bildirimin kaydedildi.