Skip to main content
You are running the facilitator, not calling it. This page gets a facilitator instance running locally against Stellar Testnet, funded well enough to sponsor fees, and confirmed by a real end-to-end paid request. Once that works, Deploying to Mainnet covers everything the local instance did not.

​
Prerequisites

  • Docker or Node.js 22+
  • A Stellar keypair to use as the sponsor account (this pays network fees; not the same as any seller’s payTo account)
  • ~10 Testnet XLM in that sponsor account (faucet)

​
1. Pull the facilitator

Or clone and run from source:

​
2. Configure

Create .env:
Full reference: Configuration Reference.

​
3. Run it

You should see:

​
4. End-to-end smoke test

Point either the buyer quickstart or the seller quickstart at http://localhost:4020 as the facilitator URL, then run the pair. If a paid request settles, your instance is healthy. Check the supported endpoint directly:

​
Where to go next

Configuration Reference

Every environment variable and config key, grouped by subsystem.

Deploying to Mainnet

Sponsor account funding math, RPC selection, and cutover checklist.

Observability

Metrics, tracing, dashboards, and what every number on them means.

Runbook

Incident response for the situations that actually happen at 3am.