Partner commission invoices

Who is this article for?

This article will be useful to you if are a company on PartnerStack looking for more information on the partner invoice review process.

What are partner commission invoices?

The partner commission invoice is generated on the last day of each month (or the first day of the following month, based on your timezone) and contains all the commissions earned by your partner during the previous month.

This invoice is sent to the main program owner on file by email with a breakdown of all referral commissions earned by your partners and can also be found in your Commissions & Invoices tab. 

All “new”, “pending” and “approved” commissions are automatically pulled onto your invoice. Commissions that are “held” either due to a partner’s account being flagged as potentially fraudulent, or commissions put on hold by your team, are not pulled onto invoices.

For a video walkthrough of editing invoices, see the Company dashboard: Video walkthroughs.

Invoice schedule overview

You’ll have 7 full days to review the invoice before it is auto-charged and payouts are released to your partners.  Any issues with commissions can be adjusted during this time. 

Invoices are automatically processed at the end of the day 7th of each month (or the morning of the 8th depending on your timezone) unless you have paused your invoice.

If your invoice is paid with a credit card, commissions will be released to partners once the charge has been successfully processed, in most cases this is the same day. If your invoice is paid via ACH, commissions are released to partners once the charge has been successfully processed between Stripe and your bank which takes an average of 5 days.

Example:

  • May 1 to May 31: Commissions are generated by partner activity
  • June 1: A commission invoice is generated for you to review for all commissions created in May
  • June 1 to June 7: You have 7 days to review the invoice, and make any necessary changes
  • June 7 EOD: The invoice is charged to the card or ACH on file
  • Commissions are released to partners once the payment has been processed. ACH payment can take an average of 5 days to process. 
    • Evening of June 7th: If the invoice is paid by credit card, commissions are available for partners to withdraw
    • June 13th:  If the invoice is paid by ACH, commissions are available for partners to withdraw

Viewing your invoice

The partner commission invoice is sent by email to the main account owner on file and is visible in your Commissions & Invoices tab for any teammates with Billing permissions.

To view a month’s invoice:

  1. Log into your PartnerStack dashboard here
  2. Navigate to your Commissions & Invoices tab
  3. Click “View Invoice” next to your desired invoice
  4. To download a CSV of all commission lines on this invoice, click “Download CSV”
  5. To view a PDF of the invoice, click “View printable invoice”
    • To download this invoice, right-click on the invoice, select “Print” and choose “Print to PDF” as the destination

Invoice CSV data

  • Date: The date the commission was created
  • Type: The line type on the invoice
  • Commission key: Unique identifier for the commission
  • Description: The commission description
  • Commission target key: The key for the commission source, i.e. customer key if the commission is for a customer, transaction key if the commission is for a transaction
  • Partner details: Partner name, Partner email, Partner key, Partner Country
  • Partner Source: How the partner joined your program (invite, application, marketplace)
  • Group: The partner’s current group
  • Customer details: Customer Name, Customer Email, Customer Key, Customer Country
  • Transaction details: Transaction key, Purchase Amount
  • Product key: The product key associated with the transaction if applicable
  • Amount: The commission amount
  • Fee % applied: The Partnerstack Processing fee applied to the commission
  • Fee amount applied: The total amount of the fee
  • Total owed: The commission amount plus the fee amount

Creating an invoice

Invoices can be manually generated to manage your transactions.

  1. Navigate to your Commissions & Invoices tab.

  2. Click the "Create new invoice" button.

  3. On the next screen, you will select the Invoice Currency and the Type of Invoice to create:

    • Blank Invoice: Creates an empty invoice. Commissions can be added to this invoice later.

    • Invoice with available commissions: Automatically generates an invoice that includes all commissions currently eligible for invoicing.

  4. Timeframe: Select the specific billing period (time range) this new invoice will cover.

  5. Click "Create invoice"

Note: If your company is on manual billing and a new invoice is created, you must contact your Customer Success Manager (CSM) to request that the invoice be charged.

Adding commissions to an invoice

Commissions can be manually added to a pending invoice in one of three ways; creating a new commission directly on the invoice, pulling an existing commission onto the invoice, and importing commissions directly to the invoice.

Creating an individual commission on an invoice

  1. In your Commissions & Invoices tab, click on your current invoice
  2. Click “Add Commissions”
  3. In the drawer view that opens, select “Create a single commission”
  4. Enter the commission description, select the partner the commission is for, and enter the commission amount, and currency
  5. Optional: Click “Connect this commission to a customer” to tie the commission to a specific partner
    • This can make it easier to reconcile commissions and customers!
  6. Click “Create commission”

Pulling existing commissions onto an invoice

  1. In your Commissions & Invoices tab click on your current invoice
  2. Click “Add Commissions”
  3. In the drawer view that opens, select “Move commissions to invoice”
  4. Select the commissions you would like moved to the current invoice
  5. Click “Move commissions to this invoice”

Importing commissions onto an invoice

  1. In your Commissions & Invoices tab click on your current invoice
  2. Click “Add Commissions”
  3. In the drawer view that opens, select “Import commissions”
  4. You will be redirected to your Settings > Data Importer > Commissions import view
  5. Drag and drop your commissions import CSV 
  6. Ensure that “Attach commissions to current invoice” remains checked and click “Import data”

Not sure how to build out a commissions import CSV? Check out our Best practices for importing data into your program for more information. Please note, that only “pending” and “approved” commission statuses can be imported directly to an invoice.

Removing and deleting commissions from an invoice

You may need to remove commissions from an invoice for several reasons: either the commissions should not be paid out at all, or they need to be paid out at a later date, following further qualification or review.

To remove a commission from a pending invoice:

  1. In your Commissions & Invoices tab click on your current invoice
  2. Select the commission(s) you would like to remove
  3. Click “Actions”
  4. Select “Remove from this invoice” to remove the commission from the current invoice, but to have it paid out on the next invoice
    • Provide a reason for removal and click “Remove commissions”
  5. Select “Permanently delete” if the commission should not be paid out in the future
    • Provide a reason for deleting and click “Delete commissions”

Removed commissions will be moved to your “Removed commissions” invoice tab and will be automatically pulled onto your next invoice.

remove.png

Removed commissions history

In your invoice, you will see a Commissions tab for the commissions currently on your invoice and a Removed commissions tab. Removed commissions contains commissions you have manually postponed (removed from the current invoice). These commissions are not permanently deleted and are typically held here when they require further investigation before payout.

Any commissions placed in the Removed Commissions tab will be automatically re-invoiced for inclusion in your next monthly invoice.

To move a removed commissions back to an invoice:

  1. In your Commissions & Invoices tab, click on your current invoice
  2. Select the Removed commissions tab
  3. After confirming the commission(s) should be paid out, select the commission(s) you wish to move
  4. Click “Actions” and select “Add Commissions back to invoice”
  5. Confirm the action by selecting “Move to {month} invoice”

Commissions that are added back to an invoice can be removed once again while the invoice is pending.

Reviewing flagged commissions

Before your invoice is generated, any partners flagged in your Fraud Management tab as potentially fraudulent will have their commissions automatically placed on "hold" for your review. Any commissions on "hold" will not be automatically pulled onto your invoice when it is generated.

If a partner is flagged as potentially fraudulent after your invoice has been generated, their commissions will be flagged on your invoice with a red flag, and a risk level. 

If any commissions on your invoice are flagged due to the partner being flagged as potentially fraudulent you will see a banner at the top of your invoice indicating the number of commissions flagged, the total value of flagged commissions, and the number of flagged partners. Click "View commissions" in this banner to filter your invoice and view only the flagged commissions. 

As a best practice, we recommend reviewing your invoice’s flagged commissions before your invoice charge date. If you see flagged commissions, review the partner’s fraud flag in your Fraud Management tab, and the partner/customer’s activity in your internal systems to determine if the commission is legitimate and should be paid out. If the commission should not be paid out, remove it from your invoice, and remove the partner from your program.

Searching an invoice

In an invoice’s Commissions and Removed commissions tabs, you can search for specific commissions, partners, customers, or transactions using the search bar.

The search bar can also be filtered by partner, group, customer, commission status, date, description, and decline reason by clicking on “+ Add filter”.

Viewing invoice activity

Your invoice activity log allows you to see exactly when commissions were added, if an invoice was paused, and when payouts became available for partners to withdraw.

Whenever you modify commissions on your invoice, the activity log captures the history of changes made to the invoice.

Invoice activity.png

You can access the invoice activity log by clicking on “Invoice activity” in the top right-hand corner of the invoice.

All modifications to your invoice are captured, including:

  • Date of change
  • Modification type (add/move/delete/remove)
    • Add = adding a new commission directly on the invoice
    • Move = moving an existing commission to the invoice
    • Delete = permanently deleting a commission
    • Remove = removing a commission from the current invoice to payout on the next invoice
  • Number of commission items impacted
  • The user who took the action

Pausing an invoice

You can pause the invoice if you require additional time to review or correct any discrepancies before the scheduled date when the invoice would be automatically charged.

  1. In your Commissions & Invoices tab click on your current invoice
  2. Click “Pause invoice”

When pausing an invoice, proactive communication with your partners is essential to manage expectations and maintain trust regarding their commission payments.

We recommend sending an email campaign that assures partners the current invoice requires additional attention and review. 

pause.png

  • If you unpause an invoice before the automatic charge date, the invoice will charge on the invoice charge date as expected.
  • If you unpause an invoice after the automatic charge date, the invoice will charge right away. If you would like to update your payment method before unpausing an invoice, this can be done from your Settings > Billings tab.

Charging an invoice

After your invoice is generated and you have finalized your review, you have the option to charge the invoice ahead of the scheduled date.

To manually charge your partner invoice:

  1. In your Commissions & Invoices tab, select your current invoice
  2. Click “Pay invoice now”

This will charge your invoice using your default payment method on file.

If you need to update your payment method, see the Adding and updating your billing information support guide.

Managing your invoices

These practices could help streamline your monthly workflow, reduce manual intervention, and foster trust with your partners.

Streamline Monthly Review. Review your commissions throughout the month in the Commissions & Invoices > Review Commissions tab. Proactively approving or declining commissions reduces the volume of commissions you must review between the 1st and 7th of each month.

Maintain Partner Trust. If you must pause an invoice, proactively communicate any changes or delays to your partners and keep them updated. Routinely delaying invoices can erode partner trust. We strongly recommend adhering to the regular payment schedule as often as possible to ensure reliable expectations and strengthen partner relationships.

Manage Fraud Flags. Regularly review your Fraud Management tab for partners with held commissions. When reviewing a partner's Fraud flag, compare the data in the Fraud Management tab with your internal systems for signs of fraud to determine if you should remove the partner or mark them as trustworthy.

  • If you mark a partner as trustworthy before the end of the month, their held commissions will return to "Pending" status and be automatically pulled onto the next invoice.
  • If you mark a partner as trustworthy between the 1st and 7th, you must manually move the commissions to the current invoice if you want them paid out in the current cycle.

Provide Decline Transparency. Always provide specific commission decline reasons to your partners. This prevents partners from submitting support requests due to confusion and helps them understand exactly where to focus their efforts for successful commissions in the future.