Adhésions à la caissière de Laravel

Dans ce tutoriel, nous allons voir à quel point il est facile de créer un site Web d'adhésion payant de base à l'aide du package de caissier Laravel. Vous pouvez voir une démo de l'application ici et télécharger le code source ici.

Les plats clés

• Laravel Cackier simplifie la création d'un site Web d'adhésion rémunéré de base en gérant la facturation de l'abonnement, la gestion des coupons, échangeant des abonnements, les périodes de grâce d'annulation et générant des PDF de facture.
• Pour intégrer le caissier Laravel dans un projet Laravel existant, installez le package via le compositeur, exécutez une migration pour ajouter les colonnes nécessaires à la table des utilisateurs, configurez les touches API et ajoutez le trait facturable au modèle.
• Laravel Caissier peut gérer automatiquement les paiements en réessayant le paiement. Si le paiement continue d'échouer, l'abonnement sera annulé.
• Laravel Caissier ne prend actuellement en charge que Stripe et Braintree, mais peut être étendu pour travailler avec d'autres passerelles de paiement avec une bonne compréhension de Laravel et de l'API de la passerelle de paiement.

Configuration d'un environnement de travail

Nous devons créer un projet Boilreplate pour commencer, et nous pouvons le faire de deux manières différentes:

• Nous pouvons cloner le repo github dans notre dossier de projet.
• En supposant que le compositeur a installé le compositeur (cochez le guide d'installation pour plus de détails).
  Nous exécutons le compositeur créant-project de Laravel / Laravel Laravel_membership --Prefer-Dist, cela créera un projet de buissier Laravel dans notre dossier Laravel_Membership.

Maintenant, nous devons exiger le package de caissier Laravel au projet en ajoutant "Laravel / Caissier": "~ 1.0" à notre composer.json sur la section Required et exécutez la mise à jour du composer pour mettre à jour nos dépendances.

Après cela, nous devons dire à notre application de charger la classe de fournisseur de services de caissier. Nous pouvons le faire en ajoutant "LaravelcashierCashierServiceProvider" au tableau des fournisseurs sur le fichier config / app.php.

Remarque: vous devez exécuter le compositeur Dump-Autoload pour mettre à jour le package ClassMap.

Création de la base de données à l'aide de migrations

Si vous êtes nouveau dans les migrations de Laravel, assurez-vous de vérifier la documentation.
Nous allons utiliser deux tables:

Posts Tableau:
- int id
- Titre de la chaîne
- contenu long_text
- bool is_premium

Tableau des utilisateurs:
- int id
- Varchar (60) Email
- Varchar (60) Mot de passe

L'outil Laravel Artisan Command Line facilite la création et la gestion des classes de migration.

<span>php artisan migrate:make create_posts_table --create="posts"
</span><span>
</span><span>php artisan migrate:make create_users_table --create="users"</span>

Et puis nous remplissons le schéma :: Créer un argument de la fonction de rappel avec le code nécessaire qui ressemble à ceci

<span>Schema::create('posts', function(Blueprint $table)
</span><span>{
</span><span>    $table->increments('id');
</span><span>    $table->string('title');
</span><span>    $table->longText('content');
</span><span>    $table->boolean("is_premium");
</span><span>    $table->timestamps();
</span><span>});
</span><span>
</span><span>Schema::create('users', function(Blueprint $table)
</span><span>{
</span><span>    $table->increments('id');
</span><span>    $table->string('email', 100)->unique();
</span><span>    $table->string('password', 60);
</span><span>    $table->timestamps();
</span><span>});</span>

Pour informer le caissier de Laravel sur notre tableau facturable, nous devons créer une migration spécifique pour cela. Laravel Cashier a une commande intégrée à cette fin.

<span>php artisan cashier:table users</span>

Maintenant, nous sommes prêts à migrer notre base de données

<span>php artisan migrate:make create_posts_table --create="posts"
</span><span>
</span><span>php artisan migrate:make create_users_table --create="users"</span>

Si vous ouvrez le tableau de votre utilisateur, vous verrez un tas de champs ajoutés lorsque la migration du package est exécutée.
- Stripe_active si vous avez un abonnement actif.
- ID utilisateur Stripe_id sur le serveur Stripe.
- Plan d'abonnement Stripe_Plan Stripe.
- Carte de crédit Last_Four quatre derniers chiffres.
- Trial_ends_at Une date de fin est stockée si vous spécifiez une période d'essai.
- Abonnement_ends_at Date de fin de l'abonnement.

Maintenant, nous allons semer la base de données avec des données factices pour commencer; Vérifiez le résultat final sur github.

Processus de facturation à rayures

traiter avec le paiement peut être une douleur dans le cou, et Stripe peut vous aider avec cela, ils utilisent des jetons au lieu de numéros de carte, etc., et c'est ainsi que vous pouvez vous assurer que vos clients restent en sécurité tout en payant pour votre service .

Remarque: Vérifiez si la bande est prise en charge dans votre pays, mais vous pouvez toujours l'utiliser pour tester sinon

Pour commencer, nous devons d'abord obtenir un compte. Stripe n'a pas de frais mensuels pour l'abonnement, vous ne payez que lorsque vous êtes payé.

Maintenant, après avoir obtenu un compte, vous devez créer des plans pour votre application (mensuellement, annuelle, argent, or…).

Chaque domaine s'explique auto, donc créons une adhésion à l'or qui coûtera 40 $ et un abonnement de base pour 10 $. Ils seront facturés chaque mois.

Nous avons déjà ajouté les colonnes nécessaires à la table de notre utilisateur, nous devons maintenant faire savoir à Laravel Cackier que nous utiliserons la classe d'utilisateurs comme classe de facturation.

<span>Schema::create('posts', function(Blueprint $table)
</span><span>{
</span><span>    $table->increments('id');
</span><span>    $table->string('title');
</span><span>    $table->longText('content');
</span><span>    $table->boolean("is_premium");
</span><span>    $table->timestamps();
</span><span>});
</span><span>
</span><span>Schema::create('users', function(Blueprint $table)
</span><span>{
</span><span>    $table->increments('id');
</span><span>    $table->string('email', 100)->unique();
</span><span>    $table->string('password', 60);
</span><span>    $table->timestamps();
</span><span>});</span>

Remarque: nous utilisons Billabletrait et les traits nécessitent un PHP 5.4 ou plus.

Maintenant, nous devons définir notre clé d'accès API Stripe, que vous pouvez obtenir à partir de votre compte> Paramètres de compte> Clés API et copier votre clé de secrét

En utilisant la méthode Billabletraitt, nous avons accès à la méthode utilisateur :: setStripekey (clé) qui peut être appelée n'importe où dans notre code, mais la manière préférée est de créer un fichier Service.php sous votre répertoire de configuration et renvoyer un tableau comme Ceci:

<span>php artisan cashier:table users</span>

Lorsque Gettripekey essaie de charger votre clé, il recherchera une propriété appelée Stripekey. Si cela n'est pas trouvé, il chargera automatiquement votre fichier de services.

Création de nos pages

Pour garder les choses simples, nous ne créerons que quelques pages:

- Inscription: où l'utilisateur peut s'inscrire avec un plan d'adhésion (base, or).
- Connexion: page de connexion des membres.
- Mise à niveau: mise à niveau de l'appartenance de base à l'or.
- Publication: afficher une seule page de publication.

Pour accélérer le processus, nous utiliserons Bootsnipp. Vous pouvez obtenir le code final du repo github.

Page de connexion:

La page de connexion a un champ de messagerie et de mot de passe de base, avec une page LoginController qui ressemble à ceci:

<span>php artisan migrate:make create_posts_table --create="posts"
</span><span>
</span><span>php artisan migrate:make create_users_table --create="users"</span>

Page d'inscription:

La page d'inscription a un champ de plan d'abonnement utilisé pour affecter un utilisateur à planifier.
Nous avons également un numéro de carte de crédit, une date d'expiration, CVC.

Comme nous l'avons dit plus tôt, nous n'aurons jamais à faire face à un processus de paiement ou de vérification, nous transmettons ces valeurs au serveur Stripe pour prendre soin du processus de charge et de vérification.
La valeur de retour est un jeton en cas de succès, sinon nous obtenons un message d'erreur que nous pouvons afficher à l'utilisateur.

Voyons à quoi ressemble le code frontal:

<span>Schema::create('posts', function(Blueprint $table)
</span><span>{
</span><span>    $table->increments('id');
</span><span>    $table->string('title');
</span><span>    $table->longText('content');
</span><span>    $table->boolean("is_premium");
</span><span>    $table->timestamps();
</span><span>});
</span><span>
</span><span>Schema::create('users', function(Blueprint $table)
</span><span>{
</span><span>    $table->increments('id');
</span><span>    $table->string('email', 100)->unique();
</span><span>    $table->string('password', 60);
</span><span>    $table->timestamps();
</span><span>});</span>

Nous incluons d'abord le fichier API JavaScript, puis nous définissons notre clé publique que nous avons saisie de nos paramètres de tableau de bord Stripe.

Ensuite, nous joignons une fonction de rappel à notre formulaire de soumission (assurez-vous que votre ID de formulaire correspond à celui utilisé sur le gestionnaire d'événements), pour empêcher une double soumission, nous désactivons notre bouton Soumettre.
Le Stripe.card.CreateToken accepte deux arguments, le premier est un objet JSON qui a des valeurs requises et facultatives.

Valeurs requises:

• Numéro: numéro de carte comme chaîne sans séparateurs.
• exp_month: numéro à deux chiffres représentant le mois d'expiration de la carte.
• exp_year: numéro à deux ou quatre chiffres représentant l'année d'expiration de la carte.

Valeurs facultatives:

• CVC: code de sécurité de la carte en tant que chaîne, le numéro CVC est facultatif mais recommandé pour aider à prévenir la fraude.
• Nom: Nom du titulaire de la carte.
• Adresse_line1: Ligne d'adresse de facturation 1.
• Adresse_line2: ligne d'adresse de facturation 2.
• Adresse_City: Billing Address City.
• adresse_state: état de facturation de l'adresse.
• adresse_zip: facturation zip en tant que chaîne.
• Adresse_country: Pays d'adresse de facturation.
  Vous pouvez remarquer que nous passons un objet de formulaire au lieu d'un objet JSON, vous pouvez choisir de saisir les valeurs manuellement ou d'utiliser l'attribut HTML5 à rayures de données sur vos entrées et Stripe utilisera certaines méthodes d'assistance pour saisir automatiquement ces valeurs pour vous . Ex:

<span>php artisan cashier:table users</span>

Le deuxième argument transmis à Stripe.card.CreateToken Method est une fonction de rappel pour gérer la réponse.

En cas de défaillance, le StrepeResponseHandler essaiera de trouver un élément avec une classe de paiement_errors pour afficher certaines erreurs descriptives à l'utilisateur.
En cas de réussite, une entrée cachée à Stripetoken sera annexée au formulaire et elle sera disponible sur soumission.

Options supplémentaires

• Périodes d'essai: Comme nous l'avons déjà dit, lorsque vous créez un nouveau plan, vous avez le choix de spécifier une période d'essai pour les utilisateurs pour tester votre produit, et ils ne seront pas facturés avant que la période spécifiée ne se soit écoulée.
• Coupons: vous créez des coupons via votre menu de tableau de bord où vous pouvez spécifier un montant fixe ou par pourcentage, avec d'autres options utiles.

Passons maintenant à notre SIGNUP Controller pour voir comment nous allons gérer cela.

<span>php artisan migrate:make create_posts_table --create="posts"
</span><span>
</span><span>php artisan migrate:make create_users_table --create="users"</span>

Nous sauterons le processus de validation pour garder les choses simples.

Après avoir créé un nouvel utilisateur et l'enregistrement, nous avons désormais la possibilité de souscrire l'utilisateur à un nouveau plan d'adhésion. La méthode d'abonnement accepte un plan déjà enregistré en tant qu'argument, qui peut être un planterface ou une chaîne et renvoyer un stripegateway.
La méthode de création accepte un jeton comme paramètre; Nous passons la nouvelle valeur d'entrée cachée avec le nom Stripetoken.

Page de mise à niveau:

La page de mise à niveau se soumetra à la mise à niveau de mise à niveau qui ressemble à ceci:

<span>Schema::create('posts', function(Blueprint $table)
</span><span>{
</span><span>    $table->increments('id');
</span><span>    $table->string('title');
</span><span>    $table->longText('content');
</span><span>    $table->boolean("is_premium");
</span><span>    $table->timestamps();
</span><span>});
</span><span>
</span><span>Schema::create('users', function(Blueprint $table)
</span><span>{
</span><span>    $table->increments('id');
</span><span>    $table->string('email', 100)->unique();
</span><span>    $table->string('password', 60);
</span><span>    $table->timestamps();
</span><span>});</span>

Nous vérifions si l'utilisateur est connecté d'abord, alors nous créons un nouvel abonnement avec le nouveau plan et nous appelons la méthode d'échange, évidemment dans un vrai projet, vous aurez des ajustements de frais et une option de rétrogradation, mais cela devrait fonctionner de la même manière.

Page de publication:

Le post-contrôleur vérifie si le post est_premium, et si oui, nous testons si l'utilisateur est un membre de l'or qui peut voir le message, sinon nous renvoyons un simple message d'erreur.

<span>php artisan cashier:table users</span>

Bien sûr, dans notre fichier routes.php, nous devons ajouter un filtre Auth pour empêcher les utilisateurs non authentifiés d'accéder à la page.
Notre fichier de routes ressemblera à ceci:

<span>php artisan migrate</span>

Autres méthodes utiles

• WithCoupon: Nous avons déjà dit que nous avions la possibilité de créer des coupons de réduction, dans notre exemple, nous pouvons le faire comme ça:

<span>use Laravel\Cashier\BillableInterface;
</span><span>use Laravel\Cashier\BillableTrait;
</span><span>
</span><span>class User extends Eloquent implements BillableInterface {
</span><span>
</span><span>    use BillableTrait;
</span><span>    protected $dates = ['trial_ends_at', 'subscription_ends_at'];</span>

• Annuler: vous pouvez facilement annuler un abonnement en utilisant cette méthode, mais vous devez vérifier si l'utilisateur est onGracePeriod pour vous assurer de ne pas les bloquer immédiatement:

<span>return [
</span><span>    'stripe' => [
</span><span>            'secret'    => 'Your key'
</span><span>        ]
</span><span>];</span>

• ONPAN: Voyez si un utilisateur est sur un certain plan.
• Ontrrial: voir si un utilisateur est toujours en période d'essai.
• Annulé: si l'utilisateur a annulé son abonnement.
• GetLastFourCardDigits: Obtenez la carte utilisateur des quatre derniers chiffres.
• getSubscriptionDatedDate: Obtenez la date de fin de l'abonnement.
• getTrialendDate: Obtenez la date de fin de l'essai.
• Factures: obtenez la liste des factures utilisateur.
• FindInvoice: Trouvez une facture par id.
• TéléchargerInvoice: générer une facture téléchargeable par id.

Conclusion

Dans ce didacticiel, nous avons exploré comment Laravel Cower peut atténuer le processus de facturation et aider à gérer plus facilement vos clients.

Nous n'avons certainement pas tout couvert ici, mais c'est un début pour vous de creuser dans le code source pour explorer ce que vous pouvez faire d'autre. Si vous souhaitez voir une démo hébergée de cette application, voir ici.

Questions fréquemment posées (FAQ) sur les abonnements de la caissière Laravel

Comment Laravel Cackier gère-t-il la facturation d'abonnement?

Laravel Cackier est un outil puissant qui simplifie le processus de gestion de la facturation d'abonnement. Il fournit une interface expressive et couramment aux services de facturation d'abonnement de Stripe et Braintree. Il gère presque tout le code de facturation d'abonnement à la baillit que vous redoutez. Le caissier Laravel peut gérer les coupons, échanger l'abonnement, les «quantités» d'abonnement, les périodes de grâce d'annulation et même générer des pdfs de facture.

Quelles sont les conditions préalables pour utiliser le caissier Laravel?

Avant d'utiliser le caissier, vous «Il faut créer un compte Stripe et installer le package de caissier via Composer. Vous devrez également ajouter le trait facturable à la définition de votre modèle - ce trait fournit diverses méthodes pour vous permettre d'effectuer des tâches de facturation courantes, telles que la création d'abonnements, l'application de coupons et la mise à jour des informations sur la carte.

Comment peut J'intègre le caissier Laravel dans mon projet Laravel existant?

L'intégration de la caissière de Laravel dans votre projet Laravel existant est simple. Tout d'abord, vous devez installer le package via le compositeur. Ensuite, vous devez préparer la base de données en exécutant une migration qui ajoute plusieurs colonnes à la table de votre utilisateur. Après cela, vous devez configurer les touches API et ajouter le trait facturable à votre modèle. Enfin, vous pouvez utiliser les différentes méthodes fournies par le trait facturable pour gérer vos abonnements.

Comment Laravel Caissier gère-t-il les paiements défaillants?

Laravel Cashier a une fonctionnalité intégrée pour gérer les paiements ratés. Si un paiement échoue, le caissier réessaye automatiquement le paiement. Si le paiement continue d'échouer, l'abonnement sera annulé. Cependant, vous pouvez également gérer ces événements manuellement en écoutant les événements pertinents et en prenant les mesures appropriées.

Puis-je utiliser le caissier Laravel avec d'autres passerelles de paiement?

Actuellement, le caissier Laravel ne prend en charge que Stripe et Braintree. Cependant, vous pouvez étendre la caissière pour travailler avec d'autres passerelles de paiement si vous le souhaitez. Cela nécessiterait une bonne compréhension de Laravel et de l'API de la passerelle de paiement.

Comment puis-je annuler un abonnement à l'aide de Laravel Cashier?

Vous pouvez annuler un abonnement en utilisant la méthode d'annulation sur l'abonnement d'un utilisateur . Lorsqu'un abonnement est annulé, le caissier définira automatiquement la date de fin de l'abonnement à la fin du cycle de facturation actuel.

Puis-je offrir des périodes d'essai avec Laravel Cackier?

Oui, Laravel Cashier soutient les périodes d'essai. Vous pouvez définir la période d'essai lors de la création de l'abonnement. L'utilisateur ne sera pas facturé avant la fin de la période d'essai.

Comment puis-je générer des factures à l'aide de Laravel Cackier?

Le caissier Laravel peut générer automatiquement des PDF de factures. Vous pouvez accéder à la version PDF téléchargeable de la facture en appelant la méthode de téléchargement sur une instance de facture, qui écrira le PDF sur le disque ou la diffusera au navigateur.

Puis-je appliquer des coupons aux abonnements en utilisant Laravel Cashier?

Oui, le caissier Laravel prend en charge l'application de coupons aux abonnements. Vous pouvez le faire en utilisant la méthode Withoupon lors de la création d'un nouvel abonnement.

Comment puis-je gérer les quantités d'abonnement avec Laravel Cackier?

Laravel Cackier vous permet de gérer les quantités d'abonnement, qui peuvent être utiles Pour les abonnements de type «par siège». Vous pouvez mettre à jour la quantité d'un abonnement en utilisant la méthode de mise à jour sur une instance d'abonnement.

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!