DocsTake payments
Online bank claims (kröfur)
With Kling you send online bank claims (kröfur) in Iceland with no collection agreement with your bank and no IOBWS integration, because you sign Kling's claims agreement when you apply to go live. Send them from the dashboard, at checkout or through the API.
An online bank claim (krafa, plural kröfur) is a bill that appears in the customer's online bank in Iceland. They pay it like any other bill, without a card. Claims suit invoices between companies, memberships, course fees and customers who prefer to pay through their bank. They are in Icelandic krónur only.
Without code
Open Rukkun í heimabanka in the dashboard, enter the customer's kennitala, the amount, the due date and the final due date, and send. The claim appears in the customer's online bank, and Claims in the dashboard shows when it has been paid.
At checkout
Once claims are activated, every checkout session in ISK offers payment by claim next to cards, unless you switch that off in Settings or the session sets "payment_method_type": "card". Set "payment_method_type": "bank_claim" to offer a claim only (ISK only). The customer enters their kennitala at checkout instead of a card. What happens next depends on the Claim at checkout setting in your claims settings:
- Paid right away, like a card (the default): the claim is due today, and the checkout waits about 5 minutes while the customer pays it in their online bank. The session completes with
payment_status: "paid"once the bank reports it paid, andcheckout.session.completedarrives then. If the time runs out, the claim is cancelled and the customer can try again or pay by card. - With a payment window: the claim is due in 14 days, with the final due date in 28 days. The session completes as soon as the claim is issued, with
payment_status: "awaiting_claim", andcheckout.session.completedarrives with that status. When the customer pays in their bank, the payment becomescapturedand thepayment_intent.capturedwebhook fires, with the samedata.idas thepayment_intent_idincheckout.session.completed. Ship the order then, not before.
Claims through Landsbanki always use a payment window. In test mode, with the default setting, the waiting screen has a button that pays the claim, so you can try the whole flow.
For subscriptions, "collection_method": "bank_claim" sends a claim each period instead of charging a card. See Subscriptions.
With the API
POST /v1/claims:
curl -X POST https://api.kling.is/v1/claims \
-H "Authorization: Bearer $KLING_SECRET_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: claim-2027-001" \
-d '{
"payor_kennitala": "0101302989",
"amount": 15000,
"due_date": 1799971200,
"final_due_date": 1801180800
}'payor_kennitala: the payer's 10-digit kennitala, no hyphen.amount: whole krónur.due_dateandfinal_due_date: Unix timestamps in seconds, in the future.final_due_datecan't be beforedue_date.- Optional:
customer(a customer ID),itemsanddiscount_amount. Each item hasdescription,quantity,unit_amountandvat_rate(0, 11 or 24), and the lines' total, less discounts, should equalamount. Note the names differ from checkout items (amount,tax_rate).
Send an Idempotency-Key so a retry doesn't send the customer a second claim. You can't set metadata on a claim, so store the returned id or payment_intent with your own records.
A claim's status is pending, unpaid, paid, partially_paid, cancelled or secondary_collection. List claims with GET /v1/claims (filter by status, paginate with limit and offset), read one with GET /v1/claims/{id} and cancel with POST /v1/claims/{id}/cancel. The claim.created and claim.paid webhooks tell your server what happened.
Setting it up
Kling sends the claims through its own bank connection, so you need no collection agreement with your bank and no IOBWS integration. Claims don't go through a card acquirer either. In the go-live application, someone Skatturinn lists as able to sign for the company signs Kling's claims agreement with electronic ID, so claims can be switched on before card payments. Once the application is approved, the dashboard shows how your claims will look and asks whether you pay Kling's service fee by claim or by card. Then you choose Activate claims. See Test mode to going live. The Kröfur in Iceland guide covers the same for business owners, without the technical detail.
Pricing
0,8% of each claim sent, at least 25 kr. and at most 250 kr., plus the bank's cost per claim. The fee applies to every claim issued, also one that is later cancelled or expires unpaid. See pricing.