Billing

Definition
Swan charges banking fees directly for each account as defined in our T&Cs. The prices are fixed and cannot be changed (for now). We deduct the banking fees in almost real-time directly from the Swan account. For each fee charged to the account, we create a transaction that is included in the monthly account statement. In addition to this, for company account holders, we also generate a dedicated invoice listing all banking fees that were charged during the monthly billing period. This invoice is generated at the same time as the account statement.
In the future, it will be possible to adjust the amount of each banking fee on a per-partner basis.
How does Account Holder Billing work?
Billing Activation
The billing module automatically starts when an account (company or individual) is created. For all existing accounts created, before March 2023, the billing module was activated on 1st March 2023.
The billing period starts on the first day of each month.
Usage Collection & Fees Deduction
Once a transaction associated with a banking fee is detected, in almost real-time, the banking fee is deducted from the account. For those transactions, we have a dedicated  Fees Payment Product and 2 types of transactions:
FeesOut: When a fee is debited from a Swan account and 
FeesIn: When a fee is credited to a Swan account.
Most banking fees are booked in real-time, but fees related to payment incidents (for example, direct debit rejections due to an insufficient balance) are, however, only deducted 14 days after being communicated. These fees transaction will also instantly appear but with the status upcoming. 14 days later they will be automatically booked. This is in line with our regulations. Learn more about the actual list of banking fees​
If there is an insufficient balance in the account to cover the banking fees, the account can become negative!
Invoice Generation
For individual account holders, the fees debited can be viewed directly in their accounts and are included in the standard monthly account statement. Once a year, the individual account holder will receive a yearly fees summary.
For company account holders, in addition to the fees appearing directly in the account and on the account statement, an invoice is also automatically generated on the first day of each month. The invoice is available via both API, dashboard, and web banking. The invoice includes all banking fees charged to the account for the last monthly billing period.
We send an event whenever a new invoice is generated and available for download, using the webhook: AccountInvoice.Generated.
We don’t generate an invoice If no banking fees were charged during the last monthly billing period.
It is possible to change the official language of an invoice (Learn more); changing the language will define the:
language of the label for each fees transaction
language of the invoice generated
Changing the value of the official document language will only affect new fees transactions and newly generated invoices. Existing fees and invoices will remain in the previously selected language.
We put the optional VAT number of the account holder known by Swan when we generate the invoice. To give us this VAT number you can use the following mutations:
onboardCompanyAccountHolder
updateCompanyOnboarding
updateAccountHolder
Company account holders can query the list of invoices associated with an account using the account or accounts queries.
Request
Response
query RetrieveInvoices {
  account(accountId: "{{YOUR_ACCOUNT_ID}}") {
    invoices(after: "", first: 10) {
      edges {
        node {
          closingDate
          createdAt
          expiresAt
  	  name
          id
          openingDate
          status
          updatedAt
          url
        }
      }
      pageInfo {
        hasNextPage
        hasPreviousPage
      }
      totalCount
    }
  }
}
{
  "data": {
    "account": {
      "invoices": {
        "edges": [
          {
            "node": {
              "closingDate": "2023-02-28T22:59:59.999Z",
              "createdAt": "2023-02-16T16:04:51.331Z",
              "expiresAt": "2023-02-17T16:08:32.832Z",
              "name": "INVOICE-20230228",
              "id": "dc43f0f6-7bae-4f05-8b35-82363a1a17cf",
              "openingDate": "2023-01-31T23:00:00.000Z",
              "status": "Paid",
              "updatedAt": "2023-02-16T16:04:52.582Z",
              "url": "{{INVOICE_URL}}"
            }
          },
          {
            "node": {
              "closingDate": "2023-02-28T22:59:59.999Z",
              "createdAt": "2023-02-16T16:02:55.416Z",
              "expiresAt": "2023-02-17T16:08:32.832Z",
              "name": "INVOICE-20230228",
              "id": "b9ccad06-417a-48e0-8a08-37fee4ea39a3",
              "openingDate": "2023-01-31T23:00:00.000Z",
              "status": "Voided",
              "updatedAt": "2023-02-16T16:04:50.888Z",
              "url": null
            }
          }
        ],
        "pageInfo": {
          "hasNextPage": false,
          "hasPreviousPage": true
        },
        "totalCount": 2
      }
    }
  }
}
​Try it now on the API Explorer​
Retrieve invoice details
You can also retrieve details about specific invoices with the API using invoiceId.
Request
Response
Add your invoiceId to line 2, then run the mutation.
1
query Invoice {
2
  accountInvoice(invoiceId: "$YOUR_INVOICE_ID") {
3
    amount {
4
      currency
5
      value
6
    }
7
    closingDate
8
    createdAt
9
    expiresAt
10
    id
11
    name
12
    openingDate
13
    status
14
    updatedAt
15
    url
16
  }
17
}
18
​
1
{
2
  "data": {
3
    "accountInvoice": {
4
      "amount": {
5
        "currency": "EUR",
6
        "value": "1"
7
      },
8
      "closingDate": "2023-02-28T22:59:59.999Z",
9
      "createdAt": "2023-02-17T08:18:09.415Z",
10
      "expiresAt": "2023-04-21T09:28:11.310Z",
11
      "id": "e910c799-e25a-4c8d-9469-4fa14016bc4c",
12
      "name": "INVOICE-20230228",
13
      "openingDate": "2023-01-31T23:00:00.000Z",
14
      "status": "Paid",
15
      "updatedAt": "2023-02-17T08:18:09.807Z",
16
      "url": "https://invoices.sandbox.swan.io/sample-invoice.pdf?Expires=1682069291310&Key-Pair-Id=K27GLF05V96LSD&Signature=svkxgaVz1L9vtfePPFuBp0b5mEYa0X9Ty~OC3QXEoqONu3d7~aCwNYouyeKtBdt-kyIdfWCeQj1uxwQyUqEfn4KmByrx1JTK3rIs05~bjcE9ADIhPn8tr~0bKFruWMZvXo62p1UyXj4Vcv0falWX-amSIr0UmmUfQrNTV44Ln2lRPj~Co~RCnmcQ-HU3-QRNw5QFDSkPtPCpBvh-BfP-F50Q054UWiuGfZ8sbdKZqIp0L7-EDwhH~SCqpTMH66YpQr5u0Ftcw4rbq09x0I6uphMFA1xoX45E1Pk-UDf~OhSIZ3DiCVH0tUp3PJZzBPUSK9gKayhh97JuyROgL4~hdw__"
17
    }
18
  }
19
}
Standard banking fees
Item
Price
Billed with VAT?
When is it booked?
Cash withdrawals at ATMs in France and the SEPA area
€1
❌
Immediately
Cash withdrawals at ATMs outside the SEPA area
2% of the amount withdrawn
❌
Immediately
Payment for goods and services in shops or remotely outside the SEPA area
2% of the amount paid
❌
Immediately
Fee for direct debit rejections due to an insufficient balance
€10 per rejected direct debit, up to the amount of the rejected direct debit
❌
14 days after
Improper use of the account (attempting or performing acts in violation of the law and/or this Account Agreement)
€150 excl. VAT
✅
Immediately
Processing of judicial or administrative seizures, notice to third party holders
10% of amount due limited to €20 per file
❌
14 days after
Drafting a circulation letter for a legal entity holder
€45 excl. VAT
✅
Immediately
Intervention fee for managing unauthorized overdrafts
€8 per transaction, up to a maximum of €80 per month
❌
14 days after
Funding an account by credit card
0.7% of the amount deposited + €0.1 excl. VAT
✅
N/A - Feature not supported at the moment
Generate some test invoices
You can simulate the generation of an invoice in the Testing API using simulateInvoiceGeneration:
Request
Response
mutation GenerateInvoice {
  simulateInvoiceGeneration(input: { accountId: "{{YOUR_ACCOUNT_ID}}"}) {
    __typename
    ... on SimulateInvoiceGenerationSuccessPayload {
      invoice {
        closingDate
        expiresAt
        createdAt
        id
	name
        openingDate
        status
        updatedAt
        url
      }
    }
    ... on AccountNotEligibleRejection {
      message
    }
    ... on AccountNotFoundRejection {
      id
      message
    }
  }
}
{
  "data": {
    "simulateInvoiceGeneration": {
      "__typename": "SimulateInvoiceGenerationSuccessPayload",
      "invoice": {
        "closingDate": "2023-02-28T22:59:59.999Z",
        "createdAt": "2023-02-16T16:04:51.331Z",
        "expiresAt": "2023-02-17T16:04:52.603Z",
        "id": "dc43f0f6-7bae-4f05-8b35-82363a1a17cf",
        "name": "INVOICE-20230228",
        "openingDate": "2023-01-31T23:00:00.000Z",
        "status": "Paid",
        "updatedAt": "2023-02-16T16:04:52.582Z",
        "url": "{{INVOICE_URL}}"
      }
    }
  }
}
​Try it now on the API Explorer​

Item	Price	Billed with VAT?	When is it booked?
Cash withdrawals at ATMs in France and the SEPA area	€1	❌	Immediately
Cash withdrawals at ATMs outside the SEPA area	2% of the amount withdrawn	❌	Immediately
Payment for goods and services in shops or remotely outside the SEPA area	2% of the amount paid	❌	Immediately
Fee for direct debit rejections due to an insufficient balance	€10 per rejected direct debit, up to the amount of the rejected direct debit	❌	14 days after
Improper use of the account (attempting or performing acts in violation of the law and/or this Account Agreement)	€150 excl. VAT	✅	Immediately
Processing of judicial or administrative seizures, notice to third party holders	10% of amount due limited to €20 per file	❌	14 days after
Drafting a circulation letter for a legal entity holder	€45 excl. VAT	✅	Immediately
Intervention fee for managing unauthorized overdrafts	€8 per transaction, up to a maximum of €80 per month	❌	14 days after
Funding an account by credit card	0.7% of the amount deposited + €0.1 excl. VAT	✅	N/A - Feature not supported at the moment

Last modified 1mo ago