Bekleyen odemeyi krediyle tahsil et (InvoicePaid)
POST/orders/:id/settle
Bekleyen (pending_payment / payment_failed) bir siparisin WHMCS
faturasina bayi bakiyesinden odeme dener. Bayi WHMCS'inde musteri
faturayi odeyince tetiklenir (InvoicePaid hook). Siparis aninda bakiye
yetersizdiyse, bayi sonradan bakiye yukledikten sonra burada tahsil
edilir → VPS kurulumu kuyruga girer (pending_provision).
Idempotent: Zaten odenmis (payment_applied=true) bir sipariste
WHMCS'e hic dokunulmaz; already_applied=true ile mevcut durum doner.
Bu nedenle Idempotency-Key header'i GEREKMEZ.
Sonuc durumlari (status):
pending_provision— kredi uygulandi, VPS kurulumu beklemedepending_payment— bakiye hala yetersiz (notice=insufficient_credit), tekrar denenebilirpayment_failed— WHMCS gecici hata (5xx); sonra tekrar dene
Izolasyon: Baska bayinin siparis id'si 404 order_not_found doner.
Request
Responses
- 200
- 401
- 404
- 429
Tahsil denemesi sonucu (basari, yetersiz veya zaten odenmis)
Kimlik dogrulama basarisiz — eksik header, hatali credential, IP whitelist disi veya revoke edilmis key. Detay sizdirilmaz; tum durumlar tek mesaj.
Response Headers
RFC 7617 Basic Auth challenge
Siparis bulunamadi (diger bayinin kaydi da 404)
Dakika basina limit asildi
Response Headers
429 sonrasi tekrar denemeden once beklenmesi gereken saniye (RFC 7231 §7.1.3)
Bu key icin tanimli dakika basi limit
Sonraki window basinin Unix epoch'u (UTC saniye)