vellTRDocs

Şimdi Çek

POST/v1/subscriptions/{id}/charge-nowOptional

nextChargeAt beklenmeden anında bir yenileme çekimi tetikler. Kuyruğa alındığını bildiren bir yanıt döner; durum charging dışına çıkana kadar GET /v1/subscriptions/{id} ile sorgulama yapın.

Kimlik Doğrulama

İmza Deseni

HMAC-SHA256(secretKey, "{timestamp}\nPOST\n/v1/subscriptions/{id}/charge-now\n{sha256(body)}")
BaşlıkDeğerAçıklama
X-Api-Keypk_live_a1b2c3d4e5f6g7h8Merchant public API key
X-Signature{hmac_sha256_hex}Hex HMAC-SHA256 request signature
X-Timestamp2026-04-13T10:00:00ZISO 8601 UTC request time (±5 min)

İstek Örneği

JSONİstek Gövdesi
{}

Yanıt Parametreleri

AlanTürÖrnek
statusstring"queuing"
subscriptionIdstring"sub_5e6f70819a2b"
expectedAtstring"2026-04-13T10:01:00Z"
checkAtstring"/v1/subscriptions/sub_5e6f70819a2b"

Yanıt Örneği

JSONYanıt
{
  "status": "queuing",
  "subscriptionId": "sub_5e6f70819a2b",
  "expectedAt": "2026-04-13T10:01:00Z",
  "checkAt": "/v1/subscriptions/sub_5e6f70819a2b"
}

Durum Kodları

200Success
201Created
400Bad Request
401Unauthorized
404Not Found
429Rate Limited
DeneSahte
POSThttps://api.pay.sandbox.kvell.group