Mark a sandbox customer as a house account
Sandbox-only. Marks (or unmarks) one of your business customers as a house account — the only source a purpose: prefunding payout accepts. Every sandbox organization is seeded with one house account already; use this to prefund from a customer you onboarded yourself. More than one customer can carry the marker. The marker alone is not enough to send from: the customer also needs its own active wallet on the destination chain, or its own USD account, or the payout is refused. On live, only Conduit can set it, so treat the marker itself as sandbox setup rather than something your integration writes. Returns the customer at its new state.
Authorizations
Path Parameters
"cus_1A2b3C4d5E6f7G8h9I0jKl"
Body
Whether this customer is the organization's own house account — the only kind of account a prefunding payout can be sent from.
true
Response
The customer at its new house-account state
Unique customer identifier
^cus_[0-9A-Za-z]{22}$ID of the onboarding application that created this customer.
^app_[0-9A-Za-z]{22}$Timestamp when the customer was created
"2026-01-15T09:30:00.000Z"
Timestamp when the customer was last modified
"2026-01-15T09:30:00.000Z"
List of features enabled for this customer
Whether this customer is the organization's own house account rather than an external customer. Read-only on live; on sandbox, set it with PATCH /v2/sandbox/customers/{customerId}/house-account.
false
business Registered legal name of the business
"Acme Payments Inc."
Government-issued tax identifier (e.g. EIN for US businesses). A US EIN captured from this release on is returned as nine digits without hyphens; an EIN stored earlier keeps the form it was stored in.
"123456789"
Registered office address. Same nested shape the onboarding request submits, so it round-trips field-for-field.
Date the business was incorporated (YYYY-MM-DD)
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$"2020-03-15"
Legal structure of the business — the local jurisdiction name the customer declared at onboarding (e.g. 'Sociedade Limitada', 'GmbH', 'C-Corporation'). Free-form string; the available options are jurisdiction-specific and surfaced by the requirements discovery endpoint.
"Sociedade Limitada"
Primary business contact email
"compliance@acmepay.com"
Client-provided external identifier for cross-referencing. 1-255 characters from A-Za-z, 0-9, underscore, hyphen, colon, and period — no spaces.
^[A-Za-z0-9_\-:.]{1,255}$"client-cus-001"
Effective signing mode for this customer right now: the per-customer override if one exists, else the organization setting, else the default. For a customer with no wallet claim yet, this is the value claim-non-custodial would freeze and the roster shape it accepts. For a customer that already claimed, the claimed wallet keeps the mode it froze at claim time, even if this value changes afterward. This field may be absent temporarily while the API is being updated.
passkey_required, programmatic, programmatic_unattended Doing-business-as name. Omitted if same as legal name.
"Acme Pay"
Business registration or incorporation number
"12345678"
Business website URL
"https://acmepay.com"
Primary industry classification of the business
Agriculture, Mining, Manufacturing, Retail/Wholesale, Healthcare, Real Estate, Transport/Logistics, Energy, Education, Financial Technology, Professional Services, Hospitality, Construction, Telecommunications, Other "Financial Technology"
Attested primary industry. The accepted values change over time, so read the current set from GET /v2/onboarding/policy-subjects?axis=industry.
"fintech_companies"
Display name of the attested primary industry, as it appears in the current policy catalog. Omitted when the business attested no industry, or when the key has no catalog row.
"Fintech Companies"
Attested regulated or restricted activities. The accepted values change over time, so read the current set from GET /v2/onboarding/policy-subjects?axis=regulated_activity.
Primary business contact phone number
"+14155551234"