Charge Now
POST
/v1/subscriptions/{id}/charge-nowOptionalTrigger an immediate renewal charge rather than waiting for nextChargeAt. Returns a queueing receipt; poll GET /v1/subscriptions/{id} until the status flips out of charging.
Authentication
Signature Pattern
HMAC-SHA256(secretKey, "{timestamp}\nPOST\n/v1/subscriptions/{id}/charge-now\n{sha256(body)}")| Header | Value | Description |
|---|---|---|
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) |
Request Example
JSONRequest Body
{}Response Parameters
| Field | Type | Example |
|---|---|---|
status | string | "queuing" |
subscriptionId | string | "sub_5e6f70819a2b" |
expectedAt | string | "2026-04-13T10:01:00Z" |
checkAt | string | "/v1/subscriptions/sub_5e6f70819a2b" |
Response Example
JSONResponse
{
"status": "queuing",
"subscriptionId": "sub_5e6f70819a2b",
"expectedAt": "2026-04-13T10:01:00Z",
"checkAt": "/v1/subscriptions/sub_5e6f70819a2b"
}Status Codes
200Success
201Created
400Bad Request
401Unauthorized
404Not Found
429Rate Limited
Try itMock
POSThttps://api.pay.sandbox.kvell.group