AI-First

Þróunarsíða

Segðu AI aðstoðarmanninum hvað þú ert að smíða. Hann mun leiðbeina þér að réttu lausninni og búa til samþættingarfyrirmæl fyrir Cursor, Claude Code eða hvaða AI ritil sem þú notar.

Integration Prompt

Spjallaðu við AI aðstoðarmanninn, búðu síðan til uppsafnaðan fyrirmæl til að líma inn í Cursor, Claude Code eða AI ritilinn þinn.

Lýstu því sem þú ert að smíða í AI aðstoðarmanninum, búðu síðan til samþættingarfyrirmælin hér þegar þú ert tilbúin/n.

Hafist handa

Þrjú skref til að taka við greiðslum. AI aðstoðarmaðurinn getur leiðbeint þér í gegnum hvert þeirra, eða þú getur fylgt eftir hér.

1

Skráðu þig

Skráðu þig á kling.is og ljúktu inngöngu til að fá söluaðilareikninginn þinn.

Nýskrá
2

Fáðu API lykla þína

Finndu prófunar- og raunAPI lykla þína í stjórnborðinu undir Þróunaraðilar. Prófunarlyklar byrja á sk_test_, raunlyklar á sk_live_.

3

Búðu til samþættingarfyrirmælin þín

Lýstu því sem þú ert að smíða fyrir AI aðstoðarmanninn. Hann býr til heildstæð samþættingarfyrirmæl sem þú límir inn í AI ritilinn þinn — Cursor, Claude Code, Windsurf eða hvað sem þú notar. Fyrirmælin innihalda API lykla þína, réttar endastöðvar og kóða sem er sniðinn að tæknistaflanum þínum.

Eða ef þú kýst handvirka leiðina, notaðu API-uppflettirnar hér að neðan til að tengja hlutina sjálfur.

Handvirk leið — fyrsta greiðslan þín á 30 sekúndum

bash
curl -X POST https://api.kling.is/v1/checkout/sessions \
  -H "Authorization: Bearer sk_test_your_key_here" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "amount": 1000,
    "currency": "ISK",
    "success_url": "https://yoursite.is/success"
  }'
Prófunarhamur — engar raungreiðslurIdempotency lyklar nauðsynlegir á öllum skrifum

Grunnhugtök

Kling sér um greiðslur á Íslandi í gegnum nokkrar lykileiningar. Að skilja þessar einingar mun hjálpa þér (eða AI ritlinum þínum) að samþætta hraðar.

Auðkenning

Bearer tókar í gegnum API lykla. Prófunar- og raunumhverfi eru fullkomlega einangruð — aðskildir lyklar, aðskildir viðskiptavinir, aðskilin gögn. Allar skrifaðgerðir krefjast Idempotency-Key hausar fyrir öruggar endurtekningar.

Greiðslulotun

Einfaldasta leiðin til að taka við greiðslu. Búðu til lotu með upphæð, fáðu URL til baka, beindu viðskiptavini þínum. Virkar sem hýst síða eða innfellt yfirlag á síðunni þinni í gegnum @kling/sdk.

Payment Intents

Til að rukka vistaðar greiðsluaðferðir beint. Styður heimila-síðan-ná (t.d. rukka þegar sent), straxná, hlutaná og fulla eða hluta-endurgreiðslu.

Áskriftir

Endurtekin innheimta sem tengir viðskiptavin við vöru. Sér um innheimtutímabil, prufudaga, sjálfvirkar greiðsluendurtekningar við bilun og afpöntun við lok tímabils. Greiðslur eru skráðar sem payment intents með innheimtasamhengi.

Helstu hönnunarákvarðanir

Heiltöluaðgerðir fyrir peninga

Allar upphæðir eru heiltölur. ISK er með núll aukastafi, þannig að 1000 = 1.000 kr.

Fjölleigja

Allar fyrirspurnir eru afmarkaðar af söluaðila. Prófunar- og raunupplýsingar blandast aldrei.

Merkingarfræðilegir villukóðar

Lýsandi kóðar eins og card_declined_insufficient_funds, ekki almenn villuboð.

Viðburðabók

Append-only kladdi yfir allar stöðubreytingar. Sérhver breyting er rekjanleg.

Hvernig áskriftir virka

Áskrift tengir viðskiptavin við vöru og sér um sjálfvirka endurtekna innheimtu. Hér er lífsferill sem samþætting þín ætti að þekkja.

Lífsferill áskriftar

trialingactivepast_duecanceled

trialing → active

Prufutími lýkur, fyrsta greiðsla tekst. Ef varan hefur enga prufu fer hún beint í virkt.

active → past_due

Endurnýjunargreiðsla mistekst. Kerfið reynir sjálfkrafa aftur eftir 1, 3 og 7 daga. Viðskiptavinurinn heldur aðgangi meðan reynt er aftur.

past_due → active

Endurtekning tekst. Áskrift snýr aftur í eðlilega innheimtu.

→ canceled

Hámarksendurtekningar tæmdar, eða bein afpöntun. Notaðu cancel_at_period_end (mælt með) til að láta viðskiptavini halda aðgangi þar til tímabilið lýkur.

Innheimtutímabil

Vörur skilgreina billing_interval (vika, mánuður, ár) og billing_interval_count. Sérhver innheimtuviðburður býr til payment intent með period_start, period_end og billing_reason svo þú vitir alltaf hvað var rukkað og af hverju.

subscription_createFyrsta greiðsla þegar áskrift hefst
subscription_cycleRegluleg endurnýjun í byrjun hvers nýs tímabils

Hvernig greiðslur virka

Sérhver greiðsla í Kling fer í gegnum lífsferil. Hvort sem það er greiðslulota eða bein skuldfærsla í gegnum payment intents, er ferlið það sama.

Lífsferill greiðslna

requires_payment_methodauthorizedcapturedrefunded

Straxná (sjálfgefið)

Heimila og ná í einu skrefi. Hentar best fyrir stafrænar vörur, þjónustu og áskriftir.

Heimila, síðan ná

Leggja fjármuni í bið fyrst, ná síðar (t.d. þegar sent). Stilltu capture: false. Styður hlutaná ef vara er uppselda.

Endurgreiðslur

Fullar eða hluta-endurgreiðslur á náðum greiðslum. Heimilaðar-en-ekki-náðar greiðslur er hægt að hætta við til að losa fjármuni.

Greiðsluþjónustuaðilar

Kling vinnur með Straumur, Landsbankinn og Rapyd. Þú stillir greiðsluþjónustuveituna í stjórnborðinu — API-ið er það sama óháð veitunni.

Webhooks

Allar stöðubreytingar kveikja á viðburðum (payment_intent.captured, subscription.canceled, o.fl.) og eru skráðar í append-only viðburðabók.

@kling/sdk

Opinbert SDK fyrir innfellt greiðsluyfirlag. Opnaðu greiðsluyfirlag beint á síðunni þinni — engin framsending, engar iframe brellur.

bash
npm install @kling/sdk

Innfellt greiðsluferli

typescript
import { Kling } from '@kling/sdk';

// 1. Create a session on your server
const session = await fetch('/api/create-checkout', {
  method: 'POST',
  body: JSON.stringify({ amount: 9900 }),
}).then(r => r.json());

// 2. Open the overlay on the client
const kling = Kling.init();
const result = await kling.checkout({
  sessionId: session.id,
});

if (result.success) {
  // Payment completed — show confirmation
}

API Reference

Fullkomið gagnvirkt API-uppflettirit er sjálfkrafa búið til úr OpenAPI skilgreiningu okkar. Notaðu það til að kanna allar endastöðvar, sjá beiðni/svars-skema og prófa beint.

Gagnvirk API skjöl

Fullkomið endastöðvar-uppflettirit með skema, prófunareiginleika og dæmi.

https://api.kling.is/docs
Open API Docs

Public API Groups

/v1/checkout/sessionsCreate hosted or embedded checkout sessions
/v1/customersCRUD operations on customers
/v1/productsCreate and manage recurring products
/v1/subscriptionsCreate, cancel, and reactivate subscriptions
/v1/payment-intentsCharge saved payment methods directly
/v1/payment-methodsTokenize and manage payment methods
/v1/couponsCreate and manage coupons for recurring billing
/v1/promotion-codesCreate customer-facing promotion codes
/v1/billing-portalCreate customer billing portal sessions
/v1/notification-channelsManage webhook and notification destinations
/v1/kling.jsLoad the client SDK bundle for embedded checkout

AI samþættingaraðstoðarmaður

Lýstu því sem þú ert að smíða og fáðu fyrirmæl fyrir AI ritilinn þinn

Kling ræsir

Lýstu fyrirtækinu þínu. Við finnum réttu lausnina, meða eða án kóða.

t.d. “|”

Tilbúin/n til að samþætta?

Skráðu þig ókeypis og byrjaðu að taka við greiðslum í prófunarham strax. Engin kreditkort þarf.

Búa til reikningTil baka á forsíðu