Introduction
Accept Stellar payments and receive real-time webhooks over a plain REST API — integrate from any language, no package required.
StellarHooks is non-custodial payment infrastructure for Stellar. You create products, generate hosted payment links, and we watch the chain and notify your server the moment a payment settles. We never hold your funds — they go straight to your own wallet.
At a glance
Customer
pays via link
Payment link
address + memo
Stellar
settles on-chain
StellarHooks
detect + verify
Your server
payment.completed
Funds flow customer → your wallet directly. StellarHooks only watches the chain and notifies you — it never sits in the money path.
What you can do
- Products — define what customers pay for (fixed price or customer-chosen amount).
- Payment links — hosted payment pages with a QR code, address, and memo.
- Payments — confirmed on-chain payments, verified and recorded automatically.
- Wallets — monitor any Stellar address for incoming payments.
- Webhooks — signed
payment.completedandpayment.receivedevents with automatic retries.
Base URL
All API requests are made to your deployment under the versioned base path:
https://your-app.com/api/v1Requests and responses are JSON. Every successful response is wrapped in an envelope with data (and meta for lists); errors return error.
curl, fetch, Python requests, or any HTTP client. Every endpoint in these docs includes copy-paste examples.Next steps
Head to the Quickstart to make your first request, or read How it works to understand the payment lifecycle.