Subscriptions

Khaime handles the full subscription lifecycle: creation, billing, renewals, dunning, and cancellation.

Creating a Subscription

Add subscription_frequency_key to your charge or session request:

curl -X POST https://api.khaime.com/api/v1/partner/payments/charge \
  -H "X-API-Key: pk_sandbox_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 4999,
    "currency": "USD",
    "subscription_frequency_key": "monthly",
    "customer": {
      "email": "subscriber@example.com",
      "country": "US"
    }
  }'

Frequencies

Key	Billing Cycle
`daily`	Every day
`weekly`	Every 7 days
`biweekly`	Every 14 days
`monthly`	Every month
`3_months`	Every 3 months
`6_months`	Every 6 months
`yearly`	Every year

Managing Subscriptions

List subscriptions

GET /subscriptions?status=active&limit=20

Get details

GET /subscriptions/{subscription_id}

Cancel

PATCH /subscriptions/{subscription_id}/cancel

Webhook Events

subscription.created — First payment succeeded, subscription active
subscription.renewed — Recurring payment succeeded
subscription.cancelled — Subscription cancelled

Getting Started

Payments

Webhooks

Subscriptions

Subscriptions

Creating a Subscription

Frequencies

Managing Subscriptions

List subscriptions

Get details

Cancel

Webhook Events

​Subscriptions

​Creating a Subscription

​Frequencies

​Managing Subscriptions

​List subscriptions

​Get details

​Cancel

​Webhook Events

Subscriptions

Creating a Subscription

Frequencies

Managing Subscriptions

List subscriptions

Get details

Cancel

Webhook Events