Recevez facilement des paiements en utilisant Stripe et PHP

Introduction

Souvent, nos applications nécessitent de fournir un moyen simple d'effectuer des paiements pour acheter des produits ou des services. Stripe peut être une bonne option pour recevoir des paiements. Dans cet article, nous allons apprendre comment créer un lien de paiement Stripe afin que vous puissiez rediriger vos utilisateurs vers ce lien pour envoyer leurs paiements.

Qu'est-ce que Stripe ?

Stripe est une entreprise technologique qui fournit des services de traitement des paiements en ligne, permettant aux entreprises d'accepter des paiements sur Internet. Il propose une suite d'outils et d'API qui permettent aux entreprises de gérer les transactions en ligne, les abonnements et d'autres tâches liées aux paiements.

Avant de commencer à écrire du code, nous devons comprendre les composants Stripe suivants :

• Produit : Un produit représente un bien ou un service que vous souhaitez vendre. Il comprend, entre autres, le nom, la description et les détails des prix.

• Prix : Un prix est une configuration tarifaire spécifique pour un produit. Il définit le montant qu'un client paiera pour un produit, ainsi que tous les détails de tarification supplémentaires tels que la devise, le cycle de facturation et les niveaux de tarification. A titre d'exemple, pour un service nommé « Adhésion à la communauté », vous pourriez avoir deux prix :

  • Annuel pour lequel les utilisateurs paieraient 50$ par an.
  • Mensuel pour lequel les utilisateurs paieraient 3,5 $ par mois.

• Lien de paiement : Un lien de paiement est une URL qui permet aux clients d'effectuer un paiement pour un prix spécifique. Lorsqu'un client clique sur un lien de paiement, il est redirigé vers une page de paiement hébergée par Stripe où il peut saisir ses informations de paiement et finaliser la transaction. Les liens de paiement peuvent être partagés par e-mail, via des applications de messagerie ou intégrés à votre site Web.

Les tarifs nous permettent également de définir le type de paiement qui peut être "récurrent" ou "one_time". Pour « l'exemple d'adhésion à une communauté », le paiement annuel pourrait être d'un seul type et le paiement mensuel pourrait être récurrent. Chaque année, les utilisateurs renouvelleraient (ou non) leur adhésion et choisiraient à nouveau le mode de paiement.

Installer le composant Stripe PHP

La bibliothèque php stripe peut être installée à l'aide de composer, donc, pour l'installer, il vous suffit d'exécuter la commande suivante dans le dossier racine de votre projet :

composer require stripe/stripe-php

Récupération de la clé API développeur

Avant de pouvoir récupérer votre clé API, vous devez être enregistré sur Stripe. Une fois inscrit, vous pouvez suivre les étapes suivantes :

• Connectez-vous à votre compte Stripe.
• Cliquez sur l'icône d'engrenage dans le coin supérieur droit de l'écran et sélectionnez « Développeurs ».
• Cliquez sur "Clés API" et vous pourrez les créer.

Créer un prix Stripe

Nous pouvons créer le prix Stripe en créant d'abord le produit, puis le prix ou en intégrant le nom du produit dans les options de prix. Codons-le en utilisant la première méthode afin que nous puissions voir tout le processus.

$stripe = new \Stripe\StripeClient(<your_stripe_api_key>);

$product = $stripe->products->create([
     'name' => 'Community Subscription',
     'description' => 'A Subscription to our community',
]);

$price  = $stripe->prices->create([
     'currency' => 'usd',
     'unit_amount' => 5025,
     'product': $product->id,
     'type' => 'one_time'
]);
</your_stripe_api_key>

Expliquons le code ci-dessus étape par étape :

• Nous créons un nouveau StripeClient en passant nos clés API Stripe.
• Ensuite, nous créons un nouveau produit nommé « Abonnement communautaire ».
• Enfin, nous créons un prix pour le produit récemment créé avec les caractéristiques suivantes :
  • Il utilise la devise USD.
  • Il référence le produit créé par son identifiant.
  • Le paiement ne sera pas récurrent.

Le paramètre unit_amount mérite une attention particulière. La documentation Stripe indique ce qui suit à propos de unit_amount : "Un entier positif en centimes (ou 0 pour un prix gratuit) représentant le montant à facturer." Cela signifie qu'il faut multiplier le prix par 100 pour le convertir en centimes avant de le passer au paramètre unit_amount. Par exemple, si le prix est de 10,99 $, nous définirons unit_amount sur 1 099. Il s'agit d'un piège courant, alors assurez-vous de revérifier votre code pour éviter tout problème de prix inattendu.

Par exemple, si vous avez une variable "$amount" qui contient une valeur flottante comme montant, vous pouvez coder quelque chose comme ceci :

$formattedAmount = (int)($amount * 100);

Créer le lien de paiement

Jusqu'à présent, nous avons un prix créé avec un montant correctement formaté. Il est maintenant temps de créer le lien de paiement.

$stripe = new \Stripe\StripeClient(<your_stripe_api_key>);
$paymentLink = $stripe->paymentLinks->create([
     'line_items' => [
        [
           'price' => $price->id,
           'quantity' => 1,
        ]
     ],
     'after_completion' => [
        'type' => 'redirect',
        'redirect' => [
           'url' => <your redirect link>
        ]
     ]
]);
</your></your_stripe_api_key>

Expliquons-le étape par étape :

• We create the StripeClient object as before.
• Then, we create the payment link by using the following options:
  • line_items: Here you can include all the items we want to add for selling. In this case we only add the created price and we only sell one unit.
  • after_completion: We instruct Stripe to redirect to an url after the payment is completed.

We could redirect to an intermediate url which could perform some stuff such as updating our database register payment. The following code shows a simple Symfony controller which would perform the required tasks and then would redirect to the final url where the user will see that the payment has been completed.

class StripeController extends AbstractController
{

    #[Route('/confirm-payment', name: 'confirm-payment', methods: ['GET'])]
    public function confirmPayment(Request $request): Response
    {
        // Here you perform the necessary stuff
        $succeedUrl = '...';
        return new RedirectResponse($succeedUrl);
    }
}

After we have created the PaymentLink object, we can access the string payment url by the url property:

$paymentUrl = $paymentLink->url;

Conclusion

In this post we have learned how to configure our php backend to easily accept payments with stripe using the stripe-php component.
Processing the payments in your php backend offers some advantages such as:

• Keep sensitive payment information, such as the API keys, secure.
• Gives more control over the payment flow and allows for greater flexibility in handling different payment scenarios.

If you like my content and enjoy reading it and you are interested in learning more about PHP, you can read my ebook about how to create an operation-oriented API using PHP and the Symfony Framework. You can find it here: Building an Operation-Oriented Api using PHP and the Symfony Framework: A step-by-step guide

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!