Verfügbares Guthaben und GeldbewegungenPrivate Vorschau

Erfahren Sie, wie Gelder fließen und wie Sie das Feld für den verfügbaren Kreditbetrag verwenden, um zu verhindern, dass die Autorisierung abgelehnt wird.

Verfügbares Guthaben eines Kontos abrufen

Jedes Mal, wenn ein Kunde/eine Kundin eine kartenbasierte Transaktion durchführt oder Sie eine Guthaben- oder Lastschriftanpassung vornehmen, ändert sich das verfügbare Guthaben des verbundenen Kontos. Das verfügbare Guthaben von Barbell stieg um 50 USD, nachdem die Anpassung des Prämienguthabens angewendet wurde. Sie können diese Erhöhung bestätigen und das neueste verfügbare Guthaben von Barbell ermitteln, indem Sie das Kreditbuch des Kontos mit dem folgenden Befehl abrufen:

Beispielantwort

{
  "credit_limit": 100000,
  "amount_pending": 10000,
  "obligations": {
    "accruing": 5000,
    "unpaid": 15000
  },
  "credit_available": 97000,
  "prefunded_available": ,
  "currency": "usd",
  "livemode": false
}

Stripe empfiehlt die Verwendung des Felds credit_available, das beim Aufruf des Endpoints credit_ledger zurückgegeben wird. Dieser Ansatz stellt sicher, dass Sie Ihren Kunden/Kundinnen immer den genauen Guthabenbetrag anzeigen, der ihnen noch zum Ausgeben zur Verfügung steht. Zusammen bestimmen credit_available und das Issuing-Guthaben Ihres Kunden/Ihrer Kundin, was ein verbundenes Konto zu jedem Zeitpunkt ausgeben kann. Stripe ermittelt so auch, ob eine Transaktionsautorisierungsanfrage auf der Grundlage der verfügbaren Mittel genehmigt oder abgelehnt wird.

Autorisierung wird aufgrund fehlenden Guthabens abgelehnt

Autorisierungen, die für ein verbundenes Konto mit einer CreditPolicy vorgenommen wurden, können aus folgenden Gründen abgelehnt werden:

Das verbundene Konto versucht, Ausgaben über das verfügbare Kreditlimit hinaus zu tätigen. In diesem Fall verfügt das verbundene Konto möglicherweise über unbezahlte FundingObligations, die das verfügbare Guthaben reduziert haben. Achten Sie darauf, dass die FundingObligations Ihres verbundenen Kontos immer auf dem neuesten Stand sind, um eine Ablehnung der Autorisierung zu verhindern.
Ihr verfügbares Issuing-Plattformkonto erreicht Null und das verfügbare Issuing-Guthaben Ihres verbundenen Kontos liegt ebenfalls bei Null. Stocken Sie Ihr Issuing-Konto ausreichend auf, um Ablehnungen zu vermeiden.

Geldbewegungen nachverfolgen

Sie müssen Ihren verbundenen Konten keinen Zugriff auf ein Guthabenkonto gewähren. Möglicherweise sollten Sie jedoch den Status von Autorisierungen, Transaktionen und Überweisungen verfolgen, die erstellt werden, wenn ein verbundenes Konto von Ihrer Plattform ausgezahlte Beträge ausgibt.

Gehen Sie von folgendem Ausgangsstatus aus:

Konto	Guthaben in Issuing
Issuing-Konto von Gymbox (Plattform)	70 USD
Issuing-Guthaben von Barbell (verbundenes Konto)	0 USD

Autorisierungen

Barbell, das bei Gymbox eine CreditPolicy mit einem credit_limit_amount von 100 USD eingerichtet hat, gibt 10 USD aus. Dies führt zu einer Autorisierung von 10 USD auf dem Konto von Barbell:

{
  "id": "iauth_1JVXl82eZvKYlo2CPIiWlzrn",
  "object": "issuing.authorization",
  "amount": 1000,
  "currency": "usd",
  "approved": true,
  "authorization_method": "online",
  "balance_transactions": [
      {
        "id": "txn_1234XYZ",
        "object": "balance_transaction",
        "amount": -1000,
        "type": "issuing_authorization_hold",
        ...
      }
  ],
  "card": {...},
  ...
}

Gleichzeitig wird dadurch das Issuing-Guthaben von Gymbox in derselben Höhe zurückgehalten. So wird sichergestellt, dass die Gelder zurückgestellt sind und nicht für Transaktionen durch die anderen verbundenen Konten von Gymbox verwendet werden können:

{
  "id": "txn_1Mgr6fXpL7qsPGZtDwrMkq3S",
  "object": "balance_transaction",
  "amount": -1000,
  "available_on": 1677682692,
  "created": 1677682692,
  "currency": "usd",
  "description": "Platform hold for authorization (account: acct_1MgC5JRcH5icH3Nz, authorization: iauth_1Mgr6dRcH5icH3NzezZCHnJF)",
  "exchange_rate": null,
  "fee": 0,
  "fee_details": [],
  "net": -1000,
  "reporting_category": "issuing_authorization_hold",
  "source": {
    "id": "iph_1Mgr6eXpL7qsPGZtAMb7x0N6",
    "object": "issuing.platform_hold",
    "amount": 1000,
    "currency": "usd",
    "originating_account": "acct_1MgC5JRcH5icH3Nz",
    "originating_authorization": "iauth_1Mgr6dRcH5icH3NzezZCHnJF",
    "originating_balance_transaction": "txn_1Mgr6dRcH5icH3NzYGRkgcn7"
  },
  "status": "available",
  "type": "issuing_authorization_hold"
}

Der Saldo beträgt nun:

Konto	Guthaben in Issuing
Issuing-Konto von Gymbox (Plattform)	60 USD
Issuing-Guthaben von Barbell (verbundenes Konto)	-10 USD

Übertragungen und Transaktionserfassungen

Bevor Issuing-Autorisierungen erfasst und Issuing-Transaktionen erstellt werden, werden Gelder auf die verbundenen Konten übertragen. Anschließend werden die Rückstellungen von der Plattform freigegeben.

Auf dem Konto von Barbell wurde die Autorisierung aktualisiert und geschlossen, wodurch die zurückgehaltenen Gelder freigegeben wurden:

{
  "id": "iauth_1JVXl82eZvKYlo2CPIiWlzrn",
  "object": "issuing.authorization",
  "amount": 1000,
  "currency": "usd",
  "approved": true,
  "authorization_method": "online",
  "balance_transactions": [
      {
        "id": "txn_1234XYZ",
        "object": "balance_transaction",
        "amount": -1000,
        "type": "issuing_authorization_hold",
        ...
      },
      {
        "id": "txn_4t355646t54w2",
        "object": "balance_transaction",
        "amount": 1000,
        "type": "issuing_authorization_release",
      },
  ],
  "card": {...},
  "status": "closed",
  "transactions": [
      {
        "id": "ipi_1032HU2eZvKYlo2CEPtcnUvl",
        "object": "issuing.transaction",
        "amount": -1000,
        "authorization": "iauth_1JVXl82eZvKYlo2CPIiWlzrn",
        "balance_transaction": "txn_1345r1KCr4trgtrg0WfNdUCbG1w",
        ...
     }
  ...
}

Die auf dem Konto der Plattform zurückgehaltenen Gelder werden ebenfalls freigegeben:

{
  "id": "txn_1Mgr6fXpL7qsPGZtDwrPz7bA",
  "object": "balance_transaction",
  "amount": 1000,
  "available_on": 1677682692,
  "created": 1677682692,
  "currency": "usd",
  "description": "Released platform hold for authorization (account: acct_1MgC5JRcH5icH3Nz, authorization: iauth_1Mgr6dRcH5icH3NzezZCHnJF)",
  "exchange_rate": null,
  "fee": 0,
  "fee_details": [],
  "net": 1000,
  "reporting_category": "issuing_authorization_hold",
  "source": {
    "id": "iph_1Mgr6eXpL7qsPGZtAMb7m8Z3",
    "object": "issuing.platform_hold",
    "amount": -1000,
    "currency": "usd",
    "originating_account": "acct_1MgC5JRcH5icH3Nz",
    "originating_authorization": "iauth_1Mgr6dRcH5icH3NzezZCHnJF",
    "originating_balance_transaction": "txn_1Mgr6dRcH5icH3NzYGR7bA4c"
  },
  "status": "available",
  "type": "issuing_authorization_hold"
}

Stripe überträgt Gelder von Gymbox auf das Issuing-Konto von Barbell und ein Transfer-Objekt wird erstellt:

{
  "id": "tr_3JeQsp2eZvKYlo2C13DagtB0",
  "object": "transfer",
  "amount": 1000,
  "amount_reversed": 0,
  "balance_transaction": "txn_1032HU2eZvKYlo2CEPtcnUvl",
  "created": 1646912059,
  "currency": "usd",
  "description": null,
  "destination": "acct_1032D82eZvKYlo2C",
  "livemode": true,
  "metadata": {},
  "reversals": {
    "object": "list",
    "data": [],
    "has_more": false,
    "url": "/v1/transfers/tr_3JeQsp2eZvKYlo2C13DagtB0/reversals"
  },
  "reversed": false,
  "source_transaction": null,
  "issuing_transaction": "ipi_1032HU2eZvKYlo2CEPtcnUvl",
  "metadata": {},
  "source_balance": {
    "type": "issuing",
  },
  // New destination_balance returned field links to the BT on the connected account side
  "destination_balance": {
    "type": "issuing",
    "issuing": {
      "balance_transaction": "txn_123",
    },
  },
  // ... other fields ...
}

Diese Abfolge von Einbehaltung, Freigabe und Übertragung erfolgt, bevor Stripe die zugehörige Issuing-Transaktion erstellt. Das Guthaben beträgt jetzt:

Konto	Guthaben in Issuing
Issuing-Konto von Gymbox (Plattform)	60 USD
Issuing-Guthaben von Barbell (verbundenes Konto)	0 USD

Wenn für eine Transaktion keine Originalautorisierung vorliegt und das verbundene Konto nicht über ausreichende Mittel verfügt, um diese abzudecken, erfolgt die Übertragung des Plattformguthabens und die Erstellung der Transaktion dennoch.

Rückerstattungen

Wenn ein verbundenes Konto eine Rückerstattung erhält, versucht Stripe festzustellen, ob es sich um eine Transaktion handelt, die aus dem Guthaben dieses verbundenen Kontos oder dem Plattformkonto finanziert wird. Wenn Stripe feststellt, dass die Finanzierung aus dem Guthaben des verbundenen Kontos erfolgt, wird das Geld wieder dem Guthaben des verbundenen Kontos gutgeschrieben. Wenn die Transaktion vom Konto der Plattform finanziert wird (z. B. vom Kreditrahmen des verbundenen Kontos), reduziert sich die FundingObligation des verbundenen Kontos um diesen Betrag. Die Rückerstattung wird dann auf das Konto der Plattform überwiesen, da die Plattform Stripe bereits im Namen des verbundenen Kontos für die Transaktion bezahlt hat.

Nehmen wir an, Barbell hat eine FundingObligation in Höhe von 100 USD hat. Wenn der Betrag zurückerstattet wird, dann:

Die FundingObligation von Barbell wird von 100 auf 0 USD gesenkt
Die 100 USD werden auf das Issuing-Konto von Gymbox überwiesen, wodurch das Plattformguthaben um 100 USD erhöht wird.

Es ist möglich, dass der Parameter amount_total einer FundingObligation negativ ist. Dies kommt vor, wenn die einzige Transaktion in einem Kreditzeitraum eine Rückerstattung ist und keine anderen Kartenausgaben erfolgen. Die FundingObligation weist den Status Needs refund auf. Eine negative FundingObligation kann auftreten, wenn Kartenausgaben anfallen, der vollständige Rückerstattungsbetrag diese jedoch übersteigt.

Anfechtungen

Wenn eine Kundin/ein Kunde eine Ausgabe-Transaktion für ein verbundenes Konto anficht, erfolgt die Anfechtung wie unter Anfechtungen in Issuing beschrieben. Verlorene Anfechtungen führen zu keiner Aktion (es werden keine Gutschriften an das verbundene Konto ausgestellt). Bei zu Ihren Gunsten entschiedenen Anfechtungen wird dem verbundenen Konto auf die gleiche Weise eine Gutschrift ausgestellt, wie im Abschnitt Rückerstattungen beschrieben.

Autorisierung abgelehnt

Autorisierungen, die für ein verbundenes Konto mit einer CreditPolicy vorgenommen wurden, können aus folgenden Gründen abgelehnt werden:

Das verbundene Konto versucht, Ausgaben über das verfügbare Kreditlimit hinaus zu tätigen. In diesem Fall verfügt das verbundene Konto möglicherweise über unbezahlte FundingObligations, die das verfügbare Guthaben reduziert haben. Achten Sie darauf, dass die FundingObligations Ihres verbundenen Kontos immer auf dem neuesten Stand sind, um eine Ablehnung der Autorisierung zu verhindern.
Ihr verfügbares Issuing-Plattformkonto erreicht Null und das verfügbare Issuing-Guthaben Ihres verbundenen Kontos liegt ebenfalls bei Null. Stocken Sie Ihr Issuing-Konto ausreichend auf, um Ablehnungen zu vermeiden.