Provision or update a credit line's Stripe Connect Issuing account and CreditPolicy

POST/api/v1/credit/lines/{credit_line_id}/cards/stripe-issuing/connect

Creates or updates a Stripe Custom connected account (card_issuing + transfers + optional funding_credit) for a merchant credit line, generates an account_onboarding link when return_url and refresh_url are supplied, and optionally activates a Stripe Issuing Credit CreditPolicy or records a FundingObligation repayment. Accounts must belong to the business and per-line accounts must match this line. Omitted accounts reuse an existing line account or create one idempotently. Onboarding URLs must use the configured app origin. Live business operator action (an API token receives 403); sandbox businesses are refused before Stripe calls.

Operation ID: provision_line_stripe_issuing_connect·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Parameters

Path

credit_line_idstringrequired: Credit line UUID to bind the Stripe Connect account to.

Request body

Schema: CreditStripeLineConnectRequest

stripe_account_idstring: Owned connected Stripe account ID (acct_...). Per-line accounts require Stripe metadata matching this business and this line. Omit to reuse a verified existing line account, recover one after a failed save, or create a Custom account with a stable per-business/per-line idempotency key. Editable issuer_config alone is not ownership proof; platform is refused.
countrystring: Two-letter country code for a newly created connected account.
enable_funding_creditboolean: Also request the funding_credit capability (Charge Card beta) on the connected account.
return_urlstring: Return URL for Stripe-hosted onboarding. Supply with refresh_url; both must use the configured product-app origin (scheme, host and port), without credentials or fragments. Validated before Stripe mutations.
refresh_urlstring: Refresh URL for Stripe-hosted onboarding. Supply with return_url; both must use the configured product-app origin (scheme, host and port), without credentials or fragments. Validated before Stripe mutations.
activate_credit_policyboolean: Configure and activate the connected account's CreditPolicy (POST /v1/issuing/credit_policy).
credit_limit_centsinteger: Override credit limit in cents for CreditPolicy; defaults to the credit line's limit.
days_until_dueinteger: Days until due after the credit period ends on the CreditPolicy.
funding_obligation_idstring: Optional FundingObligation ID (ifo_...) to record a repayment against.
pay_amount_centsinteger: Repayment amount in cents to record on funding_obligation_id (/pay).

Responses

201Successful Response

Schema: SuccessEnvelope_CreditStripeLineConnectResponse_

successboolean
messagestring
codestring
dataCreditStripeLineConnectResponse

400Bad Request - Invalid input

Schema: ErrorResponse

errorstringrequired: Error category: validation_error, unauthorized, forbidden, not_found, conflict, rate_limited, server_error, or service_unavailable.
messagestringrequired: Human-readable explanation, safe to show to end users.
codestringrequired: Stable machine-readable code in CATEGORY_NNN form (e.g. NOT_FOUND_006, AUTH_010, GEN_002).
request_idstring: Correlation id for support requests. Echoes the x-request-id request header when one was supplied.
errorsobject: Field-level validation messages keyed by field name. Present on 400/422 validation failures only.

401Unauthorized - Missing or expired token, an MCP OAuth token used against the REST API, or no access to this business

Schema: ErrorResponse

errorstringrequired: Error category: validation_error, unauthorized, forbidden, not_found, conflict, rate_limited, server_error, or service_unavailable.
messagestringrequired: Human-readable explanation, safe to show to end users.
codestringrequired: Stable machine-readable code in CATEGORY_NNN form (e.g. NOT_FOUND_006, AUTH_010, GEN_002).
request_idstring: Correlation id for support requests. Echoes the x-request-id request header when one was supplied.
errorsobject: Field-level validation messages keyed by field name. Present on 400/422 validation failures only.

403Forbidden - Insufficient permissions

Schema: ErrorResponse

errorstringrequired: Error category: validation_error, unauthorized, forbidden, not_found, conflict, rate_limited, server_error, or service_unavailable.
messagestringrequired: Human-readable explanation, safe to show to end users.
codestringrequired: Stable machine-readable code in CATEGORY_NNN form (e.g. NOT_FOUND_006, AUTH_010, GEN_002).
request_idstring: Correlation id for support requests. Echoes the x-request-id request header when one was supplied.
errorsobject: Field-level validation messages keyed by field name. Present on 400/422 validation failures only.

404Not Found - Resource does not exist

Schema: ErrorResponse

errorstringrequired: Error category: validation_error, unauthorized, forbidden, not_found, conflict, rate_limited, server_error, or service_unavailable.
messagestringrequired: Human-readable explanation, safe to show to end users.
codestringrequired: Stable machine-readable code in CATEGORY_NNN form (e.g. NOT_FOUND_006, AUTH_010, GEN_002).
request_idstring: Correlation id for support requests. Echoes the x-request-id request header when one was supplied.
errorsobject: Field-level validation messages keyed by field name. Present on 400/422 validation failures only.

422Validation Error

Schema: ErrorResponse

errorstringrequired: Error category: validation_error, unauthorized, forbidden, not_found, conflict, rate_limited, server_error, or service_unavailable.
messagestringrequired: Human-readable explanation, safe to show to end users.
codestringrequired: Stable machine-readable code in CATEGORY_NNN form (e.g. NOT_FOUND_006, AUTH_010, GEN_002).
request_idstring: Correlation id for support requests. Echoes the x-request-id request header when one was supplied.
errorsobject: Field-level validation messages keyed by field name. Present on 400/422 validation failures only.

Code samples

POST/api/v1/credit/lines/{credit_line_id}/cards/stripe-issuing/connect

bash

curl -X POST 'https://api.ondayzero.com/api/v1/credit/lines/{credit_line_id}/cards/stripe-issuing/connect' \
  -H 'Authorization: Bearer dz_your_token' \
  -H 'x-business-id: YOUR_BUSINESS_ID' \
  -H 'Content-Type: application/json' \
  -d '{
  "stripe_account_id": "string",
  "country": "string",
  "enable_funding_credit": false,
  "return_url": "string",
  "refresh_url": "string",
  "activate_credit_policy": false
}'