Topics

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, and checkout.session.completed arrives 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", and checkout.session.completed arrives with that status. When the customer pays in their bank, the payment becomes captured and the payment_intent.captured webhook fires, with the same data.id as the payment_intent_id in checkout.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:

bash
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_date and final_due_date: Unix timestamps in seconds, in the future. final_due_date can't be before due_date.
  • Optional: customer (a customer ID), items and discount_amount. Each item has description, quantity, unit_amount and vat_rate (0, 11 or 24), and the lines' total, less discounts, should equal amount. 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.

View as markdown