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.
Navigate to x402 Endpoints
Log in to app.paywithlocus.com
Click x402 Endpoints in the left sidebar under “Config”
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.
Field Value Endpoint URL https://laso.finance/authSlug laso-authName Laso Finance Auth Description Get auth credentials (id_token, refresh_token, user_id) HTTP Method GET Input Parameters (none)
Click Validate & Add to save.
2. laso-get-card This endpoint orders a prepaid card.
Field Value Endpoint URL https://laso.finance/get-cardSlug laso-get-cardName Laso Get Card Description Order a prepaid card (US only, 5 − 5- 5 − HTTP Method GET
Input Parameters: Click + Add Parameter and configure:
Parameter Name Type Location Required amountnumber query ✅ Yes
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 USD to a U.S. debit card.
Field Value Endpoint URL https://laso.finance/push-to-cardSlug laso-push-to-cardName Laso Push to Card Description Send USD to a U.S. debit card (10 − 10- 10 − HTTP Method GET
Input Parameters: Click + Add Parameter and configure:
Parameter Name Type Location Required amountnumber query ✅ Yes
Click Validate & Add to save.
4. laso-send-payment This endpoint sends Venmo or PayPal payments.
Field Value Endpoint URL https://laso.finance/send-paymentSlug laso-send-paymentName Laso Send Payment Description Send Venmo or PayPal payment (5 − 5- 5 − HTTP Method GET
Input Parameters: Click + Add Parameter for each:
Parameter Name Type Location Required amountnumber query ✅ Yes platformstring query ✅ Yes recipient_idstring query ✅ Yes
Click Validate & Add to save.
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&platform=paypal)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:
{ "error" : "amount query parameter is required" }
Calling Endpoints via Locus Once configured, your agent calls Laso Finance through the Locus API:
# Get auth credentials curl -X POST "https://api.paywithlocus.com/api/x402/laso-auth" \ -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{}' # Order a card curl -X POST "https://api.paywithlocus.com/api/x402/laso-get-card" \ -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"amount": 50}' # Send to a debit card curl -X POST "https://api.paywithlocus.com/api/x402/laso-push-to-card" \ -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"amount": 100}' # Send a PayPal payment curl -X POST "https://api.paywithlocus.com/api/x402/laso-send-payment" \ -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"amount": 25, "platform": "paypal", "recipient_id": "email@example.com"}'
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 4 endpoints listed:
Test each endpoint by calling it through the Locus API. If you get parameter errors, double-check that:
Input parameters are defined in the endpoint configuration
Each parameter has Location: query selected
Required parameters have the “Required” checkbox checked
Next Steps
Making a purchase Walk through ordering a card and buying something.
Sending payments Learn how to send Venmo and PayPal payments.
Push to debit card Send USD directly to a U.S. debit card.
