Automate Recharge work with your agents
Maplith maps how Recharge’s subscriptions, customers, charges and orders join your web shop, payments and CRM, so your agent knows where each thing is and how far to trust each join.
| Way | Status | What it means |
|---|---|---|
| Export files | Available | CSV exports: processed charges and orders for the last three months; all subscriptions and customers. The path to start with. |
What your agents do with Recharge and Maplith
What starts the work, what your agent does with Maplith, and how it ends. Each flow uses the Recharge data and joins described below.
A subscriber charged with no order to ship
Trigger: A subscriber was charged in Recharge, and no matching order shows up in Shopify to ship.
With Maplith:
- Findings: Where the last scan of the exports saw processed charges with no Shopify order, a finding names them, with its evidence and a recommendation.
- Route:
routefrom the Recharge charge to the Shopify order by the Shopify order id the charge carries, with how much Maplith trusts that hop. - The map:
get_objecton the charges says a charge carries a status, and that the order Recharge sends to the shop comes from a processed one. The agent looks for the order in Shopify with its own read access. - The action gate:
request_actionfor a task for whoever runs fulfilment, with what the finding names and what the agent found in Shopify. - Record and value:
record_actionrecords the task, and whether the order was sent after all.
Result: A charge with nothing to ship reaches the person who runs fulfilment as one task, with the ids to look up.
Subscriptions that renew on a retired variant
Trigger: A product variant is taken out of the Shopify catalogue, and subscriptions in Recharge may still renew on it.
With Maplith:
- Ask:
ask: “how do Recharge subscriptions tie to Shopify’s products?” The answer cites the join on the Shopify variant id, and says where a SKU override can stand in for it. - Route:
routefrom the Shopify variant to the Recharge subscriptions that carry its variant id. - The map:
get_objecton the subscriptions says which fields hold the Shopify variant id and the next charge date, so the ones on a variant can be found in Recharge by that id. - The action gate:
request_actionfor a task for the person who manages subscriptions: the retired variant, its Shopify variant id, and the fields to find its subscriptions by in Recharge. - Record and value:
record_actionrecords that the task went out, and how it ended.
Result: The person who manages subscriptions knows which variant id to look for in Recharge before the next renewal runs.
Recharge charges and payments that do not pair up
Trigger: At month-end, the subscription charges in Recharge and the payments at your payment provider do not agree.
With Maplith:
- Findings: Where the last scan of the exports found charges and payments that do not pair up, a finding with its evidence and a recommendation.
- Route:
routefrom a Recharge charge to the charge at Stripe, Braintree or another payment provider, by the transaction id the charge carries. - The map:
get_objecton the charges says a charge carries a status, so a queued or skipped charge is not compared with a payment. The agent reads the payments the finding names in Stripe with its own read access. - The action gate:
request_actionfor a task for the bookkeeper with the finding, the payments the agent found, and the transaction ids to check in Recharge. - Record and value:
record_actionrecords that the task went to the bookkeeper, and what was left open.
Result: The bookkeeper sees which charges and payments do not pair up, by transaction id.
How it connects
Read-only, through access you already have. Maplith holds no Recharge credential.
- Export from Recharge: CSV, processed charges and orders for the last three months; all subscriptions and customers. The guide has the steps.
- Upload the files in your workspace, or let your assistant send them to Maplith over MCP.
- Maplith builds the map and deletes the files again.
What Maplith never reads or does
- Recharge itself: Maplith holds no Recharge credential and never signs in to it.
- Anything that changes Recharge: Maplith never writes there.
- What you leave out: you decide what an export contains.
Datasets that make a good map
Subscriptions
One subscription: the product variant, quantity, schedule, status and next charge date.
- subscription id
- Recharge customer id
- address id
- external product id (Shopify product id)
- external variant id (Shopify variant id)
- SKU override
- status
- next charge date
Customers
One subscriber with active subscription count, total orders and payment method status.
- Recharge customer id
- external customer id (Shopify customer id)
- customer email (Maplith tries to mask it)
- number of active subscriptions
Charges
One scheduled or processed charge with its line items and status (queued, skipped, error, processed).
- charge id
- Recharge customer id
- external order id (Shopify order id)
- payment processor transaction id
- line item SKU
- status
- scheduled date
Orders
One processed order that a charge created and sent to the shop.
- Recharge order id
- charge id
- external order id (Shopify order id)
- Recharge customer id
- processed date
The narrowest access Recharge offers for reading
- read_subscriptions
- read_customers
- read_orders
- read_products
- read_plans
- read_store