What this app does for you
- Fills in custom fields on your invoices automatically.
- Saves you manual copy/paste between metadata and invoice headers.
- Keeps Payment Links in sync with your field mapping rules.
- Shows sync status and field previews directly on invoice detail pages.
Start in 3 quick steps
1. Subscribe and enable
In Stripe, open the app and go to Billing:- Click Start subscription (14-day free trial).
- Complete checkout.
- Go to Configuration and toggle Enable app.
2. Configure field mappings
Go to Configuration:- Add up to 4 field mapping rules.
- For each rule, set the invoice label, source key, and optional static fallback.
- Click Save.
| Invoice label | Source key | Static fallback |
|---|---|---|
| PO Number | po_number | |
| Project | project_code | |
| Customer No. | customer_number | |
| Cost Center | cost_center | Default |
3. Add metadata to your invoices or customers
Set metadata keys on your Stripe customers or invoices that match your configured source keys. For example, addpo_number as a metadata key on a customer. When an invoice is created for that customer, the PO number is automatically filled in.
Daily usage
Automatic mode (recommended)
Once configured, draft invoices are synced automatically when created or updated.Manual mode (backup option)
On an invoice page in Stripe:- Open the Invoice Custom Fields app panel.
- Click Sync now.
How to read statuses
- Pass: all required fields are filled.
- Warning: some fields are missing but not required.
- Fail: required fields are missing.
Good first-week checklist
- Test in sandbox with 2-3 invoices.
- Confirm custom fields appear on the invoice header.
- Go live and enable auto-sync.
- Add metadata to customers as needed.