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 yesterday

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

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

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


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 customerAdd 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?