Four resources. One status model.

curl https://api.locals.money/v1/customers \
  -H "Authorization: Bearer $LOCALS_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{ "type": "business", "name": "Harbour & Co" }'

# 201 Created
{ "id": "cus_8Hq2Lm", "verification": { "status": "in_progress" } }

curl https://api.locals.money/v1/routes \
  -H "Authorization: Bearer $LOCALS_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{ "customerId": "cus_8Hq2Lm",
        "source": { "currency": "AUD" },
        "destination": { "currency": "USDC", "chain": "polygon" } }'

# 201 Created: show depositInstructions to your customer
{ "id": "route_3f9a", "status": "pending", "depositInstructions": { … } }

curl https://api.locals.money/v1/test/routes/route_3f9a/simulate \
  -H "Authorization: Bearer $LOCALS_KEY" \
  -d '{ "amount": "12500.00", "currency": "AUD" }'

# Then, on your webhook endpoint:
route.deposit.received  A$12,500.00
transfer.processing     trf_91kd
transfer.completed      8,137.50 USDC

app.post('/hooks', express.raw({ type: '*/*' }), async (req, res) => {
  if (!verify(req.body, req.get('Locals-Signature'), SECRET)) return res.sendStatus(400);
  const event = JSON.parse(req.body);
  // Retries reuse the same id: processing twice is safe
  if (await seen(event.id)) return res.sendStatus(200);
  await ledger.apply(event);
  res.sendStatus(200);
});

# .env
- LOCALS_KEY="<your sandbox key>"
+ LOCALS_KEY="<your live key>"

# Same endpoints, same payloads, real rails
curl https://api.locals.money/v1/routes/route_3f9a \
  -H "Authorization: Bearer $LOCALS_KEY"