API Referansına Dön AboneliklerAbonelik Oluştur

Abonelik Oluştur

POST/v1/subscriptionsOptional

Yinelenen bir abonelik oluşturur. cardToken isteğe bağlıdır — belirtilmezse müşterinin varsayılan kayıtlı kartı kullanılır. İsteğe bağlı bir Idempotency-Key başlığını destekler.

Kimlik Doğrulama

İmza Deseni

HMAC-SHA256(secretKey, "{timestamp}\nPOST\n/v1/subscriptions\n{sha256(body)}")

Başlık	Değer	Açıklama
`X-Api-Key`	pk_live_a1b2c3d4e5f6g7h8	Merchant public API key
`X-Signature`	{hmac_sha256_hex}	Hex HMAC-SHA256 request signature
`X-Timestamp`	2026-04-13T10:00:00Z	ISO 8601 UTC request time (±5 min)

İstek Parametreleri

Ad	Tür	Zorunlu	Açıklama
`storeId`	string	Zorunlu	Store the subscription belongs to
`customerId`	string	Zorunlu	Customer being billed
`amountMinor`	integer	Zorunlu	Per-cycle amount in kuruş
`currency`	string	Zorunlu	Always "TRY"
`intervalCount`	integer	Zorunlu	Number of interval units per cycle
`intervalUnit`	string	Zorunlu	day\|week\|month\|year
`cardToken`	string	İsteğe Bağlı	Saved card token (defaults to the customer default card)
`trialEndAt`	string	İsteğe Bağlı	ISO 8601 — start trialing until this date
`generateInvoices`	boolean	İsteğe Bağlı	Generate an invoice each renewal
`description`	string	İsteğe Bağlı	Subscription description

İstek Örneği

JSONİstek Gövdesi

{
  "storeId": "sto_5a6b7c8d",
  "customerId": "cus_a1b2c3d4e5f6",
  "amountMinor": 50000,
  "currency": "TRY",
  "intervalCount": 1,
  "intervalUnit": "month"
}

Yanıt Parametreleri

Alan	Tür	Örnek
`id`	string	"sub_5e6f70819a2b"
`merchantId`	string	"mrc_8a1b2c3d4e5f"
`storeId`	string	"sto_5a6b7c8d"
`customerId`	string	"cus_a1b2c3d4e5f6"
`publicHash`	string	"kQ7rS1tV5wY8zaB3xK9mN2"
`status`	string	"active"
`amountMinor`	integer	50000
`currency`	string	"TRY"
`intervalCount`	integer	1
`intervalUnit`	string	"month"
`cycleNumber`	integer	0
`nextChargeAt`	string	"2026-05-13T10:00:00Z"
`cardLast4`	string	"4321"
`cardBrand`	string	"visa"
`createdAt`	string	"2026-04-13T10:00:00Z"

Yanıt Örneği

JSONYanıt

{
  "id": "sub_5e6f70819a2b",
  "merchantId": "mrc_8a1b2c3d4e5f",
  "storeId": "sto_5a6b7c8d",
  "customerId": "cus_a1b2c3d4e5f6",
  "publicHash": "kQ7rS1tV5wY8zaB3xK9mN2",
  "status": "active",
  "amountMinor": 50000,
  "currency": "TRY",
  "intervalCount": 1,
  "intervalUnit": "month",
  "cycleNumber": 0,
  "nextChargeAt": "2026-05-13T10:00:00Z",
  "cardLast4": "4321",
  "cardBrand": "visa",
  "createdAt": "2026-04-13T10:00:00Z"
}

Durum Kodları

200Success

201Created

400Bad Request

401Unauthorized

404Not Found

429Rate Limited

DeneSahte

POSThttps://api.pay.sandbox.kvell.group

Abonelikleri Listele→