Accéder directement au contenu
Créez un compte
 ou
connecter-vous
Logo de la documentation Stripe
/
Créez un compte
Connectez-vous
AperçuMettre votre intégration à niveau
Paiements en ligne
PrésentationTrouver votre cas d'usageManaged Payments
Moyens de paiement
Interfaces de paiement
Scénarios de paiement
Paiements par TPE
Au-delà des paiements

Accepter un paiement Przelewy24

Découvrez comment accepter Przelewy24 (P24), le moyen de paiement le plus populaire en Pologne.

Mise en garde

Le contenu de cette section fait référence à un produit antérieur. Vous devez plutôt consulter le guide relatif à l’acceptation d’un paiement pour en savoir plus sur le chemin d’intégration le plus récent. Stripe prend toujours en charge ce produit, néanmoins cette prise en charge peut prendre fin si le produit devient obsolète.

Avec le moyen de paiement à usage unique Przelewy24, le client doit authentifier son paiement. Pour effectuer un paiement avec Przelewy24, votre client quitte votre site Web, autorise le paiement sur le site de Przelewy24, puis est redirigé vers votre site Web. Vous recevez alors une notification immédiate vous indiquant si le paiement a abouti ou s’il a échoué.

Configurer Stripe
Côté serveur

Pour commencer, il vous faut un compte Stripe. Créez votre compte Stripe.

Utilisez nos bibliothèques officielles pour accéder à l’API Stripe à partir de votre application :

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'

Créer un PaymentIntent
Côté serveur

Un PaymentIntent représente votre intention d’encaisser un paiement auprès d’un client et suit le cycle de vie du processus de paiement.

Créez un PaymentIntent sur votre serveur et précisez le montant à encaisser et la devise dans les paramètres amount, eur ou pln. Si vous avez déjà une intégration Payment Intents, ajoutez p24 à la liste des types de moyens de paiement.

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

Au lieu de transmettre à l’application la totalité de l’objet PaymentIntent, renvoyez sa clé secrète du client. Il s’agit d’une clé unique qui vous permet de confirmer le paiement et d’actualiser les informations de paiement côté client, le tout sans autoriser la manipulation d’informations sensibles comme le montant du paiement.

Libellés de relevé bancaire avec Przelewy24

Vous pouvez définir un libellé de relevé bancaire personnalisé avant de confirmer le PaymentIntent. Pour Przelewy24, le libellé de relevé bancaire est limité à 14 caractères. Il apparaît dans les documents bancaires de votre client dans la description du paiement, au format /OPT/X/////P24-XXX-XXX-XXX {statement_descriptor}, où /OPT/X/////P24-XXX-XXX-XXX constitue la référence unique du paiement généré par Przelewy24.

Collecter les informations du moyen de paiement
Côté client

Collectez les informations de paiement du client avec Stripe Elements. Elements est un ensemble de composants d’interface utilisateur préconfigurés pour la collecte des informations de paiement.

Un composant Element contient une balise iframe qui envoie de manière sécurisée les informations de paiement à Stripe par une connexion HTTPS. Pour que votre intégration fonctionne, l’adresse de votre page de règlement doit aussi commencer par https:// au lieu de http://.

Vous pouvez tester votre intégration sans utiliser le protocole HTTPS. Activez-le au moment d’accepter des paiements en mode production.

Configurer Stripe Elements

Stripe Elements est automatiquement disponible en tant que fonctionnalité de Stripe.js. Intégrez le script Stripe.js à votre page de paiement, entre les balises head de votre fichier HTML. Chargez toujours Stripe.js directement à partir de js.stripe.com pour maintenir votre conformité PCI. Vous ne devez pas inclure le script dans un lot ni en héberger de copie.

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

Créez une instance d’Elements à l’aide du code JavaScript suivant sur votre page de paiement :

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

Ajouter et configurer un Element p24Bank

Elements doit avoir un emplacement dédié dans votre formulaire de paiement. Créez des nœuds DOM (conteneurs) ayant des ID uniques dans votre formulaire de paiement, puis transmettez ces ID à 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>

Lorsque le formulaire ci-dessus est chargé, créez une instance du composant Element p24Bank et intégrez-la au conteneur Element précédemment créé :

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');

Les composants Element sont entièrement personnalisables. Vous pouvez personnaliser les composants Element pour qu’ils s’intègrent visuellement à votre site afin de fournir une expérience de paiement uniforme à vos clients. Il est également possible de styliser différents états de saisie (par exemple, lorsque le composant Element est sélectionné).

Envoyer le paiement à Stripe
Côté client

Plutôt que d’envoyer la totalité de l’objet PaymentIntent au client, utilisez sa clé secrète. Cette clé est distincte de vos clés API qui authentifient les requêtes à l’API Stripe. La clé secrète du client doit être utilisée avec prudence, car elle peut servir à finaliser le paiement. Elle ne doit être ni enregistrée, ni intégrée dans des URL, ni dévoilée à d’autres personnes que votre client.

Utilisez stripe.confirmP24Payment pour gérer la redirection hors de votre page et pour terminer le paiement. Ajoutez une URL return_url à cette fonction pour indiquer où Stripe doit rediriger l’utilisateur après qu’il a effectué le paiement sur le site Web ou l’application mobile de sa banque.

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',
    }
  );
});

Lorsque votre client effectue un paiement, Stripe le redirige vers l’URL return_url et inclut les paramètres de requête d’URL suivants. La page de redirection peut utiliser ces paramètres pour récupérer l’état du PaymentIntent et ainsi afficher l’état du paiement pour le client.

Lorsque vous spécifiez une URL return_url, vous pouvez également ajouter vos propres paramètres de requête à utiliser sur la page de redirection.

ParamètreDescription
payment_intentIdentifiant unique du PaymentIntent.
payment_intent_client_secretLa clé secrète du client de l’objet PaymentIntent. Pour les intégrations d’abonnements, le client_secret est également exposé sur l’objet Invoice via confirmation_secret

Lorsque le client est redirigé vers votre site, vous pouvez utiliser le payment_intent_client_secret pour interroger le PaymentIntent et communiquer l’état de la transaction à votre client.

Vous trouverez des informations sur le compte bancaire utilisé par le client en consultant la propriété payment_method_details du paiement.

{
  "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,

Tester votre intégration

À l’aide de vos clés API de test, sélectionnez une banque dans la liste des banques compatibles avec P24. Après avoir confirmé le paiement, vous serez redirigé vers une page de test proposant deux options : réussite ou échec du paiement. Vous pouvez tester la réussite du paiement en l’authentifiant sur la page de redirection. Le PaymentIntent passera alors de l’état requires_action à succeeded.

Pour tester un échec d’authentification de l’utilisateur, sélectionnez une banque à l’aide de vos clés API de test. Puis, sur la page de redirection, cliquez sur Fail test payment. Votre PaymentIntent passera alors de l’état requires_action à requires_payment_method.

Exigences relatives à Przelewy24

Przelewy24 exige que les clients acceptent ses Conditions d’utilisation du service pour autoriser la transaction. Le client sera donc d’abord redirigé vers une page Przelewy24 où il pourra accepter ces conditions. Pour ignorer cette page intermédiaire, vous devez afficher les Conditions de Przelewy24 sur votre site web et recueillir le consentement du client en son nom. Vous pouvez ensuite définir l’option de moyen de paiement p24[tos_shown_and_accepted].

ExigenceDétails

Afficher la formulation standard des Conditions d’utilisation du service de Przelewy24 avec des hyperliens.

Le texte suivant devrait être clairement visible pour le client, et les hyperliens inclus :

Valeurs bancaires

Nom de la banqueValeur
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
Cette page vous a-t-elle été utile ?
OuiNon