Skip to main content
Anrok is a tax compliance platform. Metronome integrates with Anrok through Stripe—Anrok operates as a Stripe Tax provider through the Anrok Stripe app. The key difference is that Anrok handles the tax calculation and compliance rather than Stripe’s native engine.

​
Prerequisites

  1. Install the Anrok app in your Stripe dashboard from the Stripe App Marketplace.
  2. Configure Anrok to connect to your Stripe account. Follow Anrok’s setup instructions at anrok.com/integrations/stripe. In the Stripe Dashboard, go to Settings > Tax > Integrations and confirm Anrok is selected as your tax calculation provider and that “Use automatic tax” is toggled ON. See Stripe’s third-party tax apps guide for details.
    1. Complete tax registration in the applicable jurisdictions for sales tax, VAT, and GST.
  3. Connect your Stripe account to Metronome.
  4. Link each Metronome customer to their Stripe customer ID.
  5. Ensure each Stripe customer has a Customer Address set and is marked as Taxable.
The Customer Address field is the address object on the Stripe Customer object, which determines tax jurisdiction. Failure to assign a Customer Address results in failure to apply tax.

​
Step 1: Create Stripe products

Anrok uses the Stripe product on each invoice line item to determine tax treatment. Create Stripe products and assign appropriate tax codes. If a Stripe product doesn’t have a tax code assigned, Anrok falls back to a default product classification. However, it’s recommended to explicitly assign tax codes for accuracy.

​
Step 2: Create the Stripe Product ID custom field in Metronome

  1. Create a stripe_product_id custom field on the Product entity in Metronome.
  2. For each Metronome product, set the stripe_product_id value to the corresponding Stripe product ID.
See Stripe Tax Step 2 for detailed instructions.

​
Step 3: Configure entity mapping

Configure the entity mapping in Metronome to pass the product ID to Stripe:
  1. Go to Connections > Integrations > Stripe > Edit Mapping.
  2. Add the following mapping:
Stripe vendor entityStripe vendor keyMetronome entityMetronome key
invoiceitem.priceproductContractProductstripe_product_id
  1. Click Save.

​
Step 4: Configure invoice settings

For arrears invoices (end-of-period usage invoices): Anrok calculates tax inline through the Stripe app. You don’t need “Leave invoices as drafts” enabled for this flow. For threshold billing (prepaid balance recharges, spend thresholds): Set tax_type: "STRIPE" and payment_type: "INVOICE" in the payment_gate_config. See the Stripe Tax threshold billing docs for the exact API payload.

​
Test your configuration

  1. Use your Metronome sandbox (connected to Stripe test mode) to test.
  2. Create a customer with a valid Stripe customer ID and Customer Address.
  3. Generate an invoice and verify in Stripe that Anrok has applied tax.
  4. Confirm the tax line items appear on the finalized Stripe invoice.

​
FAQ and troubleshooting

Q: My invoices are failing or are finalizing without tax — what should I check? The most common causes are a missing Customer Address on the Stripe customer or an incomplete entity mapping in Metronome. Start by confirming that the Stripe customer has sufficient location information to accurately calculate tax rates for the customer. Next, check if the entity mapping is complete in Metronome. If both are verified and tax still isn’t being applied, contact your Metronome representative to check your account configuration. Q: Can I use Anrok for compliance and Stripe Tax for calculation? Yes. Many customers use Stripe Tax for the actual tax calculation and Anrok for tax compliance, filing, and reporting. In this case, follow the Stripe Tax setup guide—Anrok automatically picks up the transaction data from Stripe for compliance purposes. Q: How do I verify Anrok is working? After generating and finalizing an invoice, check the Stripe invoice object. You should see: 
{
  "automatic_tax": {
    "enabled": true,
    "provider": "anrok",
    "disabled_reason": null,
    "liability": {
      "type": "self"
    },
    "status": "complete"
  }
}
If you see "enabled": false or "provider": null, the integration isn’t active. Verify the Anrok app is installed in Stripe. Otherwise, reach out to your Metronome representative for tax automation.