Stripe Connector

General Company Information

Header

Find us at the Stripe partner directory

How does the connector work?

An overview of the Stripe-connector to use Accounting as a Service without additional integration requirements to provide orders, invoices and refunds.

The Accounting as a Service-Stripe-connector listens to the events taking place in Stripe. The following events are relevant for the accounting:

  1. invoice.finalized - This means that the invoice for the end-customer has been issued
  2. CreditNote.created - This means that a credit note, deriving from a return or a good will credit has been issued and paid out.

Accounting as a Service books your revenues and taxes based on this information. In addition to this, Accounting as a Service collects the settlement information directly from Stripe and books according to the provided information. Thereby Accounting as a Service knows which orders have been paid successfully and which payments failed or have been charged back. For the failed orders, Accounting as a Service can take over the dunning process and the transfer to collection as well as the handling of collection agency output. The payment of these orders usually arrive on your bank account. Accounting as a Service therefore also considers your bank account statements and books all incoming payments to make sure that only customers receive a dunning notification, if the order amount is still open.

Stripe-Connector

How do I connect Stripe to Accounting as a Service?

Accounting as a Service already has a connector to Stripe events. Therefore no additional implementation on your side is required. However, to use this connector, you need to

  1. Set up the Webhooks for Accounting as a Service in Stripe
  2. Allow Accounting as a Service to download settlement-Information (create a restricted API-key)

Set up a the Accounting as a Service webhooks in Stripe

For the webhook, you need to have the endpoint-URL and an API-key. The API-key needs to be generated within Accounting as a Service. For this, you need to get in touch with our IT-Teams (contact us) and we will generate the API-key and the final URLs for you.

The API-key can also be used to register to receive notifications directly from Accounting as a Service.

The following steps have to be completed for the testing and production environment The provided URL needs to be saved for the webhooks. For this go to "Developers" in the section "Webhooks" (Test / Production)

Stripe-Webhook1

  1. Copy the URL provided by the Accounting as a Service API-Team incl. the subscription key
  2. Enter a description that helps you to identify that the endpoint is set up for Accounting as a Service (e.g. Accounting as a Service invoices)
  3. Add the event (Invoices / invoice.finalized)

The final screen for invoices should look like this. If so, please add the endpoint:

Stripe-connector-Webhook3

The same has to be done for the second end-point (creditNotes). Please use the second URL (including subscription key) that allows to send refunds and select the event creditNote.created. The final screen for refunds/creditNotes should look like this.

Stripe-connector-Webhook4

Create a restricted API-keys

You need to generate two restricted API-keys for us, to allow us to receive your settlement and tax information: For this, go to "Developers" and select "API keys".

Stripe-connector-API_Key1

On the page, you can generate a new restricted key. For this, please select the following rights to "read":

  • Events and Webhook Endpoints for the provision of data for accounting
  • Balance and Balance trancaction sources for the settlement process

Stripe-connector-API_Key2

After clicking "create key", the generated key will be displayed.

Stripe-connector-API_Key3

Please provide this key to the Accounting as a Service team.

A second restricted API key named "Tax_key" needs to be set up to retrieve the Tax information. For this please go throught the same process and select the following rights to "read":

  • All Billing resources - Tax Rates to allow Accounting as a Service to retrieve the tax information for each line item in your invoice

Stripe-connector-API_Key_Tax

The rest of the work takes place within and by the Accounting as a Service Teams.

What do I need to do, if I have multiple legal entities to report in?

If you have multiple legal entities and you need to have separate month-end reports, you need to have the data separated in Stripe already as well. Stripe supports this with creating different accounts/stores. The previously described process needs to be performed for each Account. Please provide the information, which Stores/Accounts are set up in Stripe, so that we can generate a subscription key and URL for each Store/Account. The following information is required:

  • Name of the store/legal entity
  • Country of the legal entity
  • Currency of the store

Please note: if you want to extend your business to new country-stores / legal entities, Accounting as a Service needs to be set up in the same way. Therefore please contact us, so that we can set you up and generate a subscription key and URL for the new business.

Which information is required to get set up in Accounting as a Service?

The following information will have to be provided by you so that we can set you up in Accounting as a Service:

  • Contact details - so that we can send the details to you
  • Contract details - so that we can set up a contract which has to be signed before we start
  • Onboarding information - please find more information here

In addition to the connector and the settlement information, Accounting as a Service needs to get access to your bank account so that incoming payments from Stripe and payments transfered by end-customers in the dunning process can be booked. For this we need to get EBICs-users/credentials (for more informatino click here)

What else has to be done?

  1. The Accounting as a Service Team has to set up the system for you as a client. This is done with the provided data.
  2. You have to sign the contract that we will provide to you Afterwards you have to register to receive the notifications
  3. In case you want to use PayPal as a payment method in Stripe, the settlement-file will not be provided by Stripe but has to be provided by PayPal. For this we need PayPal to upload the settlement-file (STL-File) to the Accounting as a Service sFTP Server on a daily basis. The credentials and folder-link will be provided by us.

How do I receive my month-end report for the general ledger?

To receive the month end reporting for your general ledger, you have to register to receive the month-end notification Alternatively you can receive the month-end reporting via Email (Format: CSV or XML). Please inform us if you wish to receive the month-end reporting via email and to which recipients.

Scope of setup

The following scope is included in the standard setup. If you need any additional services (e.g. Collection, additional business codes, payment methods or an adaptation of the dunning process), you can contact us during or after the initial setup and we will help you will setting up these additional requirements.

  • Country of origin (of company): DE-EUR, CH-CHF, AT-EUR, NL-EUR, PL-PLN
  • Payment setup:
    • Capture in Stripe
    • Refund in Stripe
    • Invoice document creation in Stripe
    • Payment Methods:
      • Credit Card (Visa, MasterCard, American Express, Diners, Discover)
      • PayPal
      • Apple Pay (will be handled like a credit card)
      • Google Pay (will be handled like a credit card)
      • Direct Debit (collected by Stripe)
      • Bank transfer (collected by Stripe)
      • Open Invoice (collected by Stripe)
      • Bancontact (for Belgium)
      • EPS (for Austria)
      • Giropay (for Germany)
      • iDEAL (for Netherlands)
      • P24 (for Poland)
      • SOFORT (for Germany and Austria)
      • Klarna (open invoice, instalments, direct debit)
    • Bank statement (via Camt)
    • Standard Dunning process - configurations can be changed afterwards
    • Month end report via notification or via Email