Stripe

Two Minute Billing charges cards and bank debits through your Stripe account. You keep your Stripe rates, and Stripe pays out to your bank as usual.

Before you start

• A Stripe account. Test mode works at once; live mode needs Stripe to activate your account.
• Stripe gives you two sets of keys: test and live. Connect the test keys to a test business and the live keys to a live business.
• You need permission to manage payment gateways in Two Minute Billing. The owner and admin roles have it.

Find your API keys

In Stripe, open Developers → API keys. Make sure the Test mode toggle matches the business you are connecting.

You need two values:

Permissions

Connect it in Two Minute Billing

1. Open Settings → Payment gateways and click Add gateway.
2. Select Stripe and paste the Secret Key and the Publishable Key.
3. Select the currencies and the payment methods this account handles.
4. Click Create gateway account.

Then open the account and click Check credentials. Healthy means Stripe accepted the key.

The payment methods you can turn on for Stripe:

• Cards
• Direct Debit (ACH) — US only. The debit settles asynchronously.
• Direct Debit (SEPA) — EU only. The debit settles asynchronously.

Currencies

Two Minute Billing offers these 132 currencies on Stripe:

AED, AFN, ALL, AMD, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BIF, BMD, BND, BOB, BRL, BSD, BWP, BYN, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ETB, EUR, FJD, FKP, GBP, GEL, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HTG, HUF, IDR, ILS, INR, ISK, JMD, JPY, KES, KGS, KHR, KMF, KRW, KYD, KZT, LAK, LBP, LKR, LRD, LSL, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SEK, SGD, SHP, SLE, SOS, SRD, SZL, THB, TJS, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VND, VUV, WST, XAF, XCD, XCG, XOF, XPF, YER, ZAR, ZMW

Your Stripe account's country can limit these. For example, an account in India charges cards issued in India in INR only. Stripe converts a currency that you do not settle in.

Some payment methods take one currency only:

If you leave Currencies empty on the gateway account, the account takes each currency of your business that is on this list.

Webhooks

Stripe tells Two Minute Billing about things that happen after a charge: a bank debit that settles days later, a refund made in the Stripe dashboard, a dispute.

Two Minute Billing registers the webhook with Stripe for you when you save the account. Nothing to copy.

If the gateway account page shows the webhook as not configured:

1. Click “Register with Stripe” on the gateway account page. We create the endpoint and keep the signing secret.
2. Optional: confirm it appears under Developers → Webhooks in Stripe.

Test it

In your test business, create a customer and save the test card 4242 4242 4242 4242 with any future expiry date and any CVC. Collect an invoice: it is marked paid, and Logs shows the call to Stripe and Stripe's answer.

Go live

1. In Stripe, turn Test mode off and copy the live keys (sk_live_…, pk_live_…).
2. In your live business, add Stripe with those keys.
3. Two Minute Billing registers a separate webhook for live mode. Check it under Developers → Webhooks in Stripe.

Troubleshoot

• Check credentials says "We could not check the credentials." with "Invalid API Key provided". The secret key is wrong or was rolled in Stripe. Copy it again from Developers → API keys and update the gateway account.
• The account page shows the webhook as not configured. Follow the steps under Webhooks.
• A bank debit stays pending. ACH and SEPA debits take several business days to settle. Two Minute Billing marks the invoice paid when Stripe reports the debit settled.

Related

• Payment gateways overview
• Recover failed payments
• Handle disputes