Weiter zum Inhalt
Konto erstellen
 oder
anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellen
Anmelden
ÜbersichtAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenZahlungen verwalten
Zahlungsmethoden
Zahlungsschnittstellen
Zahlungsszenarien
Präsenzzahlungen
Mehr als Zahlungen

Zahlungen per Przelewy24 akzeptieren

So akzeptieren Sie Przelewy24 (P24), die beliebteste Zahlungsmethode in Polen.

Vorsicht

Der Inhalt dieses Abschnitts bezieht sich auf ein Legacy-Produkt. Verwenden Sie den Leitfaden Zahlungen akzeptieren für den aktuellsten Integrationspfad. Auch wenn Stripe dieses Produkt jetzt noch unterstützt, kann sich dies ändern, wenn das Produkt nicht mehr unterstützt wird.

Bei Przelewy24 handelt es sich um eine Zahlungsmethode für die einmalige Nutzung, bei der Kundinnen/Kunden Ihre Zahlungen authentifizieren müssen. Bei Zahlungen mit Przelewy24 werden Kundinnen/Kunden zur Autorisierung der Zahlung von Ihrer Website weitergeleitet und dann wieder auf Ihre Website zurückgeleitet, wo Sie eine sofortige Benachrichtigung über den Erfolg oder das Fehlschlagen der Zahlung erhalten.

Stripe einrichten
Serverseitig

Zunächst benötigen Sie ein Stripe-Konto. Registrieren Sie sich jetzt.

Nutzen Sie unsere offiziellen Bibliotheken für den Zugriff auf die Stripe-API über Ihre Anwendung:

Command Line
Ruby
Python
PHP
Java
Node
Go
.NET
No results
# Available as a gem
sudo gem install stripe
Gemfile
Ruby
Python
PHP
Java
Node
Go
.NET
No results
# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

PaymentIntent erstellen
Serverseitig

Ein PaymentIntent stellt Ihre Absicht dar, Zahlungen von Kundinnen und Kunden einzuziehen, und dokumentiert den gesamten Zahlungsvorgang.

Erstellen Sie einen PaymentIntent auf Ihrem Server und geben Sie den einzuziehenden amount und die Währung eur oder pln an. Wenn Sie über einen bestehenden Payment Intents-Integration verfügen, fügen Sie p24 der Liste der Arten von Zahlungsmethoden hinzu.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node
Go
.NET
No results
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=pln \
  -d "payment_method_types[]"=p24

Statt das gesamte PaymentIntent-Objekt an Ihre App zu übergeben, übergeben Sie nur das Client-Geheimnis. Das Client-Geheimnis des PaymentIntent ist ein eindeutiger Schlüssel, mit dem Sie die Zahlung bestätigen und Zahlungsdetails auf dem Client aktualisieren können, ohne dass eine Manipulation vertraulicher Daten, wie beispielsweise des Zahlungsbetrags, möglich ist.

Zahlungsbeschreibungen bei Przelewy24

Sie können eine nutzerdefinierte Zahlungsbeschreibung festlegen, bevor Sie den PaymentIntent bestätigen. Bei Przelewy24 darf die Zahlungsbeschreibung in der Abrechnung maximal 14 Zeichen enthalten. Sie wird auf den Bankbelegen Ihrer Kundinnen/Kunden in der Zahlungsbeschreibung im Format /OPT/X/////P24-XXX-XXX-XXX {statement_descriptor} angezeigt, wobei /OPT/X/////P24-XXX-XXX-XXX eine eindeutige Referenz für die von Przelewy24 generierte Zahlung ist.

Angaben zur Zahlungsmethode erfassen
Clientseitig

Erfassen Sie mit Stripe Elements Zahlungsinformationen auf dem Client. Elements beinhaltet vorgefertigte Komponenten der Nutzeroberfläche zur Erfassung von Zahlungsdetails.

Ein Stripe Element enthält ein iframe, dass die Zahlungsdaten über eine HTTPS-Verbindung sicher an Stripe sendet. Die Adresse der Bezahlseite muss ebenfalls mit https:// beginnen, nicht mit http://, damit Ihre Integration funktioniert.

Sie können Ihre Integration ohne HTTPS testen. Dann müssen Sie das Protokoll aber aktivieren, bevor Sie Ihre ersten Live-Zahlungen empfangen.

Stripe Elements einrichten

Stripe Elements ist ein Feature von Stripe.js und steht damit automatisch zur Verfügung. Fügen Sie das Stripe.js-Skript auf Ihrer Zahlungsseite ein, indem Sie es in den head Ihrer HTML-Datei einbinden. Laden Sie Stripe.js immer direkt von js.stripe.com, um die PCI-Compliance zu gewährleisten. Fügen Sie das Skript nicht in ein Bundle ein und hosten Sie selbst keine Kopie davon.

checkout.html
<head>
  <title>Checkout</title>
  <script src="https://js.stripe.com/basil/stripe.js"></script>
</head>

Erstellen Sie auf Ihrer Checkout-Seite mit dem folgenden JavaScript eine Instanz von Elements:

const stripe = Stripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx'
);
const elements = stripe.elements();

p24Bank Element hinzufügen und konfigurieren

Weisen Sie Elements in Ihrem Zahlungsformular einen festen Platz zu. Erstellen Sie in Ihrem Zahlungsformular leere DOM-Nodes (Container) mit eindeutigen IDs und übergeben Sie diese IDs dann an Elements.

checkout.html
HTML
CSS
No results
<form id="payment-form">
  <div class="form-row">
    <label for="accountholder-name">
      Name
    </label>
    <input id="accountholder-name" name="accountholder-name">
  </div>
  <div class="form-row">
    <label for="accountholder-email">
      Email
    </label>
    <input id="accountholder-email" name="accountholder-email">
  </div>

  <div class="form-row">
    <!--
      Using a label with a for attribute that matches the ID of the
      Element container enables the Element to automatically gain focus
      when the customer clicks on the label.
    -->
    <label for="p24-bank-element">
      P24 Bank
    </label>
    <div id="p24-bank-element">
      <!-- A Stripe Element will be inserted here. -->
    </div>
  </div>

  <button>Submit Payment</button>

  <!-- Used to display form errors. -->
  <div id="error-message" role="alert"></div>
</form>

Wenn das oben erwähnte Formular geladen wurde, erstellen Sie eine Instanz des Elements p24Bank und verbinden Sie sie mit dem oben erstellten Element-Container:

const options = {
  // Custom styling can be passed to options when creating an Element
  style: {
    base: {
      padding: '10px 12px',
      color: '#32325d',
      fontSize: '16px',
      '::placeholder': {
        color: '#aab7c4'
      },
    },
  },
};

// Create an instance of the p24Bank Element
const p24Bank = elements.create('p24Bank', options);

// Add an instance of the p24Bank Element into
// the `p24-bank-element` <div>
p24Bank.mount('#p24-bank-element');

Die Elements sind vollständig anpassbar. Sie können Elements so konfigurieren, dass sie zum Erscheinungsbild Ihrer Website passen und den Bezahlvorgang für Ihre Kundinnen/Kunden weiter optimieren. Außerdem lassen sich verschiedene Eingabestatus konfigurieren, sodass z. B. sichtbar wird, wann der Fokus auf dem Element liegt.

Zahlung an Stripe senden
Clientseitig

Anstatt das gesamte PaymentIntent-Objekt an den Client zu senden, wird die Verwendung des Client-Geheimnisses empfohlen. Dies unterscheidet sich von Ihren API-Schlüsseln, die Stripe-API-Anfragen authentifizieren. Achten Sie auf einen vorsichtigen Umgang mit dem Client-Geheimnis, da mit ihm die Zahlung abgeschlossen werden kann. Es darf nicht protokolliert, in URLs eingebettet oder Personen außer dem Kunden/der Kundin selbst zugänglich gemacht werden.

Verwenden Sie stripe.confirmP24Payment, um die Weiterleitung von Ihrer Seite zu verarbeiten und die Zahlung zu ermöglichen. Fügen Sie dieser Funktion eine return_url hinzu, um das Ziel anzugeben, an das Nutzer/innen weitergeleitet werden, nachdem sie die Zahlung auf der Website oder in der App ihrer Bank durchgeführt haben.

client.js
const form = document.getElementById('payment-form');
const accountholderName = document.getElementById('accountholder-name');
const accountholderEmail = document.getElementById('accountholder-email');

form.addEventListener('submit', (event) => {
  event.preventDefault();

  // Redirects away from the client
  const {error} = await stripe.confirmP24Payment(
    '{{PAYMENT_INTENT_CLIENT_SECRET}}',
    {
      payment_method: {
        p24: p24Bank,
        billing_details: {
          name: accountholderName.value,
          email: accountholderEmail.value,
        },
      },
      payment_method_options: {
        p24: {
          // To be able to pass the `tos_shown_and_accepted` parameter, you must
          // ensure that the P24 regulations and information obligation consent
          // text is clearly visible to the customer. See
          // stripe.com/docs/payments/p24/accept-a-payment#requirements
          // for directions.
          tos_shown_and_accepted: true,
        }
      },
      return_url: 'https://example.com/checkout/complete',
    }
  );
});

Wenn Ihr Kunde/Ihre Kundin eine Zahlung übermittelt, leitet Stripe ihn an die return_url weiter und fügt die folgenden URL-Abfrageparameter ein. Die Rückgabeseite kann diese nutzen, um den Status des PaymentIntent abzurufen, damit der Kunde/die Kundin den Zahlungsstatus anzeigen kann.

Wenn Sie die return_url angeben, können Sie auch Ihre eigenen Abfrageparameter für die Verwendung auf der Rückgabeseite anhängen.

ParameterBeschreibung
payment_intentDie eindeutige ID für den PaymentIntent.
payment_intent_client_secretDas Client-Geheimnis des PaymentIntent-Objekts. Bei Abonnementintegrationen wird dieses client_secret auch über confirmation_secret im Invoice-Objekt sichtbar gemacht

Wenn Kundinnen und Kunden auf Ihre Seite weitergeleitet werden, können Sie payment_intent_client_secret nutzen, um den PaymentIntent abzufragen und Ihren Kundinnen und Kunden den Transaktionsstatus anzuzeigen.

Details zum Bankkonto, mit dem der/die Nutzer/in die Zahlung abgeschlossen hat, finden Sie in der zugehörigen Abbuchung unter der Eigenschaft payment_method_details.

{
  "charges": {
    "data": [
      {
        "payment_method_details": {
          "p24": {
            "bank": "inteligo",
            "reference": "P24 123-456-789",
            "verified_name": "JENNY ROSEN"
          },
          "type": "p24"
        },
        "id": "src_16xhynE8WzK49JbAs9M21jaR",
        "object": "source",
        "amount": 1099,

Integration testen

Wählen Sie aus der P24-Bankliste mit Ihren Test-API-Schlüsseln eine Bank aus. Wenn Sie die Zahlung bestätigt haben, werden Sie zu einer Testseite weitergeleitet, auf der Sie wählen können, ob die Zahlung erfolgreich sein oder fehlschlagen soll. Sie können die erfolgreiche Zahlung testen, indem Sie die Zahlung auf der Weiterleitungsseite autorisieren. Der PaymentIntent wechselt von requires_action zu succeeded.

Um den Fall zu testen, in dem Nutzer/innen sich nicht authentifizieren können, wählen Sie aus der Liste mit Ihren Test-API-Schlüsseln eine Bank aus. Klicken Sie auf der Weiterleitungsseite auf Testzahlung fehlgeschlagen. Ihr PaymentIntent wechselt von requires_action zu requires_payment_method.

Anforderungen von Przelewy24

Przelewy24 verlangt von Kundinnen und Kunden, dass sie den Nutzungsbedingungen von Przelewy24 zustimmen, um die Transaktion erfolgreich zu autorisieren. Daher werden die Kundinnen und Kunden zunächst auf eine Seite von Przelewy24 weitergeleitet, wo sie den Bedingungen zustimmen können. Wenn Sie diesen Zwischenschritt überspringen möchten, müssen Sie die Nutzungsbedingungen von Przelewy24 auf Ihrer Website anzeigen und die Zustimmung der Kundinnen und Kunden für Przelewy24 einholen. Anschließend können Sie die Zahlungsmethode p24[tos_shown_and_accepted] als Option festlegen.

AnforderungDetails

Zeigen Sie den Standard-Wortlaut der Nutzungsbedingungen von Przelewy24 mit Hyperlinks an.

Der folgende Text sollte für die Kund/innen deutlich sichtbar und mit entsprechenden Hyperlinks versehen sein:

Bankwerte

BanknameWert
Alior Bankalior_bank
Bank Millenniumbank_millennium
Bank Nowy BFG S.A.bank_nowy_bfg_sa
Bank Pekaobank_pekao_sa
Bank Pocztowyetransfer_pocztowy24
Banki Spółdzielczebanki_spbdzielcze
BLIKblik
BNP Paribasbnp_paribas
BOŚ (Bank Ochrony Środowiska)boz
Citi Handlowyciti_handlowy
Credit Agricolecredit_agricole
ING Bank Śląskiing
Inteligointeligo
mBankmbank_mtransfer
Nest Banknest_przelew
PKO Bank Polskipbac_z_ipko
Plus Bankplus_bank
Santander Bank Polskasantander_przelew24
Toyota Banktoyota_bank
VeloBankvelobank
Volkswagen Bankvolkswagen_bank
War diese Seite hilfreich?
JaNein