Skip to main content
5xx responses indicate an unexpected problem on Dollr or an upstream provider. Your request may or may not have been processed.

​
The problem

Ambiguous outcomes after POST /v1/executions/* are the highest risk: you might double-charge if you retry blindly.

​
Solution

1

For executions — poll first

If you stored reference_id, call GET /v1/status/collection/:reference_id (or payout/transfer/refund) before retrying execute.
2

Retry with backoff

For idempotent reads and safe retries, use exponential backoff (1s, 2s, 4s… capped).
3

Escalate if persistent

Email dev@heydollr.app with reference_id, UTC timestamp, endpoint, and redacted bodies. See Support checklist.
Last modified on May 22, 2026