İçeriğe geç
Dokümantasyon
GeliştiricilerAPI başvurusuŞirketler

Şirket gelirini gönder

PUT
/v1/public-api/company-revenue

Kapsam: revenue:write. Şirket company_uuid, yoksa external_id (kendi sisteminizdeki kimlik), yoksa domain ile bulunur. Aynı Idempotency-Key farklı gövdeyle kullanılırsa 409 döner.

Yetkilendirme

integrationKey
headerAuthorizationBearer <cf_sk_…>

Organizasyon API anahtarı (cf_sk_…). Organizasyon → API ve otomasyonlar → API anahtarları sayfasında oluşturulur; Authorization: Bearer cf_sk_… başlığıyla gönderilir.

Başlık parametreleri

Idempotency-Key*string
Lengthlength <= 200

İstek gövdesi

application/json
  1. body
company_uuid?string
Formatuuid
external_id?string
domain?string
source?string
Value in"api""stripe""iyzico"
mrr_minor?integer
Formatint64
Range0 <= value
currency?string
Match^[A-Za-z]{3}$
plan?string
Lengthlength <= 120
billing_status?string
Value in"none""trialing""active""past_due""canceled"
renewal_at?|

RFC 3339 zaman ya da YYYY-MM-DD tarih; null değeri siler.

lifetime_value_minor?integer
Formatint64
Range0 <= value
external_ref?string
Lengthlength <= 200

Response Body

Tamam

application/json
  1. response
success*true
Value intrue
data*
meta*
Örnek istek
curl -X PUT 'https://api.getclickfix.com/v1/public-api/company-revenue' \  -H 'Idempotency-Key: string' \  -H 'Content-Type: application/json' \  -d '{  "external_id": "F-77",  "source": "api",  "mrr_minor": 490000,  "currency": "TRY",  "plan": "pro",  "billing_status": "active",  "renewal_at": "2026-12-01T00:00:00Z",  "lifetime_value_minor": 5880000,  "external_ref": "sub_9f3k2"}'
Örnek yanıt
{  "success": true,  "data": {    "company_uuid": "0f9e8d7c-6b5a-4493-8271-605f4e3d2c1b",    "revenue": {      "mrr_minor": 490000,      "currency": "TRY",      "plan": "pro",      "billing_status": "active",      "renewal_at": "2026-12-01T00:00:00Z",      "lifetime_value_minor": 5880000,      "source": "api",      "external_ref": "sub_9f3k2",      "updated_at": "2026-11-11T09:30:00Z"    }  },  "meta": {    "request_id": "01JCK9ZQ3M8R2W7X5E4T1N0PAB"  }}