# Áskriftir og innheimtugátt

Rukkaðu viðskiptavini á Íslandi sjálfkrafa vikulega, mánaðarlega eða árlega með áskriftum í Kling, reyndu aftur þegar greiðsla mistekst og leyfðu viðskiptavinum að sjá um eigin áskrift í innheimtugáttinni.

Áskrift tengir viðskiptavin við vöru sem er rukkuð reglulega og innheimtir sjálfkrafa á hverju tímabili. Kling reynir aftur þegar greiðsla mistekst og heldur skrá yfir hverja greiðslu. Viðskiptavinir sjá sjálfir um áskriftina sína í innheimtugáttinni.

## Án forritunar

1. Í stjórnborðinu opnar þú **Vörur** og býrð til áskriftarvöru með verði og tímabili (vika, mánuður eða ár), og prufutíma ef þú vilt.
2. Opnaðu **Greiðsluhlekkir** og búðu til hlekk með vörunni. Það er áskriftarhlekkurinn þinn.
3. Deildu honum. Viðskiptavinurinn skráir sig og greiðir fyrsta tímabilið með korti, og Kling rukkar kortið í byrjun hvers nýs tímabils.

## Með API

Búðu til vöru og sendu svo viðskiptavininn í gegnum [greiðsluferli](https://kling.is/docs/checkout) með `product_id` vörunnar (hann slær inn kortið og áskriftin hefst), eða stofnaðu áskriftina beint fyrir viðskiptavin sem á vistað kort:

```bash
curl -X POST https://api.kling.is/v1/subscriptions \
  -H "Authorization: Bearer $KLING_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cus_...",
    "product_id": "prod_...",
    "payment_method_id": "pm_..."
  }'
```

`collection_method` er `card` (sjálfgefið) eða `bank_claim`, sem sendir [kröfu í heimabanka](https://kling.is/docs/bank-claims) á hverju tímabili í stað þess að rukka kort.

Aðrir endapunktar: `POST /v1/subscriptions/{id}/cancel`, `POST /v1/subscriptions/{id}/reactivate` og `POST` eða `DELETE /v1/subscriptions/{id}/discount`.

## Líftími áskriftar

| Staða | Merking |
|---|---|
| `trialing` | Á prufutíma. Verður `active` þegar fyrsta greiðslan tekst. |
| `active` | Greidd og endurnýjast. |
| `past_due` | Endurnýjun mistókst og Kling reynir aftur. |
| `canceled` | Lokið, eftir uppsögn eða þegar allar tilraunir mistókust. |

Þegar endurnýjun mistekst reynir Kling aftur 1, 3 og 7 dögum eftir hverja fyrri tilraun (þrjár tilraunir). Ef tilraun tekst fer áskriftin aftur í `active`; ef allar mistakast er henni sagt upp.

Sjálfgefið tekur uppsögn gildi í lok yfirstandandi tímabils, svo viðskiptavinurinn heldur því sem hann greiddi fyrir; þangað til sýnir áskriftin `cancel_at_period_end: true`. Til að ljúka henni strax sendir þú `"cancel_immediately": true`.

Hver greiðsla hefur `billing_reason`, `subscription_create` (sú fyrsta) eða `subscription_cycle` (endurnýjun), svo þú veist alltaf hvað var rukkað og hvers vegna. [Webhooks](https://kling.is/docs/webhooks) `subscription.renewed`, `subscription.payment_failed` og `subscription.canceled` láta þjóninn þinn vita hvað gerðist.

## Innheimtugátt

Innheimtugáttin er síða þar sem viðskiptavinurinn sér áskriftina sína og nýlegar greiðslur, uppfærir kortið, segir upp og virkjar aftur. Búðu til gáttarsetu og sendu viðskiptavininn á `url` hennar:

```bash
curl -X POST https://api.kling.is/v1/billing-portal/sessions \
  -H "Authorization: Bearer $KLING_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "customer": "cus_...", "return_url": "https://example.is/adgangur" }'
```

Valkostir: `subscription` (takmarka við eina áskrift), `allow_cancel` og `allow_update_payment_method` (bæði sjálfgefið á) og `expires_in` í sekúndum (sjálfgefið 1800).