`market worker-connect`

Create or reuse a worker's connected payout account and mint a fresh onboarding page.

Exact invocation

handtohuman market worker-connect <ID> --country CC --email ADDRESS --refresh-url URL --return-url URL

Inputs and options

<ID>

Required. A marketplace account. Its recorded connected account is reused if it already has one.

--country

Required. Two-letter country of the worker’s bank account.

--email

Required. Where the provider contacts the worker about their account.

--refresh-url

Required. Where the provider sends a worker whose link expired.

--return-url

Required. Where the provider sends a worker who finished. The command names no page of its own; without either URL it exits 2.

Output and state effect

Result

The Express connected account id, recorded as the account’s payout destination, and a hosted onboarding URL as finish_onboarding_here. The provider’s links are single-use and short-lived, so a new one is minted on every call while the account itself is created once; provider_account_created says which happened.

Serialization

Prints the settled intent.

Refusals

Refuses an unknown account before any call is made.
Refuses without a secret key, naming the environment variable and the Skarbiec item.
Passes through the provider’s refusal verbatim.