Nachfinanzierung Ihrer Integration mit Dynamic ReservesPrivate Vorschau

Erfahren Sie, wie Sie dynamische Reserven für die Nachfinanzierung von Kartenausgaben verwenden.

Vorsicht

Diese API befindet sich derzeit in der Betaphase. Feldnamen oder allgemeine Konzepte können sich in späteren Versionen ändern. Um Zugriff auf die Dynamic Reserves APIs zu erhalten, übergeben Sie den folgenden Header in allen API-Anfragen: Stripe-Version: <your stripe version>;issuing_credit_beta=v2;

Dynamische Rückstellungen ermöglichen es Plattformen, ihre eigenen Kreditgrenzen in Echtzeit anzupassen, um Bargeld zwischen Stripe und den für die Autorisierung verfügbaren Geldern zu verwalten. Mit dieser Funktion können Sie:

Kapitalnutzung kontrollieren die Finanzierungskosten minimieren
Grenzen kontrollieren, die die Verfügbarkeit der Autorisierung bestimmen
Mit Stripe unerwartete Volatilität verwalten Ihre verbundenen Konten können bei Kartenausgaben ein negatives Guthaben in Issuing aufweisen und zu einem späteren Zeitpunkt eine nachträgliche Zahlung an Stripe vornehmen. Sie können Ihrem Issuing-Guthaben Geld hinzufügen, nachdem das Netzwerk die Kartenautorisierungen erfasst hat (in der Regel 1 Tag nach Erstellung der Autorisierung), anstatt Ihr Issuing-Guthaben vorzufinanzieren, bevor Kartenausgaben erfolgen. Stripe benachrichtigt Sie jeden Tag über den Betrag, den Sie schulden, und Sie können noch am selben Tag vor der Frist Gelder an Stripe überweisen. Sie müssen fristgerecht Gelder bei Stripe einzahlen (in der Regel 20:00 Uhr UTC), um Verzugsgebühren und zusätzliche Strafen zu vermeiden.

Connect

Wenn Sie eine Connect-Plattform nachträglich finanzieren, ist das Verhalten Ihres verbundenen Kontos dasselbe wie bei:

Die Beziehung zwischen Ihrer Plattform und Ihren verbundenen Konten ändert sich nicht. Der Hauptunterschied besteht darin, dass Sie die Gesamtausgaben Ihrer verbundenen Konten nicht vorfinanzieren müssen, sondern diese nachträglich finanzieren können.

Bevor Sie loslegen

Richten Sie eine Rückstellung ein, auf die nur im Falle eines Betriebsausfalls zugegriffen werden kann.
Überweisungen von Ihrer Bank senden.

Konfiguration des Kartenprogramms

Stripe konfiguriert eine CreditPolicy für Ihre Plattform oder Ihr direktes Kartenprogramm, die Informationen über Ihre Zahlungsverpflichtungen und -bedingungen enthält. Die CreditPolicyIhres Kartenprogramms unterscheidet sich von der CreditPolicy, die Sie für Ihre verbundenen Konten festgelegt haben. Stripe bestimmt und kontrolliert die CreditPolicy Ihres Kartenprogramms, die die folgenden Felder definiert:

current_exposure_limit_amount: Der maximale Gesamtbetrag, der von all Ihren verbundenen Konten (bzw. Konto bei Direktnutzern/-nutzerinnen) ausgegeben werden kann. Wir berechnen den current_exposure_limit_amount basierend auf der Kombination der Werte funded_reserve_amount und reserve_multiplier mit der folgenden Gleichung: current_exposure_limit_amount = MIN [(funded_reserve_amount * reserve_multiplier), maximum_exposure_limit]
reserve_multiplier_decimal: Der Betrag, mit dem der funded_reserve_amount multipliziert wird, um den current_exposure_limit_amount zu ermitteln. Der reserve_multiplier_decimal wird zu Beginn des Nachfinanzierungsprogramms festgelegt.
max_exposure_limit_amount: Der maximale Gesamtbetrag, der von all Ihren verbundenen Konten (bzw. Konto bei Direktnutzern/-nutzerinnen) ausgegeben werden kann. Ihre maximale Risikogrenze entspricht einem festen Wert, der von Stripe festgelegt wird, und Ihrem funded_reserve_amount.
funded_reserve_amount: Entspricht den gesamten Rückstellungen, die Sie bei Stripe hinterlegt haben.
exposure_limit_currency: Der dreistellige Währungscode für den current_exposure_limit_amount und den max_exposure_limit_amount.

Stripe erhebt eine Gebühr, wenn Sie mehr als Ihre funded_reserve ausgeben, Ihre current_exposure_limit überschreiten oder eine funding_obligationzu spät erfüllen. Obwohl Stripe es Ihnen erlaubt, einen höheren Betrag als Ihre current_exposure_limit bis zu Ihrer max_exposure_limit auszugeben, handelt es sich hierbei um Risikokapital und nicht um bereitgestellte Mittel, die Sie verwenden.

Beispiel: Ihr funded_reserve_amount beträgt 1.000 USD, Ihr reserve_multiplier_decimal ist 2.0x, Ihr current_exposure_limit_amount beträgt 2.000 USD und Ihr max_exposure_limit_amount ist 3.000 USD:

Stripe berechnet Ihnen eine Gebühr für die „Guthabennutzung“ für Ausgaben zwischen 1.000 USD und 2.000 USD.
Stripe erhebt eine höhere Gebühr für „Notfallkapital“ für Ausgaben zwischen 2.000 USD und 3.000 USD.
Stripe lehnt Transaktionen über 3.000 USD ab.

Um die Details der CreditPolicy Ihres Kartensprogramms abzurufen, rufen Sie den Endpoint GET CreditPolicy auf:

Command Line
curl https://api.stripe.com/v1/issuing/credit_policy -u "sk_***:" -H "Stripe-Version: 2024-06-20; issuing_credit_beta=v2"

Sehen Sie sich die folgende Beispielantwort an:

{
  "livemode": true,
  "current_exposure_limit_amount": 11359999920 ,
   "reserve_multiplier_decimal": "2.4",
   "max_exposure_limit_amount": 13133333300,
   "funded_reserve_amount": 4733333300,
    // other fields
}

Stripe wendet alle Änderungen an der CreditPolicy nach T+2 Werktagen um 20:00 UTC an. Das Attribut credit_policy.upcoming_attributes.effective_at stellt diesen Zeitstempel dar.

Command Line
curl https://api.stripe.com/v1/issuing/credit_policy -u "sk_***:" -H "Stripe-Version: 2024-06-20; issuing_credit_beta=v2"

Sehen Sie sich die folgende Beispielantwort an:

{
  "livemode": true,
  "upcoming_attributes": {
    "current_exposure_limit_amount": 11359999920,
    "reserve_multiplier_decimal": "2.4",
    "max_exposure_limit_amount": 13233333300,
    "funded_reserve_amount": 4733333300,
    "effective_at": 1729195200 // 2024-10-17 20:00:00 +0000 UTC
  }
}

Nur der feste Teil des max_exposure_limit_amount unterliegt einer Verzögerung von T+2 Werktagen. Der max_exposure_limit_amount ist keine von Stripe initiierte Änderung und wird dynamisch basierend auf Ihrer verfügbaren Rückstellung aktualisiert.

Wenn Sie Stripe beispielsweise bitten, den festen Anteil Ihres max_exposure_limit_amount um 1.000 USD zu erhöhen, wird diese Änderung nach T+2 Werktagen wirksam. Wenn Sie allerdings Ihre funded_reserve um 1.000 USD erhöhen, ändert sich Ihr max_exposure_limit_amount dynamisch in Echtzeit.

Verpflichtung zum Kartenprogramm

Während Ihre CreditPolicy die allgemeinen Parameter Ihres Nachfinanzierungsprogramms festlegt, stellt Ihre FundingObligation Ihre aktuelle Verpflichtung gegenüber Stripe für Kartenausgaben für alle Ihre verbundenen Konten dar oder für Ihr Konto, wenn Sie ein/e direkte/r Nutzer/in sind.

Jeden Morgen sendet Stripe das Webhook-Ereignis issuing_funding_obligation.updated, das die FundingObligation enthält, die Sie Stripe schulden. Für jede FundingObligation stellt der Wert amount_outstanding den Betrag dar, den Sie an diesem Tag schulden.

{
 "id": "icfo_123",
 "amount_total": 95000000, // minor units
 "amount_outstanding": 95000000, // minor units
 "amount_paid": 0,
 "currency": "usd",
 "status": "unpaid",
 "due_at": "timestamp_on_t1",
 "paid_at": "nil",
 "owed_to": "stripe",
 "finalized_at": "timestamp_on_t2",
 "grace_period_ends_at": "timestamp_on_t3",
 …,
}

Verspätete payments

Jede FundingObligation enthält ein due_at-Feld, das angibt, wann die FundingObligation fällig ist.

{
 "id": "icfo_123",
 "amount_total": 95000000, // minor units
 "amount_outstanding": 95000000, // minor units
 "amount_paid": 0,
 "currency": "usd",
 "status": "unpaid",
 "due_at": "timestamp_on_t1",
 "paid_at": "nil",
 "owed_to": "stripe",
 "finalized_at": "timestamp_on_t2",
 "grace_period_ends_at": "timestamp_on_t3",
 …,
}

Wenn Sie Ihre FundingObligation nicht fristgerecht bezahlen, passiert Folgendes:

Stripe hebt einen Betrag aus Ihrer Rückstellung ab, um den überfälligen Betrag zu decken.
Wenn Ihre Rückstellung ein ausreichendes Guthaben aufweist, erhalten Sie den Webhook FundingObligation.updated, der anzeigt, dass der Status der Einzahlungsverpflichtung in paid geändert wurde. Wenn Ihr Rückstellungsguthaben nicht ausreicht, um die FundingObligation vollständig abzudecken, erhalten Sie den Webhook FundingObligation.updated, der anzeigt, dass der Status der Einzahlungsverpflichtung in past_due geändert wurde, sowie einen grace_period_ends_at-Zeitstempel von 20:00 UTC am nächsten Werktag.
Wenn ein Abruf von Geldern aus einer Rückstellung stattfindet, geben der credit_policy.current_exposure_limit_amount und der credit_policy.max_exposure_limit_amount die aktualisierte Risikogrenze basierend auf dem neuen Rückstellungsbetrag des Issuing-Guthabens wider. Sie erhalten einen Webhook, der Sie über die neuen Risikogrenzen (aktuell und maximal) informiert.
Außerdem erhalten Sie eine E-Mail, in der Sie über den abgerufenenen Betrag aus der Rückstellung und die past_due FundingObligation informiert werden.
Wenn Ihre FundingObligation überfällig wird, erhebt Stripe eine Verzugsgebühr gemäß Ihrem Vertrag mit Stripe.
Sie müssen dafür sorgen, dass Ihre current_exposure_limit größer ist als Ihr negatives Guthaben in Issuing. Bereiten Sie sich darauf vor, nach einer von Stripe initiierten Abbuchung gegebenenfalls eine Aufstockung der Rückstellung einzuleiten. Andernfalls wird die Autorisierung abgelehnt, wenn Ihre Ausgaben Ihre max_exposure_limit überschreiten.

Mehrere verspätete Zahlungen im Laufe der Zeit können zu zusätzlichen Strafen für Ihre Plattform führen, zum Beispiel eine Verringerung der Risikogrenze Ihres Kartenprogramms). Sie müssen eine unbezahlte FundingObligation innerhalb eines zusätzlichen Werktags begleichen, da Stripe sonst möglicherweise Transaktionen ablehnt.

Ermitteln Sie, wie viel Sie Stripe schulden

Stripe generiert täglich eine FundingObligation für Ihr Kartenprogramm, auch an Wochenenden und Feiertagen. Um Ihr Konto auf dem neuesten Stand zu halten und Verzugsgebühren und Strafen zu vermeiden, berechnen Sie Ihren täglich geschuldeten Gesamtbetrag basierend auf dem Wert amount_outstanding für alle unpaid und past_due FundingObligations mithilfe einer Formel:

`total_amount_outstanding` = sum(unpaid FundingObligations)¹ + sum(past_due FundingObligations)²

¹sum(unpaid FundingObligations) ist die Summe aller FundingObligations mit status=unpaid.

²sum(past_due FundingObligations) ist die Summe aller FundingObligations mit status=past_due.

Einzahlungsverpflichtungen und Fälligkeitstermine verwalten

Wenn Stripe an einem Wochentag eine FundingObligation generiert, ist diese am selben Tag fällig. Wenn Stripe an einem Wochenende oder Feiertag eine FundingObligation generiert, ist diese am nächsten Werktag fällig. Bei einem typischen Wochenende bedeutet dies, dass am Montag drei FundingObligations fällig sind. Vergewissern Sie sich, dass Sie den Gesamtbetrag, den Sie Stripe schulden, korrekt aufaddieren, um pünktliche Zahlungen zu leisten.

Einzahlungen bei Stripe, um Verpflichtungen nachzukommen

Verwenden Sie eine der folgenden Methoden, um Stripe täglich basierend auf dem Zeitstempel due_at den von Ihnen geschuldeten Gesamtbetrag zu überweisen:

Überweisungen am selben Tag: Veranlassen Sie noch am selben Tag eine Überweisung von Ihrer Bank auf Ihr Stripe Issuing-Guthaben, um eine FundingObligation zu begleichen. Verwenden Sie die FundingInstructions API, um die Konto- und die Routingnummer für Ihr Issuing-Guthaben abzurufen, und verwenden Sie diese als Ziel für die Überweisung.
Guthabenübertragungen: In den USA können Sie Geld sofort von Ihrem Stripe Zahlungsguthaben auf Ihr Issuing-Guthaben übertragen und es zur Begleichung Ihrer FundingObligation über das Stripe-Dashboard oder die API verwenden (kontaktieren Sie Stripe, um Zugriff auf die API zu erhalten).
Bestehendes vorab bezahltes Issuing-Guthaben: In den USA wendet Stripe alle vor- oder überfinanzierten Beträge vom Vortag auf Ihre nächste FundingObligation an. In der EMEA-Region ist die Vorfinanzierung Ihres Issuing-Guthabens für Nutzer/innen von Zahlungskarten nicht zulässig. Stattdessen wird jegliches positives Issuing-Guthaben auf Ihre Issuing-Rückstellung übertragen.

Nachdem Stripe den vollständigen Betrag für die FundingObligation erhalten hat, aktualisieren wir den Status und die Beträge und lösen das Webhook-Ereignis issuing_funding_obligation.updated aus.

{
 "id": "icfo_123",
 "amount_total": 95000000, // minor units
 "amount_outstanding": 0,
 "amount_paid": 95000000, // minor units
 "currency": "usd",
 "status": "paid",
 "due_at": "timestamp_on_t1",
 "paid_at": "timestamp_of_payment",
 "owed_to": "stripe",
 "grace_period_ends_at": "timestamp_on_t2"
 …,
}

Wenn Sie nur einen Teil des fälligen Gesamtbetrags bezahlen, aktualisiert Stripe die Beträge, behält den Status jedoch unpaid bei. Das Webhook-Ereignis issuing_funding_obligation.updated spiegelt diese Informationen wider.

{
 "id": "icfo_123",
 "amount_total": 95000000, // minor units
 "amount_outstanding": 3000000, // minor units
 "amount_paid": 92000000, // minor units
 "currency": "usd",
 "status": "unpaid",
 "due_at": "timestamp_on_t1",
 "paid_at": "timestamp_of_payment",
 "owed_to": "stripe",
 "grace_period_ends_at": "timestamp_on_t2"
 …,
}

Wenn das Guthaben nach der due_at-Frist nicht bezahlt wird, ändert sich der status in past_due, wodurch ein weiteres Webhook-Ereignis, issuing_funding_obligation.updated, ausgelöst wird und eine Rückstellungsabbuchung eingeleitet wird.

Transaktionen für eine Einzahlungsverpflichtung abrufen

Rufen Sie die Liste der Transaktionen ab, die zu einer FundingObligation beitragen, indem Sie einen der folgenden Parameter in die API-Anfrage „Alle Transaktionen auflisten“ einfügen:

funding_obligation_for_account für direkte Nutzer/innen.
funding_obligation_for_platform für Plattformnutzer/innen.

So rufen Sie Transaktionen für Direct Charges ab:

Sehen Sie sich die folgende Beispielantwort an:

{
 "object": "list",
 "url": "/v1/issuing/transactions",
 "has_more": false,
 "data": [
   {
     "id": "ipi_123",
     "object": "issuing.transaction",
     // various other fields
     "funding_obligation_for_platform": null,
     "funding_obligation_for_account": "ifo_123",
     // various other fields
   },
   {
     "id": "ipi_123",
     "object": "issuing.transaction",
     // various other fields
     "funding_obligation_for_platform": null,
     "funding_obligation_for_account": "ifo_123",
     // various other fields
   },
   {...}
 ]
}

Einzahlungsverpflichtungen für verbundene Konten abfragen

Connect-Plattformen müssen den Header Stripe-Account mit einer ID eines verbundenen Kontos enthalten. Verwenden Sie die funding_obligation_for_platform, um die FundingObligation der Plattform abzufragen, oder verwenden Sie die funding_obligation_for_account, wenn Sie die FundingObligation eines verbundenen Kontos kennen.

Sehen Sie sich die folgende Beispielantwort an:

{
 "object": "list",
 "url": "/v1/issuing/transactions",
 "has_more": false,
 "data": [
   {
     "id": "ipi_123",
     "object": "issuing.transaction",
     // various other fields
     "funding_obligation_for_platform": "ifo_123",
     "funding_obligation_for_account": "ifo_456",
     // various other fields
   },
   {
     "id": "ipi_123",
     "object": "issuing.transaction",
     // various other fields
     "funding_obligation_for_platform": "ifo_123",
     "funding_obligation_for_account": "ifo_789",
     // various other fields
   },
   {...}
 ]
}

Verwalten Sie Ihre Rückstellung

Sie müssen eine Rückstellung (in Ihrer Programmvereinbarung als „Sicherheit“ bezeichnet) bei Stripe hinterlegen, um kapitaleffiziente nachfinanzierte Kartenausgaben zu verwenden. Stripe hält die Rückstellung auf einem Konto, das es besitzt und kontrolliert, als Sicherheit für geschuldete Gelder und ruft daraus Beträge ab, um verspätete oder unbezahlte FundingObligations zu begleichen. Stripe verwendet den Rückstellungsbetrag auch als Grundlage für die Berechnungen der current_exposure_limit and max_exposure_limit. Sie können Ihren Rückstellungssaldo dynamisch anpassen, indem Sie mehr Geld hinzufügen, wenn Sie höhere Ausgaben erwarten (z. B. vor einem langen Wochenende), und Ihre Rückstellung reduzieren, wenn Ihre prognostizierten Ausgaben niedriger sind.

Möglicherweise fällt eine Verzugsgebühr an, wenn Ihre Einzahlungsverpflichtung past_due wird und Ihre Rückstellung nicht ausreicht, um den Betrag zu decken. Darüber hinaus kann ein Muster von past_due-Einzahlungsverpflichtungen dazu führen, dass Stripe den reserve_multiplier_decimal Ihrer Plattform oder den festen Anteil Ihres max_exposure_limit_amount reduziert. Um dies zu vermeiden, nehmen Sie Einzahlungen auf Ihr Stripe Issuing-Guthaben durch Banküberweisungen oder Guthabenübertragungen vor dem due_at-Zeitstempel der FundingObligation für Ihre Kreditintegration vor.

Ihre Rückstellungskomponenten ermitteln

Sie können die reserve_multiplier_decimal, den max_exposure_limit_amount, den funded_reserve_amount und den current_exposure_limit_amount in Ihrer CreditPolicy ermitteln. Verwenden Sie diese Faktoren zusammen mit Ihren voraussichtlichen zukünftigen Ausgaben, um den geeigneten funded_reserve_amount zu bestimmen.

Command Line
curl https://api.stripe.com/v1/issuing/credit_policy -u "sk_***:" -H "Stripe-Version: 2024-06-20; issuing_credit_beta=v2"

Sehen Sie sich die folgende Beispielantwort an:

{
  "current_exposure_limit_amount": 11359999920 ,
   "reserve_multiplier_decimal": "2.4",
   "max_exposure_limit_amount": 13133333300,
   "funded_reserve_amount": 4733333300,
    // other fields
}

Fügen Sie Gelder zu Ihrer Rückstellung hinzu

Stripe unterstützt die Überweisung von Geldern in den Rückstellungsbetrag. Sie können dies tun, um Ihren current_exposure_limit_amountzu erhöhen, bevor Sie mehr Geld ausgeben, oder nachdem Stripe einen Betrag von Ihrer Rückstellung abhebt, um eine FundingObligationzu bezahlen, die past_due ist. Die Kontodetails für Ihre Rückstellung finden Sie in der FundingInstruction, die Informationen zum Bankkonto und zur Routingnummer enthält, anhand derer Sie eine Geldüberweisung tätigen können.

Vorsicht

Hierbei handelt es sich um andere Anweisungen als die, die Stripe zur Finanzierung Ihres Issuing-Guthabens verwendet. Das destination_balance Ihrer zurückgestellten Einzahlungsanweisung ist auf issuing_credit_reserved eingestellt.

Sehen Sie sich die folgende Beispielantwort an:

{
 "id": "fi_XYZ",
 "object": "funding_instruction",
 "livemode": "true",
 "currency": "usd",
 "bank_transfer": {
   "type": 'us_bank_account',
   "country": "US",
   "financial_addresses": [{
     "supported_networks": ['ach', 'domestic_wire_us'],
     "type": 'aba',
     "aba": {
       "account_number": "546475644",
       "bank_name": "Wells Fargo",
       "routing_number": "123456"
     },
   }]
 },
 "destination_balance": "issuing_credit_reserved",
 "funding_type": "bank_transfer",
}

Gelder, die per Banküberweisung oder ACH-Überweisung auf das aus den FundingInstructions abgerufene Bankkonto überwiesen werden, werden in Ihre Rückstellung eingezahlt. Wenn die Gelder auf Ihrem Konto eingehen, sendet Stripe die Webhook-Benachrichtigung topup.succeeded zusammen mit dem Webhook-Ereignis issuing_credit_policy.updated, das Ihre aktualisierte Risikogrenze und den eingezahlten Rückstellungsbetrag darstellt. Stripe fügt der Banküberweisung keine zusätzlichen Verzögerungen hinzu und folgt in der Regel dem Standardzeitplan für Überweisungen.

{
 "id": "tu_XYZ",
 "object": "topup",
 "amount": 9000,
 "balance_transaction": "txn_123",
 "destination_balance": "issuing_credit_reserved"
 "created": 123456789,
 ...
}

Überprüfen Sie Ihre Rückstellungsbilanz

Sie können Ihren Rückstellungsbetrag jederzeit mit der Balance API prüfen:

Sehen Sie sich die folgende Beispielantwort an:

{
 "object": "balance",
 "available": [ ... ],
 "connect_reserved": [ ... ],
 "issuing": { ... },
 "issuing_credit_reserved": [
   {
   "amount": 9000,
   "currency": "usd"
   }
 ],
 "livemode": true,
 "pending": [ ... ]
}

Überfällige Einzahlungsverpflichtungen verwalten

Wenn Sie eine FundingObligation haben, die past_due ist, zieht Stripe zuerst einen Betrag aus Ihrer Rückstellung ab, um die FundingObligation zu begleichen. Stripe verwendet den Webhook issuing_funding_obligation.updated, um Sie zu benachrichtigen, und aktualisiert das FundingObligation-Objekt, um den von Ihrer Rückstellung zurückgezahlten Betrag anzuzeigen. Wenn Ihre Rückstellung den amount_outstanding der FundingObligation nicht vollständig decken kann, verbleibt die FundingObligation im Zustand past_due. Weitere Details und Auswirkungen finden Sie unter Überfällige Einzahlungsverpflichtungen.

Das Folgende zeigt eine FundingObligation, die vollständig aus der Rückstellung bezahlt wird:

{
 "id": "icfo_123"
 "amount_total": 95000000, // minor units
 "amount_outstanding": 0,
 "amount_paid": 95000000, // minor units
 "amount_paid_from_reserve": 95000000, // minor units
 "currency": "usd",
 "status": "paid",
 "due_at": "timestamp_on_t1",
 "paid_at": "timestamp_of_payment_with_reserve",
 "owed_to": "stripe",
 "grace_period_ends_at": "timestamp_on_t2",
 …,
}

Stripe stellt ein BalanceTransfer-Objekt und zugehörige BalanceTransactions bereit, um die automatische Übertragung von Geldern von Ihrem Rückstellungssaldo zu Ihrem Issuing-Guthaben darzustellen.

Sehen Sie sich die folgende Beispielantwort an:

{
 "id": "btr_1MinsBCq7itcH1tbDkk4sY8w",
 "object": "balance_transfer",
 "amount": 10000,
 "currency": "usd",
 "destination_balance": {
   "issuing": {
     "balance_transaction": "txn_123_inbound"
   },
   "type": "issuing"
 },
 ...
 "source_balance": {
   "issuing_credit_reserved": {
     "balance_transaction": "txn_123_outbound"
   },
   "type": "issuing_credit_reserved"
 }
}

Sehen Sie sich die folgende Beispielantwort an:

{
 "id": "txn_123_outbound",
 "object": "balance_transaction",
 "amount": 100,
 "currency": "usd",
 ...
 "type": "balance_transfer_outbound",
 "balance_type": "issuing_credit_reserved",
 "reporting_category": "issuing_credit_reserved_funds"
}


{
 "id": "txn_123_inbound",
 "object": "balance_transaction",
 "amount": 100,
 "currency": "usd",
 ...
 "type": "balance_transfer_inbound",
 "balance_type": "issuing",
 "reporting_category": "issuing_credit_reserved_funds"
}

Gelder aus Ihrer Rückstellung auszahlen

Stripe unterstützt die Auszahlung von Geldern aus Ihrem Rückstellungsguthaben. Sie können dies tun, um Ihren current_exposure_limit_amount zu senken, bevor Sie weniger Geld ausgeben, um kapitaleffizienter zu sein. Sie können den Endpoint v1/payout verwenden, wobei source_type auf issuing_credit_reserved festgelegt ist.

Vorsicht

Command Line
curl https://api.stripe.com/v1/payouts \
  -u "sk_**:" \
  -d amount=100000000 \
  -d currency=usd \
  -d source_type=issuing_credit_reserved

Nachdem Sie eine Auszahlung erstellt haben, sendet Stripe sofort einen Webhook, der darauf hinweist, dass der Rückstellungsbetrag des Issuing-Guthabens die erstellte Auszahlung widerspiegelt. Sehen Sie sich die folgende Beispielantwort an:

curl https://api.stripe.com/v1/balance -u "sk_**:" -H "Stripe-Version: 2024-06-20; issuing_credit_beta=v2"
{
  // other fields,
  "issuing_credit_reserved": [
    {
      "amount": 1233333300,
      "currency": "usd"
    }
  ],

}

Das Credit Policy-Objekt spiegelt die neueste Risikogrenze wider, und Sie erhalten den Webhook issuing_credit_policy.updated, der Sie über die neuen Risikogrenzen informiert.

Sehen Sie sich die folgende Beispielantwort an:

curl https://api.stripe.com/v1/issuing/credit_policy -u "sk_***:" -H "Stripe-Version: 2024-06-20; issuing_credit_beta=v2"


{
  "object": "issuing.credit_policy",
   "current_exposure_limit_amount": 11359999920 ,
   "reserve_multiplier_decimal": "2.4",
   "max_exposure_limit_amount": 13133333300,
   "funded_reserve_amount": 4733333300,
    // other fields
}

Sehen Sie sich die folgende Beispielantwort an:

{
 "object": {
  "object": "issuing.credit_policy",
  "credit_period_ends_on_days": null,
  "credit_period_interval": "day",
  "credit_period_interval_count": 1,
  "current_exposure_limit_amount": 240,
  "days_until_due": 0,
  "exposure_limit_currency": "usd",
  "funded_reserve_amount": 200,
  "last_effective_attributes": {
   "credit_period_ends_on_days": null,
   "credit_period_interval": "day",
   "credit_period_interval_count": 1,
   "current_exposure_limit_amount": 103,
   "days_until_due": 0,
   "effective_until": 1728763199,
   "max_exposure_limit_amount": 103,
   "reserve_multiplier_decimal": "1.300",
   "status": "active"
  }}}

Wenn Sie Ihre Auszahlungsanfrage im obigen Beispiel von Dienstag bis Freitag vor 10:00 Uhr UTC einreichen, wird die Überweisung bis zum Ende desselben Geschäftstags ausgezahlt. Wenn Sie Ihre Auszahlungsanfrage nach dieser Frist einreichen, wird sie höchstwahrscheinlich bis zum Ende des nächsten Geschäftstags ausgezahlt. Montags oder nach einem Feiertagswochenende kommt es zusätzlich zu einer eintägigen Verzögerung. Selbst wenn Sie die Auszahlung vor 10:00 Uhr UTC veranlassen, wird die Überweisung am Ende des übernächsten Werktags ausgezahlt.

Verfügbarer Ausgabebetrag des Kartenprogramms

Verwenden Sie die folgende Formel, um ein Feld oder einen Saldo hinzuzufügen, der den Betrag anzeigt, der Ihrem Kartenprogramm zum Ausgeben zur Verfügung steht:

Verfügbares Guthaben = `max_exposure_limit` + Guthaben in Issuing (Guthaben in Issuing kann negativ sein aufgrund zusätzlicher, durch die Risikogrenze zugelassener Ausgaben)

Autorisierung wird bei Nachfinanzierung abgelehnt

Bei Nachfinanzierung können Autorisierungen aus folgenden Gründen abgelehnt werden:

FundingObligations ist past_due
Sie überschreiten Ihren max_exposure_limit_amount

Ablehnungen für überfällige Einzahlungsverpflichtungen

Stripe lehnt Autorisierungen ab, wenn eine FundingObligation über die im grace_period_ends_at-Zeitstempel der FundingObligation definierte Nachfrist über past_due hinausgegangen ist. Sie finden den Parameter grace_period_ends_at im folgenden Beispiel:

{
 "id": "icfo_123",
 "amount_total": 95000000, // minor units
 "amount_outstanding": 95000000, // minor units
 "amount_paid": 0,
 "currency": "usd",
 "status": "past_due",
 "due_at": "timestamp_on_t1",
 "paid_at": nil,
 "owed_to": "stripe",
 "grace_period_ends_at": "timestamp_on_t2",
 ...,
}

Wenn die Nachfrist verstrichen ist, lehnt Stripe Issuing Autorisierungen ab und versendet issuing_authorization.created-Ereignisse mit Folgendem:

{
 "id": "iauth_123",
 "object": "issuing_authorization",
 "approved": false,
 ...,
 "status": "closed",
 "request_history": [
   {
     "amount": 100, // minor units
     "approved": false,
     "reason": "past_due_funding_obligation_to_stripe",
     ...,
   }
 ]
}

Ablehnungen aufgrund der maximalen Risikogrenze

Stripe beginnt sofort mit der Ablehnung von Autorisierungen, wenn Sie Ihr max_exposure_limit erreichen oder überschreiten. Sie können Rückstellungen hinzufügen, um das Limit zu erhöhen und Ablehnungen zu vermeiden.

Wenn Sie Ihr max_exposure_limit überschreiten, lehnt Stripe Issuing Autorisierungen ab und sendet issuing_authorization.created-Ereignisse mit Folgendem:

{
 "id": "iauth_123",
 "object": "issuing_authorization",
 "approved": false,
 ...,
 "status": "closed",
 "request_history": [
   {
     "amount": 100, // minor units
     "approved": false,
     "reason": "platform_exposure_limit_exceeded",
     ...,
   }
 ]
}

E-Mail-Benachrichtigungen für die Nachfinanzierung für Ihre Plattform verwalten

Stripe sendet mehrere obligatorische E-Mail-Benachrichtigungen für die Nachfinanzierung. Sie können Schwellenwerte für die folgenden E-Mail-Benachrichtigungen in Ihren Einstellungen für Saldobenachrichtigungen verwalten und festlegen:

Benachrichtigung über eine von Stripe initiierte Rückstellung aufgrund einer nicht bezahlten FundingObligation.
Benachrichtigung über eine FundingObligation, die past_due wird, wenn Ihre Rückstellung nicht ausreicht, um diese zu abzudecken.
Benachrichtigung, dass Ihr negatives Guthaben in Issuing 90 % Ihres max_exposure_limit_amount überschritten hat.

Optional können Sie den Schwellenwert im Dashboard konfigurieren, um Benachrichtigungen zu erhalten, wenn das negative Issuing-Guthaben Ihrer Plattform einen prozentualen Schwellenwert Ihres current_exposure_limit überschreitet.