diff --git a/README.md b/README.md index 8d08041..ccae467 100644 --- a/README.md +++ b/README.md @@ -30,7 +30,18 @@ LibreChat ──→ Member Portal ──→ LiteLLM ──→ backend ## The three responsibilities 1. **Webhook handler** (`POST /webhook/opencollective`) — listens for Open - Collective membership events and activates/deactivates members. + Collective membership events and activates/deactivates members. The same + endpoint carries credit-pack purchases, so a failure here can cost a member + money: it answers **503** (retryable) with an ERROR line naming the exception + when anything unexpected escapes, and **401** when the URL token is wrong — + that status means the webhook URL and `WEBHOOK_TOKEN` disagree, so it is + never swallowed by the error net. Any OC read it makes has an explicit + timeout and one retry (`_oc_graphql_post`); until 2026-11-13 + `fetch_all_member_nodes` used httpx's 5-second default and a slow page became + an unhandled 500 on a paid purchase. The durable backstop — reconciling PAID + credit packs against `credit_ledger` on a schedule — is not built yet; see + the app repo's issue *"Backstop: reconcile PAID credit packs against the + ledger"*. 2. **Key injector** (`/v1/*`) — reads the member's email from the `X-User-Email` header, looks up their LiteLLM key, and forwards the request to the gateway with that key.