Skip to main content
An execution submits a session and moves funds. All execution endpoints return an ExecutionResponse.
Try in API Reference: Collect · Payout
Hosted checkout does not require server-side execution — Dollr executes payment on the hosted page. See Hosted checkout.
Generate a UUID v4 reference_id before the HTTP call and store it. If the response is lost, poll status with that same ID — do not mint a new one until you confirm the attempt did not land.

​
Collect

curl -X POST "https://api.heydollr.app/v1/executions/collection" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "session_id": "55",
    "payment_account_id": "18",
    "currency": "USD",
    "reference_id": "550e8400-e29b-41d4-a716-446655440000"
  }'

​
Payout

Requires session_id, payout_account_id, reference_id, and passcode (merchant verification). See Payout with Node.js.

​
Execution response

FieldDescription
statusPENDING → PROCESSING → COMPLETED | FAILED
reference_idYour idempotency key
payer_amount / payee_amountSettled amounts
requires_actiontrue when card 3DS is needed
client_secretStripe secret for 3DS confirmation (card only)
gateway_messageProvider status message
For card payments, when requires_action is true, complete authentication with client_secret before polling status. See Collect with card.

​
Execution status

Mobile money may remain PROCESSING for several minutes. Do not re-execute during this window.
Last modified on June 23, 2026