Skip to main content
Replit Agent builds and runs full-stack apps in a hosted environment. Paste the prompt below to scaffold a Lumx integration — server routes, helper, and a starter UI — with your API key stored as a Replit Secret so it never touches the client.

Prerequisites

  • A Lumx account with a Sandbox API key
  • A Replit account with Agent access
  • A new or existing Repl that runs a server (Node, Python, Bun, etc.)

Step 1 — Get your Lumx credentials

From the Lumx Dashboard, open Developers → API Keys and copy a Sandbox key. See Authentication. Keys are only shown once.

Step 2 — Store the key in Replit Secrets

In your Repl, open the Secrets tool (lock icon in the left rail) and add: Replit Secrets are injected into process.env (or os.environ) at runtime and never appear in the file tree or the public Repl URL.
Don’t paste your API key into the Agent chat. Add it as a Secret and reference it by name only.

Step 3 — Paste the prompt

In the Agent chat, paste:
Replit Agent doesn’t support MCP servers directly. Once you clone the Repl down locally and open it in Cursor or Claude Code, connect them to Lumx’s docs MCP so the agent can pull endpoint shapes and field definitions on demand.
Lumx integration prompt

Step 4 — Run the Repl

Agent will write the files, install dependencies, and start the server. Open the webview, create a sandbox customer, open the verification link, and try an on-ramp. Every transaction in Sandbox is simulated — no real money moves.

Example: a server-side Lumx helper

The prompt aims for this shape. Drop it in directly if you’d rather wire the helper by hand.
server/lumx.ts

FAQ

No. Secrets stay with the Repl owner and are not copied when someone forks. The forker has to add their own. That’s also why the prompt asks Agent to read from process.env, not from a file in the tree.
Yes. Replit Deployments inherit the Repl’s secrets. The same LUMX_API_KEY and LUMX_ENV apply — flip LUMX_ENV to production and swap the key when you’re ready.
Update the two Secrets — set LUMX_ENV=production and replace LUMX_API_KEY with a Production key. Production access requires a call with the Lumx team — see Environments.
No. Logs in Replit can be shared with viewers of the Repl. Ask Agent to redact the key and only log the response status and request path.

Next steps

  • Create a customer — full reference for the customer payload
  • Webhooks — subscribe to status changes instead of polling
  • Use cases — patterns for global accounts, payroll, treasury, and more