Import sales from Stripe, Square, Paddle, the App Store and Google Play, and bills from AWS

Connect a sales platform and SparkReceipt books each month's sales as Income with the platform's fees as an Expense. Connect AWS and each bill arrives as an Expense with its PDF.

ST
Written by SparkReceipt TeamUpdated Nov 18, 2026

What gets imported

SparkReceipt can read your sales from the platforms you sell through and the bills from online services you pay. Both are set up on the Integrations page, in two groups:

  • Sales platforms: Stripe, Square, Paddle, the App Store and Google Play.
  • Bills from online services: AWS.

For a sales platform, SparkReceipt books each month's sales as Income and the platform's fees (or Apple's commission) as an Expense, with the platform as the Merchant. You get one Income per platform, month and currency, dated in the month the sales were made. The payout the platform sends to your bank settles that month's sales, so it isn't added as Income a second time.

A payout you scan, email in, or turn into Income from its bank transaction with Create income moves to Other document when SparkReceipt matches it to the imported payout or sales month. It stays Income if its date falls in a closed accounting period or it's already published to your accounting software.

Square brings in the sales tax or VAT you set up in Square. Each invoice you send with Square Invoices is added as its own Income, and its payments aren't counted again in the monthly sales.

For AWS, SparkReceipt fetches your bills and adds each one as an Expense with its PDF.

When you connect, you choose the first month to import, up to 24 months back.

Who can connect

You need to be an admin or an accountant on the account. Those are the roles that see the Integrations entry in the left-hand sidebar of the SparkReceipt web app.

Connect a platform

  1. Open Integrations in the left-hand sidebar.
  2. Find the platform under Sales platforms or Bills from online services and click Connect.
  3. Follow the steps in the window named after the platform, for example Connect Stripe. Depending on the platform, you paste a key you create in the platform, fill in a few fields, or click Continue to and the platform's name (for example Continue to Square) and sign in there.
  4. Under Import from, choose the first month SparkReceipt imports.
  5. Click Connect. SparkReceipt checks the credentials with the platform, and you see a message such as "Stripe connected. The first import has started."

The steps for each platform are below.

Stripe

  1. In the Stripe Dashboard, go to Developers, then API keys, and click Create restricted key.
  2. Give the key a name you'll recognise, such as SparkReceipt.
  3. Under Reporting, set Financial Reports to Write. Under Core, set Files, Payouts and Balance to Read. Leave everything else at None. Stripe needs write access to create a report.
  4. Create the key, copy it and paste it into SparkReceipt. It starts with rk_live_. A secret key doesn't work here.

Square

  1. Click Continue to Square and sign in to the business you sell with.
  2. Allow SparkReceipt to read your payments, orders, invoices and payouts. Square sends you back to SparkReceipt when you're done.

Paddle

  1. In Paddle, go to Settings, then Authentication, and open the API keys tab.
  2. Click New API key and name it, for example SparkReceipt.
  3. Under permissions, select Reports with write access and nothing else. Paddle needs write access to create a report, and the key can't touch anything outside reports.
  4. Paddle keys expire. Pick the latest expiry date Paddle allows.
  5. Save, copy the key and paste it into SparkReceipt. Paddle shows it only once.

You can enter the key's expiry date in SparkReceipt. If you do, SparkReceipt emails you before the key runs out, and you paste a new one with Replace key.

App Store

  1. In App Store Connect, go to Users and Access, then Integrations, and open Team Keys under App Store Connect API.
  2. Generate a key, name it SparkReceipt and give it the Finance role.
  3. Download the key file (.p8). Apple lets you download it only once.
  4. Copy the Issuer ID shown above the keys and the Key ID of the new key.
  5. Copy your vendor number from Payments and Financial Reports. It's at the top left of the page.
  6. In SparkReceipt, fill in the Issuer ID, Key ID, the .p8 key file and the vendor number.

SparkReceipt also asks for Apple's commission (%). Apple's reports don't show the commission, so SparkReceipt works out your sales from your proceeds at this rate. Use 15 if you're in the App Store Small Business Program.

Google Play

  1. In Google Cloud, create a service account in any project and add a JSON key to it. The key file downloads to your computer.
  2. In Play Console, go to Manage account, then Users and permissions, and invite the service account's email address. On the Account permissions tab, tick View financial data, orders, and cancellation survey responses.
  3. In Play Console, go to Manage account, then Play apps reports, then Financial. Next to Earnings reports, click Copy Cloud Storage URI. It starts with gs://pubsite_prod_.
  4. In SparkReceipt, paste the Cloud Storage URI and choose the service account key file.

A new Play Console permission can take about a day to reach the earnings reports. If SparkReceipt says the key can't read them yet and you invited the service account recently, try again the next day.

AWS

  1. Sign in to the AWS account that pays your bills (your management account), open IAM, then Roles, and click Create role. Choose Custom trust policy.
  2. In the trust policy, let the Trusted principal shown in the SparkReceipt window assume the role, with an sts:ExternalId condition set to the External ID shown there. Use the copy buttons in the window.
  3. Give the role invoicing:ListInvoiceSummaries and invoicing:GetInvoicePDF, and no other permissions.
  4. Create the role, copy its ARN and paste it into SparkReceipt as Role ARN. It starts with arn:aws:iam::.

SparkReceipt refuses a role whose trust policy doesn't require the External ID, because another AWS account could then use it.

Choose Categories for sales and fees

Each month's import puts the sales and the fees in Categories you choose. After you connect a sales platform, SparkReceipt suggests a Category for sales and a Category for fees. Change them if you like and click Save Categories.

If none of your Categories is for payment processing fees yet, SparkReceipt offers to create one, or you can pick one of your own. If you skip this step with Not now, the platform's card on the Integrations page reminds you with Choose Categories until you save them.

Tax on App Store sales where Apple sells as your agent

In most countries Apple buys your apps from you and sells them on. In the US, Canada, Australia, New Zealand, Japan, and Latin America and the Caribbean, Apple sells to your customers as your agent instead, so these sales need a tax rate of their own.

For an account in the EU, SparkReceipt books these sales at the tax rate you picked on one of their lines on your App Store Income (the lines named Sales (Apple as agent)). It takes the rate from the most recent month where you picked one, the same month or an earlier one, so picking again on an older month changes nothing while a newer month has a pick. A rate you pick in a later month never changes an earlier month, which may already be on a VAT return you filed. Only rates for a sale outside the EU count:

  • a 0 % rate with the tax treatment Zero-rated
  • a Procountor tax code with the VAT status for sales outside the EU

Apple's agent companies and the customers they sell to are all outside the EU, so these are sales outside the EU. A rate with the tax treatment EU services (box 312 in Finland) stays on the line you picked it on and isn't used for later months.

Until you pick one, the sales are booked at your tax rate for a sale outside the EU. In Finland that's box 309 of the VAT return. The daily import books the current month and the three before it this way. An older month that was imported without a rate keeps none, so pick the rate on its lines yourself.

Apple's fees on these sales get no tax rate: pick one on each document. An account outside the EU gets no tax rate on these sales either, and neither do App Store sales set to No tax rate.

To see how your App Store sales and fees are booked, open Settings in the web app, go to Tax rates and find Sales through app stores and resellers. Admins and Accountants see this section once the App Store is connected. Only owners and admins can change it.

When a connection needs attention

The platform's card shows Needs attention when the platform stops accepting the connection, for example when a key expires or is revoked, or a permission is missing. The card says what went wrong. Click Replace key, Replace credentials or Sign in again and connect with new credentials. The documents already imported stay as they are.

Disconnect a platform

Click Disconnect on the platform's card. SparkReceipt deletes the credentials and stops importing from that platform. Documents already imported stay as they are.