Stripe payments | ISP Billing Documentation

Correct payment workflow

The customer starts from an unpaid document in the Customer Area and is transferred to Stripe’s hosted checkout. Before confirmation, the payer must compare document, amount, currency, and account with the expected transaction.

Manually recording a payment in administration declares an operator-reconciled collection and is not equivalent to a Stripe Checkout transaction. Checkout creates a gateway transaction whose definitive registration depends on the server events received by ISP Billing.

Access the Customer Area

The customer signs in through the normal Customer Area and must see only documents belonging to that account. Before testing payment, confirm customer identity, active session, currency, and that the Stripe gateway is enabled for customer use.

Open the invoice to be paid

Open Invoices, select the unpaid document, and compare number, issue date, due date, original total, recorded payments, remaining balance, and configured payment method. The payment action should use the remaining payable balance rather than an amount typed by the customer.

The verified example displayed a €48.80 balance, Credit card (Stripe), no existing payments, and Pay now. If a payment is already recorded or a gateway transaction is pending, investigate it before starting another checkout.

Unpaid example invoice in the Customer Area — Document, balance, due date, gateway, and existing payments are checked before checkout.

Start Stripe Checkout

Pay now creates a server-side Stripe Checkout session and redirects the browser to Stripe’s hosted page. Confirm the environment label, merchant identity, customer email, currency, amount, and available payment method before entering any test details.

The hosted page handles card entry and any required authentication. Do not copy secret keys into the browser or create a second session while the first one is being completed.

Stripe Sandbox Checkout — The hosted session must show the same amount and customer context as the ISP Billing document.

Enter an official test card

Different official test cards can exercise authentication or failure scenarios when needed. Never use real card data in a sandbox, never publish live customer payment details, and verify that the page is clearly operating in the intended Stripe test environment before confirmation.

Stripe payment confirmed and pending registration — The intermediate state after Stripe confirmation.

Paid Stripe invoice with zero balance — Paid status and zero balance after correct event processing.

Stripe payment registered on the invoice — The automatically recorded gateway reference and fee.

Security and verification checklist

Use test mode only
Confirm invoice, balance, and Checkout amount
Use official test cards only
Wait for the return to the Customer Area
Check status and balance on both sides
Do not record the same payment manually
Never publish gateway secrets