Skip to main content

Stripe with InterPayments on Kolleno to handle surcharges

Connect Stripe and InterPayments to automatically calculate compliant credit-card surcharges.

Kolleno Support avatar
Written by Kolleno Support
Updated this week

What are credit-card surcharges?

Surcharging passes card processing fees to your customer instead of absorbing them.
Kolleno partners with InterPayments to calculate these fees automatically ensuring compliance with all card-network and state rules.

Before you start

  • Stripe account – You’ll need a connected Stripe account.

  • InterPayments API key – Provided by InterPayments to calculate surcharges.

Request Activation for InterPayments in Kolleno

Before connecting InterPayments, the feature must be activated on your Kolleno instance.

To request activation, please contact Customer Success by sending an email to support@kolleno.com with the following details:

Subject: Request to Enable InterPayments:

Include in your email:

  • Your Kolleno URL

  • Request to enable Surcharge for Payments

If your organisation uses Stripe, please also include a request to enable:

stripe_enable_payment_elements

Step 1 – Connect Stripe

  1. Go to Settings → Integrations → Payments → Stripe.

  2. Select your desired account (Sandbox or Live).

  3. Complete the Stripe OAuth connection.

  4. You should now see Stripe connected.

Step 2 – Connect InterPayments

  1. In Settings → Integrations, click Connect under InterPayments.

  2. Enter your API Key from InterPayments and click Connect.

  3. Once connected, the indicator will show Connected.

Step 3 – Add a customer card (optional)

  1. Select a customer’s Invoice.

  2. Click Charge customer → Add card.

  3. Send the generated secure link to your customer.

Step 4 – Generate a surcharged payment link

  1. On the invoice, select Charge customer → Stripe.

  2. Confirm the amount and click Generate link.

  3. Kolleno shows:

    • Amount – Original invoice value.

    • Surcharge – Calculated fee.

    • Surcharge fee percentage – e.g., 2.75 %.

    • Total – Amount + surcharge.

  4. Copy the payment link generated by Kolleno and send it to your customer. Alternatively, click Open link to view the payment page.

Step 5 – Customer payment flow

When your customer opens the link they’ll see the Kolleno customer portal with your branding. The flow is as follows:

  1. Location and card details – For compliance, customers with U.S. cards must select their state (e.g., New York) because surcharging rules vary. The customer then enters or confirms their card details.

  2. Review surcharge – The portal displays a summary of amount, surcharge, surcharge fee %, and total.

  3. Confirm and pay – The customer clicks Confirm and Pay. Kolleno processes the payment via Stripe and uses InterPayments to collect the surcharge. Upon success, a confirmation message appears.

Did this answer your question?