SkjölunTaktu við greiðslum
Greiðslur, heimildir og endurgreiðslur
Hvernig greiðsla fer í gegnum Kling, frá heimild til innheimtu og endurgreiðslu, og hvernig þú rukkar vistað kort á Íslandi með payment intents API.
Hver greiðsla í Kling er payment intent, hvort sem hún hófst í greiðsluferli, greiðsluhlekk, áskrift eða beinu API-kalli. Hér er farið yfir líftíma greiðslu og hvernig þú rukkar vistað kort, innheimtir seinna og endurgreiðir.
Líftími greiðslu
| Staða | Merking |
|---|---|
requires_payment_method |
Stofnuð, bíður eftir korti. |
requires_action |
Viðskiptavinurinn þarf að ljúka skrefi, t.d. 3-D Secure í bankaappinu. |
authorized |
Upphæðin er frátekin á kortinu en ekki enn tekin. |
pending_settlement |
Samþykkt og í uppgjöri. Líttu á að hún hafi tekist. Hjá Verifone sendir greiðsla sem fer síðar héðan í captured ekkert payment_intent.captured webhook. |
captured |
Greidd. |
awaiting_claim |
Krafa í heimabanka var send og bíður greiðslu. |
failed |
Hafnað eða mistókst. Villukóðinn (code) segir hvers vegna, t.d. card_declined_insufficient_funds. |
canceled |
Heimild var felld niður fyrir innheimtu. |
partially_refunded, refunded |
Hluti eða öll greiðslan var endurgreidd. |
Innheimta strax eða seinna
Sjálfgefið er greiðsla heimiluð og innheimt í einu skrefi. Það hentar þjónustu, stafrænum vörum og áskriftum.
Til að taka upphæðina frá fyrst og innheimta seinna, til dæmis þegar pöntun er send, býrðu til greiðsluferlið eða payment intent með "capture": false. Í greiðsluferli virkar þetta aðeins hjá Straumi; aðrir færsluhirðar, og greiðsluferli í test-umhverfi, innheimta strax. Ekkert webhook er sent þegar upphæðin er tekin frá: checkout.session.completed og payment_intent.captured berast ekki fyrr en þú innheimtir, svo finndu fráteknar greiðslur með GET /v1/payment-intents?status=authorized. Síðan:
POST /v1/payment-intents/{id}/captureinnheimtir upphæðina. Senduamounttil að innheimta minna en var heimilað, til dæmis ef vara er uppseld.POST /v1/payment-intents/{id}/cancelfellir heimildina niður. Ef færsluhirðirinn hafði þegar tekið upphæðina kemur greiðslan til baka semcaptured, svo athugaðustatusí svarinu.
Rukkaðu vistað kort
Þegar viðskiptavinur hefur vistað kort (greiðsluferli með save_payment_method, eða áskrift) geturðu rukkað það aftur án hans aðkomu:
curl -X POST https://api.kling.is/v1/payment-intents \
-H "Authorization: Bearer $KLING_SECRET_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: renewal-2026-10-cus_123" \
-d '{
"amount": 2990,
"customer": "CUSTOMER_ID",
"payment_method": "PAYMENT_METHOD_ID",
"description": "Mánaðarkassi, október"
}'Nauðsynlegt: amount, customer, payment_method. Valkvætt: currency, capture, description, statement_descriptor (allt að 22 stafir, birtist á kortayfirliti) og metadata. Auðkenni eru UUID. amount er í minnstu einingu gjaldmiðilsins: ISK hefur enga (2990 er 2.990 kr.), EUR og USD eru í sentum.
Korti sem er hafnað skilar samt HTTP 200, með status: "failed" og error hlut, svo athugaðu status áður en þú lítur á greiðsluna sem greidda.
Endurgreiðslur
POST /v1/payment-intents/{id}/refund endurgreiðir af innheimtri greiðslu. Slepptu amount fyrir fulla endurgreiðslu, eða sendu það fyrir hluta. Þú getur endurgreitt oftar en einu sinni, upp að því sem var greitt. Þú getur líka endurgreitt af síðu greiðslunnar í stjórnborðinu. Hver endurgreiðsla sendir payment_intent.refunded: data.amount er upphæð þeirrar endurgreiðslu og data.partial er true þegar hluti greiðslunnar er eftir.
Færsluhirðar
Kortagreiðslur í Kling fara í gegnum Straum, Verifone eða Rapyd, eftir aðganginum þínum. Kling sækir um hjá færsluhirði fyrir þig og API-ið er það sama hver sem hann er. Apple Pay er í boði hjá Straumi og hægt að virkja hjá Verifone; Google Pay er í boði hjá Straumi.