From 32e744d9ee2a05cff8b8aad20a6da61670aef71f Mon Sep 17 00:00:00 2001 From: Inferencebot Date: Fri, 13 Nov 2026 20:05:23 +0000 Subject: [PATCH] README: document the webhook error net, the OC timeouts, and the missing reconciliation --- README.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) 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.