Start Here
1. API credentials
- Register at merchant.heydollr.app and complete verification.
- Create Client ID and Client Secret under API Keys.
- Store in environment variables (never commit secrets):
DOLLR_CLIENT_ID=...
DOLLR_CLIENT_SECRET=...
DOLLR_BASE_URL=https://api.heydollr.app
2. Attach documentation context
Add to every AI session:
| Resource | URL |
|---|
| llms.txt | https://docs.heydollr.app/llms.txt |
| OpenAPI | https://api.heydollr.app/openapi.json |
| This site | Use Copy page on the guide you are implementing |
3. Project rules snippet
Paste into your app repo as .cursor/rules/dollr.mdc, CLAUDE.md, or AGENTS.md:
## Dollr API (v1)
- Base URL: https://api.heydollr.app
- Auth: POST /v1/jwt/client/obtain/token (client_id, client_secret) → Bearer token; expires_in is MINUTES
- Secrets: server-side only
- Executions: generate UUID v4 reference_id BEFORE POST /v1/executions/collection|payout|transfer|refund
- On timeout: GET /v1/status/{type}/{reference_id} before retrying execute
- MoMo: PROCESSING can last minutes — do not re-execute with a new reference_id
- Docs: https://docs.heydollr.app/llms.txt
4. Pick a flow
5. Open the prompt library
Prompt library — copy a prompt, replace the [TASK] section, run in your IDE.
Optional: documentation MCP
Read-only search over Dollr docs: https://docs.heydollr.app/mcp — setup in AI & MCP.Last modified on May 22, 2026
