Integrate
Bill your business customers
With account hierarchy, have Charitips bill each business customer directly, through a link or a form embedded in your product, or bill them yourself.
With account hierarchy, the donations of a business customer are billed either to each customer by Charitips (billing delegation) or to your account, for you to bill your customers. The mode is set in your Charitips contract; Account hierarchy explains both.
In short
- Billing delegation: each child account gets its own monthly invoices, sent and charged by Charitips. Your customer adds its billing details and a payment method through a link you share or a form you embed.
- Billed to you: one monthly invoice for all your customers, on your own payment method. You invoice them yourself.
- A share of the revenue for you can be agreed in either mode.
Billing delegation
A child account starts with bank transfer as its payment method. To pay by card or SEPA direct debit, your customer fills its billing details and a payment method once, on a page Charitips hosts.
Share the billing link
Call Create a shareable billing link with the customer's accountId. It returns the link to send to the customer's purchasing or finance team.
curl -X POST https://api.sandbox.charitips.com/v1/accounts/<accountId>/billing-link \ -H "Authorization: Bearer $CHARITIPS_TOKEN"Request bodies are written for this docs and checked against the API's validation; ids in angle brackets are placeholders. Response values are placeholders built from the schema.
A link is valid one month, a period that may change: create a new one each time you share it.
403 Billing delegation is not enabled for this account: this child is billed to you, or your plan does not include billing delegation.402 Plan upgrade required: your plan does not include account hierarchy.400 No domain found for your account: your own account has no site yet. Contact us.
Or embed the billing form
To keep your customer in your product, show the same form there with the billing widget. Its secret is the last segment of the billing link.
import { createBillingWidget } from '@charitips/embed'; createBillingWidget({ baseUrl: 'https://embed.sandbox.charitips.com', // https://embed.charitips.com on live container: document.querySelector('#billing'), secret: '<last segment of the billing link>', size: 'fitContent', onSuccess() { // The customer saved a payment method. },});With React, AdminBillingWidget from @charitips/embed-react takes the same options inside a CharitipsProvider. See Widgets to install the libraries.
On the sandbox, pay with the test payment methods.
Know when a customer is ready
Listen to paymentmethod_create: it arrives with the child's accountId once a payment method is saved. Its type is PAYMENT_CARD, SEPA_DIRECT_DEBIT or BANK_TRANSFER.
{ "event": "paymentmethod_create", "payload": { "paymentMethodId": "38cde1c9-2096-4fdf-9b14-bc2dde084c39", "status": "ENABLED", "type": "PAYMENT_CARD", "accountId": "0c57ab4d-874d-422f-84be-89f2069520d8", "createdAt": "2026-04-14T16:54:45.456Z", "updatedAt": "2026-04-14T16:54:45.456Z" }, "diff": { "status": "ENABLED", "type": "PAYMENT_CARD" }}See Webhooks.
Your share of the revenue
With billing delegation, Charitips also bills and collects the fee you add, if any, and wires what it collected to your bank account at the start of each month. To receive it, Charitips opens a wallet for you at its payment provider, Mangopay, which verifies your company first. Have ready:
- your company's registration number (SIREN for a French company, VAT number otherwise) and head office address;
- your legal representative's first name, last name, email, date of birth, nationality and country of residence, and an identity document;
- your articles of association and a proof of registration (an avis de situation SIRENE for a French company);
- the people who own more than 25 % of the company;
- the IBAN that receives the transfers.
Billed to you
Every donation of your customers is added to your monthly invoice, so add a payment method to your own account in the dashboard billing settings. Read your invoices with List invoices, and each customer's donations with List donations and the child's accountId, to invoice each customer yourself, with your fee if your contract allows one.
Related
Account hierarchy, Donations for your business customers, Billing and fiscal receipts.