Skip to navigation

Check Stripe Funding Eligibility

View as Markdown

Check whether an account is eligible for a Stripe debit-card deposit.

Available to: All authenticated users

Environments: Live

Rate Limit: No endpoint-specific limit

Call this endpoint before adding a saved card or starting a wallet deposit. It verifies that debit-card funding is enabled for the account, the account type is eligible, the currency is USD, and no incompatible debit-card transaction is pending.

Omit amount to retrieve the account-specific minimumAmount and maximumAmount. Include amount to validate a proposed deposit against those limits. Do not hard-code funding limits: account and user configuration control both bounds, and qualifying pending DCR transactions reduce the maximum.

Warning: This endpoint returns HTTP 200 for eligible and ineligible results. Check errorText before continuing.

Common Failure Scenarios

  • Account is not Individual or Joint
  • Debit-card funding is disabled for the account
  • Currency is not USD
  • Amount is below the returned minimum or exceeds the returned maximum
  • A debit-card transaction is already pending

Related Endpoints

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
accountIdlongRequired
currencyIdlongRequired
amountdoubleOptional

Response

CheckStripeFundingEligibilityResponse
errorTextstringOptional<=8192 characters

Non-empty if the request failed

minimumAmountdoubleOptional
maximumAmountdoubleOptional