Skip to main content
After setting up your Locus wallet and API key, you need to register the Laso Finance x402 endpoints in the Locus dashboard. This tells Locus which APIs your agent can call and how to forward parameters correctly.
This guide is for Locus users. If you’re using Sponge, endpoint discovery is automatic — your agent calls GET /api/discover?query=laso and Sponge handles the rest. No manual configuration needed.
Skipping this step will cause API calls to fail. Without endpoint configuration, Locus doesn’t know how to route requests or pass parameters to Laso Finance.
  1. Log in to app.paywithlocus.com
  2. Click x402 Endpoints in the left sidebar under “Config”
  3. Click + Add Endpoint to add each Laso Finance endpoint

​
Required Endpoints

You need to add these four paywalled endpoints:

​
1. laso-auth

This endpoint authenticates your agent and returns API credentials. Click Validate & Add to save.

​
2. laso-get-card

This endpoint orders a prepaid card. Input Parameters: Click + Add Parameter and configure:
The Location: query setting is critical. This tells Locus to append the parameter as a URL query string (e.g., ?amount=50).
Click Validate & Add to save.

​
3. laso-push-to-card

This endpoint sends money to a USD, EUR, or GBP debit card. Input Parameters: Click + Add Parameter and configure: Click Validate & Add to save.

​
Why Input Parameters Matter

When you configure a GET endpoint, Locus needs to know how to forward parameters to the upstream API:
  • Location: query — Parameters are appended to the URL as query strings (e.g., ?amount=50)
  • Location: body — Parameters are sent in the request body (for POST endpoints)
  • Location: path — Parameters are substituted into the URL path
Laso Finance GET endpoints expect query parameters. If you don’t configure them with Location: query, Locus sends them as JSON body — which Laso Finance rejects with errors like:

​
Calling Endpoints via Locus

Once configured, your agent calls Laso Finance through the Locus API:
Locus handles the x402 payment negotiation automatically — the cost is deducted from your wallet and the API response is returned.

​
Verifying Your Configuration

After adding all endpoints, you should see 3 endpoints listed: Test each endpoint by calling it through the Locus API. If you get parameter errors, double-check that:
  1. Input parameters are defined in the endpoint configuration
  2. Each parameter has Location: query selected
  3. Required parameters have the “Required” checkbox checked

​
Next Steps

Making a purchase

Walk through ordering a card and buying something.

Push to debit card

Send money directly to a USD, EUR, or GBP debit card.