The Financing offer object Preview
Attributes
- idstring
A unique identifier for the financing object.
- objectstring
The object type: financing_offer.
- accepted_
termsnullable object Information about the current financing object. Describes currency, advance amount, fee amount, withhold rate, and fee discount of previous financing.
- accepted_terms.
advance_ amountinteger Amount of financing offered, in minor units. For example, $1,000 USD will be represented as 100000.
- accepted_terms.
currencystring Currency that the financing offer is transacted in. For example,
usd
. - accepted_terms.
fee_ amountinteger Fixed fee amount, in minor units. For example, $100 USD will be represented as 10000.
- accepted_terms.
previous_ financing_ fee_ discount_ amountnullable integer Populated when the
product_
of thetype financingoffer
isrefill
. Represents the discount amount on remaining premium for the existing loan at payout time. - accepted_terms.
repayment_ interval_ configurationnullable objectPreview feature The configuration for the repayment interval of the financing.
- accepted_terms.
repayment_interval_configuration. duration_ daysnullable integer Length of each repayment interval in days.
- accepted_terms.
repayment_interval_configuration. maximum_ amountnullable integer Maximum amount that can be repaid in an interval, in minor units. If provided, repayments will be capped to this amount for each repayment interval. If no maximum is specified, there is no cap on the repayment amount in a repayment interval.
- accepted_terms.
repayment_interval_configuration. minimum_ amountnullable integer Minimum amount that needs to be repaid in an interval, in minor units.
- accepted_terms.
target_ payback_ daysnullable integerPreview feature The estimated number of days to fully repay the financing. Note that this is an estimate based on current payment volume, and the actual number of days to fully repay the financing may differ.
- accepted_terms.
withhold_ ratefloat Per-transaction rate at which Stripe will withhold funds to repay the financing.
- accountstring
The ID of the merchant associated with this financing object.
- charged_
off_ atnullable timestamp The time at which this financing offer was charged off, if applicable. Given in seconds since unix epoch.
- createdinteger
Time at which the offer was created. Given in seconds since unix epoch.
- expires_
afterfloat Time at which the offer expires. Given in seconds since unix epoch.
- financing_
typenullable enum The type of financing being offered.
Possible enum valuescash_
advance Capital’s Merchant Cash Advance program.
fixed_
term_ loan Capital’s fixed-term loan offering. See the integration guide for more information.
flex_
loan Capital’s flex loan offering. See the integration guide for more information.
- livemodeboolean
Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - metadatanullable object
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- offered_
termsnullable object Information about the financing offer. Describes currency, offered advance amount, offered fee amount, campaign type, withhold rate, and fee discount rate of previous financing.
- offered_terms.
advance_ amountinteger Amount of financing offered, in minor units. For example, $1,000 USD will be represented as 100000.
- offered_terms.
campaign_ typeenum Describes the type of user the offer is being extended to.
Possible enum valuesnewly_
eligible_ user A user who has never been eligible for Capital before.
previously_
eligible_ user A user who has been offered financing through Capital before, but never accepted an offer.
repeat_
user A user who has already accepted or fully repaid a loan, and is receiving another offer.
- offered_terms.
currencystring Currency that the financing offer is transacted in. For example,
usd
. - offered_terms.
fee_ amountinteger Fixed fee amount, in minor units. For example, $100 USD will be represented as 10000.
- offered_terms.
previous_ financing_ fee_ discount_ ratenullable float Populated when the
product_
of thetype financingoffer
isrefill
. Represents the discount rate percentage on remaining fee on the existing loan. When thefinancing_
is paid out, theoffer previous_
will be computed as the multiple of this rate and the remaining fee.financing_ fee_ discount_ amount - offered_terms.
repayment_ interval_ configurationnullable objectPreview feature The configuration for the repayment interval of the financing.
- offered_terms.
repayment_interval_configuration. duration_ daysnullable integer Length of each repayment interval in days.
- offered_terms.
repayment_interval_configuration. maximum_ amountnullable integer Maximum amount that can be repaid in an interval, in minor units. If provided, repayments will be capped to this amount for each repayment interval. If no maximum is specified, there is no cap on the repayment amount in a repayment interval.
- offered_terms.
repayment_interval_configuration. minimum_ amountnullable integer Minimum amount that needs to be repaid in an interval, in minor units.
- offered_terms.
target_ payback_ daysnullable integerPreview feature The estimated number of days to fully repay the financing. Note that this is an estimate based on current payment volume, and the actual number of days to fully repay the financing may differ.
- offered_terms.
withhold_ ratefloat Per-transaction rate at which Stripe will withhold funds to repay the financing.
- product_
typenullable enum Financing product identifier.
Possible enum valuesrefill
A “refill” financing offer extended through Stripe Capital. Refills are a form of discounted refinancing. See the integration guide for more information.
standard
A standard financing offer extended through Stripe Capital.
- replacementnullable string
The ID of the financing offer that replaced this offer.
- replacement_
fornullable string The ID of the financing offer that this offer is a replacement for.
- statusenum
The current status of the offer.
Possible enum valuesaccepted
Set once an offer has been accepted by the Connected account.
canceled
Set when the Connected account has reached out to Capital’s servicing team within 48 hours of acceptance and requested cancellation of their offer.
completed
Set when the financing offer has fully repaid. This status is no longer in use. See
fully_
instead.repaid delivered
Once an offer has been delivered, mark it so using the mark_delivered endpoint.
expired
Set when the financing offer has expired, usually 30 days after creation.
fully_
repaid Set when the financing offer has been fully repaid.
paid_
out Set once an offer has been paid out to the Connected account.
rejected
Set when Capital’s servicing team has rejected the application for financing. The Connected account receives an email with the reason for rejection.
replaced
Set when the financing offer has been replaced.
undelivered
All offers begin in this state. A financing offer must be delivered to its Connected account using approved marketing materials.
- status_
transitionsobjectPreview feature Hash containing timestamps of when the offer transitioned to a particular status.
- status_transitions.
accepted_ atnullable timestamp Timestamp describing when a FinancingOffer changed status to
accepted
- status_transitions.
canceled_ atnullable timestamp Timestamp describing when a FinancingOffer changed status to
canceled
- status_transitions.
fully_ repaid_ atnullable timestamp Timestamp describing when a FinancingOffer changed status to
fully_
repaid - status_transitions.
paid_ out_ atnullable timestamp Timestamp describing when a FinancingOffer changed status to
paid_
out - status_transitions.
rejected_ atnullable timestamp Timestamp describing when a FinancingOffer changed status to
rejected
- status_transitions.
replaced_ atnullable timestamp Timestamp describing when a FinancingOffer changed status to
replaced
- typenullable enumDeprecated
See financing_type.
Possible enum valuescash_
advance fixed_
term_ loan flex_
loan
{ "id": "financingoffer_1NPvKg2eZvKYlo2CnEEmlCVh", "object": "capital.financing_offer", "account": "acct_1NPvKgBY65lDjjDk", "created": 1688423699, "expires_after": 1690934400, "financing_type": "flex_loan", "livemode": true, "offered_terms": { "advance_amount": 10000, "campaign_type": "newly_eligible_user", "currency": "usd", "fee_amount": 1000, "previous_financing_fee_discount_rate": null, "withhold_rate": 0.05 }, "product_type": "standard", "status": "undelivered"}