Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.myproceeds.xyz/llms.txt

Use this file to discover all available pages before exploring further.

Most upstream APIs require credentials. Proceeds attaches those credentials to the proxied request on the server side, so your end users only see the Proceeds URL — never your bearer token, API key, or secret.

Pick an auth method

Configure auth at the service level. Every paywall in the service inherits it.
MethodWhen to use
noneThe upstream is fully public.
bearerThe upstream expects Authorization: Bearer <token>.
tokenThe upstream expects a static token in a header.
x-api-keyThe upstream expects X-API-Key: <key>.
custom-headerAny other header pair. You provide the header name and value.
query-paramThe upstream reads the credential from the query string.
bearer-customerBearer token plus a customer ID.
x-api-key-secretTwo-part API key + secret pair.
json-body-fieldThe upstream reads the credential from a JSON body field.

What Proceeds collects

Depending on the method, Proceeds collects values such as:
  • Bearer token
  • Token
  • API key
  • Header name and header value
  • Parameter name and parameter value
  • Customer ID
  • API secret
  • Field name and field value
These are stored encrypted at rest and only ever sent to the upstream Target URL — never returned to clients.

Change credentials

Editing auth on a service rotates the credentials Proceeds sends upstream on the next request. There’s no client-side change required.
Always rotate upstream credentials in Proceeds first, then in your origin. Rotating in the wrong order will break in-flight requests.

Next

Custom headers and query parameters

Forward extra headers or query params on a per-paywall basis.