Start from an invoice
Collect an invoice by Direct Debit, including customers who do not yet have a mandate
An invoice is a charge surface. When the customer pays that invoice by Direct Debit, RevKeen can collect — after the mandate is Active and advance notice has been given.
You can also send a mandate request from an invoice when you only need setup. That request still does not collect until the customer pays.
Payers open the hosted invoice page (path /i/ plus a unique token). That page is the invoice plus payment rails. It is not a checkout-link hop. See Invoices and orders.
Customer has no Active mandate
Send the invoice
Send the invoice as usual. Direct Debit appears as a payment method when the rail is enabled for your account.
Customer chooses Direct Debit
The hosted invoice tells them Direct Debit is not set up yet. They complete the mandate page in the same journey.
Confirmation and notice
If the invoice amount, collection date, and frequency are already known, RevKeen sends one combined confirmation and first-collection notice. Otherwise they get confirmation now and a separate advance notice before collection.
Collection
After the mandate is Active and the notice period has passed, RevKeen submits the collection against that invoice. The invoice stays unpaid until the collection succeeds.
Customer already has an Active mandate
The mandate page is skipped. The hosted invoice tells the customer Direct Debit is already approved. RevKeen sends a separate advance notice, then collects. Completing the payment choice does not mean the invoice is already paid.
Send a mandate from the invoice without collecting
On the invoice, Send mandate request uses the same invitation email as the customer record. Use it when you want the customer to authorise Direct Debit before they pay. It does not debit the invoice. Collection still requires the customer to pay the invoice by Direct Debit (or another eligible collection) once the mandate is Active.
What not to do
- Do not treat mandate completion as invoice paid.
- Do not collect while the mandate is Awaiting setup, Submitted, Failed, Suspended, Cancelled, or expired.
- Do not silently charge a backup card because the mandate is still activating or a collection outcome is unknown. Card fallback is a separate, customer-initiated action.
Webhooks
| Event | Meaning |
|---|---|
mandate.created | Instruction submitted. Not collectable yet. |
mandate.activated | Lodged and Active. |
collection.scheduled | Collection queued against an Active mandate. |
collection.notice_sent | Advance notice sent. |
collection.succeeded / collection.failed | Collection outcome. |
See Webhook events.