A session records intent to move money. Create the right session type, then execute before it expires.
Try in API Reference: Checkout · Payout · Transfer · Refund
Session types
| Type | Endpoint | Use with execution |
|---|
| Checkout | POST /v1/sessions/checkout | POST /v1/executions/collection |
| Payout | POST /v1/sessions/payout | POST /v1/executions/payout |
| Transfer | POST /v1/sessions/transfer | POST /v1/executions/transfer |
| Refund | POST /v1/sessions/refund | POST /v1/executions/refund |
source_id + source_type (INVOICE or ORDER).
Session lifetime
Sessions are short-lived. Create a session immediately before execute — do not cache session IDs across user sessions.
| Session type | Typical use |
|---|
| Checkout | Created when customer starts payment; execute collection before expiry |
| Payout | Response includes expires_at — execute payout before that timestamp |
| Transfer / Refund | You provide expires_at on create |
Minimal example (checkout)
curl -X POST "https://api.heydollr.app/v1/sessions/checkout" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"source_id": 101, "source_type": "INVOICE"}'
Last modified on June 23, 2026
