Kartenzahlungen über die Charges APILegacy

Die Charges API und die Tokens API sind Legacy-APIs, die in älteren Stripe-Integrationen verwendet werden, um Debit- und Kreditkartenzahlungen zu akzeptieren. Verwenden Sie PaymentIntents für neue Integrationen.

Die Charges API beschränkt Ihre Möglichkeiten zur Nutzung von Stripe-Funktionen. Um die neuesten Funktionen nutzen zu können, verwenden Sie Stripe Checkout oder migrieren Sie zur Payment Intents API.

Zahlungsablauf

In den meisten Fällen bietet die PaymentIntents API mehr Flexibilität und Integrationsmöglichkeiten.

Rückerstattungen

Um eine Zahlung über die API zu erstatten, erstellen Sie eine Rückerstattung und geben Sie die ID der zu erstattenden Zahlung an.

curl https://api.stripe.com/v1/refunds \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d charge={{CHARGE_ID}}

Um einen Teil einer Zahlung zu erstatten, geben Sie einen amount-Parameter als Ganzzahl in Cent (oder in der kleinsten Währungseinheit der Abbuchungswährung) an.

curl https://api.stripe.com/v1/refunds \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d charge={{CHARGE_ID}} \
  -d amount=1000

Apple Pay

Wenn Ihr/e Kund/in die Zahlung genehmigt, empfängt Ihre App eine PKPayment-Instanz mit den verschlüsselten Kartendaten des/der Kund/in, indem die PKPaymentAuthorizationViewControllerDelegate-Methoden implementiert werden.

1. Verwenden Sie die createTokenWithPayment SDK-Methode, um PKPayment in einen Stripe Tokenumzuwandeln
2. Verwenden Sie dieses Token, um eine Zahlung zu erstellen.

extension CheckoutViewController: PKPaymentAuthorizationViewControllerDelegate {

    func paymentAuthorizationViewController(_ controller: PKPaymentAuthorizationViewController, didAuthorizePayment payment: PKPayment, handler: @escaping (PKPaymentAuthorizationResult) -> Void) {
        // Convert the PKPayment into a Token
        STPAPIClient.shared.createToken(withPayment: payment) { token, error in
              guard let token = token else {
                  // Handle the error
                  return
              }
            let tokenID = token.tokenId
            // Send the token identifier to your server to create a Charge...
            // If the server responds successfully, set self.paymentSucceeded to YES
        }
    }

    func paymentAuthorizationViewControllerDidFinish(_ controller: PKPaymentAuthorizationViewController) {

Dynamische Zahlungsbeschreibung in der Abrechnung

Immer wenn Sie eine Karte belasten, wird in der Abrechnung der Kundinnen und Kunden standardmäßig die Zahlungsbeschreibung Ihres Stripe-Kontos angezeigt. Darüber hinaus können Sie mit dem Argument statement_descriptor im jeweiligen Charge-Objekt die Zahlungsbeschreibung in der Abrechnung bei jeder Zahlungsanfrage dynamisch festlegen.

curl https://api.stripe.com/v1/charges \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "amount"=999 \
  -d "currency"="usd" \
  -d "description"="Example charge" \
  -d "source"="tok_visa" \
  -d "statement_descriptor"="Custom descriptor"

Die Zahlungsbeschreibung in der Abrechnung ist auf 22 Zeichen begrenzt. Sie darf die Sonderzeichen <, >, ', " oder * nicht enthalten und nicht ausschließlich aus Ziffern bestehen.

Wenn Sie die Zahlungsbeschreibung in der Abrechnung bei Kredit- und Debitkartenzahlungen dynamisch festlegen, wird der dynamische Teil an die Zahlungsbeschreibung des Abwicklungshändlers angehängt (getrennt durch ein * und ein Leerzeichen). Die Zahlungsbeschreibung eines Unternehmens mit dem Namen FreeCookies, aus der die Art der gekauften Kekse hervorgehen soll, könnte beispielsweise FREECOOKIES* SUGAR lauten.

Das * und das Leerzeichen werden ebenfalls von den maximal zulässigen 22 Zeichen abgezogen, und Stripe vergibt automatisch 10 Zeichen für die dynamische Zahlungsbeschreibung. In der Folge könnte ein Teil der Zahlungsbeschreibung des Abwicklungshändlers abgeschnitten werden, wenn diese länger als 10 Zeichen ist (vorausgesetzt, die dynamische Zahlungsbeschreibung ist ebenfalls länger als 10 Zeichen). Wenn die dynamische Zahlungsbeschreibung in der Abrechnung länger als 10 Zeichen ist, werden beide Beschreibungen nach 10 Zeichen abgeschnitten.

Wenn Sie Probleme mit den Zeichenbeschränkungen haben, können Sie im Stripe-Dashboard eine verkürzte Zahlungsbeschreibung festlegen, damit die Zahlungsbeschreibung des Abwicklungshändlers kürzer ist. Dadurch erhält die dynamische Zahlungsbeschreibung mehr Platz. Die gekürzte Zahlungsbeschreibung:

• Ersetzt die Zahlungsbeschreibung des Abwicklungshändlers, wenn dynamische Zahlungsbeschreibungen verwendet werden.
• Kann zwischen 2 und 10 Zeichen lang sein.

Wie die Zahlungsbeschreibung nach der Kombination der beiden Elemente aussehen wird, können Sie im Stripe-Dashboard überprüfen.

Informationen in Metadaten speichern

Für die meisten gängigen Anforderungen, beispielsweise die Zahlungsverarbeitung, unterstützt Stripe das Hinzufügen von Metadaten. Metadaten sind für Kundinnen/Kunden nicht sichtbar und fließen auch nicht in die Kriterien ein, ob eine Zahlung durch unsere Betrugsprävention abgelehnt oder gesperrt wird.

Mithilfe von Metadaten können Sie sonstige Informationen, die für Ihre Abläufe wichtig sind, mit Stripe-Aktivitäten verknüpfen. Alle Metadaten, die Sie angeben, lassen sich im Dashboard (beispielsweise auf der Detailseite einer Zahlung) anzeigen und stehen auch in allgemeinen Berichten und Exporten zur Verfügung. Zum Beispiel können Sie Ihre Zahlungen mit Bestell-IDs versehen, damit Sie, Ihre Buchhaltung oder Ihr/e Steuerberater/in die Zahlungen in Stripe den jeweiligen Bestellungen in Ihrem System zuordnen können.

Wenn Sie Radar nutzen, sollten Sie in Erwägung ziehen, alle zusätzlichen Kunden- und Bestellinformationen als Metadaten zu übergeben. Auf diese Weise können Sie Radar-Regeln mit Metadatenattributen erstellen und haben im Dashboard mehr Informationen zur Verfügung, wodurch Ihr Überprüfungsvorgang beschleunigt werden kann.

curl https://api.stripe.com/v1/charges \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "amount"=999 \
  -d "currency"="usd" \
  -d "description"="Example charge" \
  -d "source"="tok_visa" \
  -d "metadata[order_id]"=6735

Abgelehnte Zahlungen

Wenn Sie möchten, dass Ihre Integration automatisch auf fehlgeschlagene Zahlungen reagiert, haben Sie zwei Optionen, auf das outcome einer Zahlung zuzugreifen.

• Verwalten Sie den API-Fehler, der bei einer fehlgeschlagenen Zahlung zurückgegeben wird. Für gesperrte und von Kartenausstellern und -ausstellerinnen abgelehnte Zahlungen, enthält der Fehler die Zahlungs-ID, die Sie dann verwenden können, um die Zahlung abzurufen.
• Verwenden Sie Webhooks, um Statusaktualisierungen zu überwachen. Das Ereignis charge.failed wird zum Beispiel ausgelöst, wenn eine Zahlung nicht erfolgreich war.