Quickstart
Create your first product and payment link in a few minutes.
1. Get an API key
In the dashboard, open API Keys and create a key. It's shown once — store it as an environment variable.
bash
export STELLARHOOKS_API_KEY="sk_..."2. Add a wallet to receive into
Products receive payments into a monitored wallet. Add one in Monitored Wallets (or via the API) and copy its id.
bash
curl https://your-app.com/api/v1/wallets \ -H "Authorization: Bearer $STELLARHOOKS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Treasury", "address": "G...", "network": "TESTNET" }'3. Create a product
Use the wallet id from the previous step as walletId.
curl https://your-app.com/api/v1/products \ -H "Authorization: Bearer $STELLARHOOKS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Pro plan", "walletId": "WALLET_ID", "assetCode": "XLM", "priceType": "FIXED", "price": "25" }'4. Create a payment link
A link returns a hosted payment page URL you can share or embed. Each link gets a unique memo used to match incoming payments.
curl https://your-app.com/api/v1/payment-links \ -H "Authorization: Bearer $STELLARHOOKS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "productId": "PRODUCT_ID" }'5. Get notified when paid
Register a webhook subscribed to payment.completed. When a customer pays, we verify the payment on-chain and POST a signed event to your endpoint.
See Webhooks & events for the payload and how to verify signatures.