Modifier le plan d'abonnement< /h3>🎜Une fois que les utilisateurs se sont abonnés à votre application, ils peuvent parfois souhaiter passer à un nouveau plan d'abonnement. Pour faire basculer un utilisateur vers un nouvel abonnement, transmettez l'identifiant du forfait d'abonnement à la méthode swap : 🎜

$user->updateCard($stripeToken);

🎜Si l'utilisateur est en période d'essai, la durée de la période d'essai est conservée. De plus, s'il existe une « part » pour le nombre d'abonnements, cette part sera également maintenue. 🎜🎜Si vous souhaitez annuler la période d'essai de l'abonnement actuel de l'utilisateur lors du changement de plan d'abonnement de l'utilisateur, vous pouvez utiliser la méthode skipTrial : 🎜

$user->updateCardFromStripe();

🎜< /a>🎜

🎜

Abonnements

🎜{Note} Les abonnements ne sont pris en charge que par Cashier's Stripe. Braintree n'a pas de fonctionnalité « quantité » qui correspond à Stripe. 🎜🎜🎜Parfois, l'abonnement sera affecté par la "quantité". Par exemple, votre application peut être facturée par compte 10 $/mois. Vous pouvez facilement augmenter ou diminuer votre abonnement en utilisant les méthodes incrementQuantity et decrementQuantity : 🎜

foreach ($user->cards() as $card) {
    $card->delete();
  }

🎜 Alternativement, vous pouvez le définir en utilisant la méthode updateQuantity A quantité spécifique : 🎜

$user->deleteCards();

🎜 La méthode noProrate peut être utilisée pour mettre à jour la quantité d'un abonnement sans facturer les frais : 🎜

Route::post( 
   'stripe/webhook',    
   '\Laravel\Cashier\Http\Controllers\WebhookController@handleWebhook'
   );

🎜Pour plus d'informations sur les quantités d'abonnement, veuillez vous référer à Documentation Stripe.🎜🎜🎜

🎜

Montant de la taxe d'abonnement

🎜implémentez la méthode taxPercentage sur le mode de facturation et renvoyez un nombre de 0 à 100 avec pas plus de 2 décimales pour spécifier le pourcentage de taxe que les utilisateurs paient sur leur abonnement. 🎜

protected $except = [
    'stripe/*',
   ];

🎜 La méthode taxPercentage vous permet d'appliquer des taux d'imposition sur une base de modèle, ce qui peut être utile pour une base d'utilisateurs couvrant plusieurs pays et taux d'imposition. 🎜

🎜{Note} La méthode taxPercentage s'applique uniquement aux modèles d'abonnement payants. Si vous utilisez des frais pour effectuer des frais « uniques », vous devez en même temps spécifier manuellement le taux de taxe. 🎜🎜🎜🎜

Synchroniser le pourcentage de taxe

Lors de la modification de la valeur codée en dur renvoyée par la méthode taxPercentage, les paramètres de taux de taxe pour tous les abonnements existants de l'utilisateur resteront inchangés. Si vous souhaitez mettre à jour le taux de taxe d'un abonnement existant avec la valeur taxPercentage renvoyée, vous devez appeler la méthode syncTaxPercentage sur l'instance d'abonnement de l'utilisateur : taxPercentage 方法返回的硬编码值时，用户的任何现有订阅的税率设置将保持不变。如果要用返回的 taxPercentage 值更新现有订阅的税率，应在用户的订阅实例上调用 syncTaxPercentage 方法：

<?php
    namespace App\Http\Controllers;
    use Laravel\Cashier\Http\Controllers\WebhookController as CashierController;
    class WebhookController extends CashierController{  
      /**
     * Handle invoice payment succeeded.
     *
     * @param  array  $payload
     * @return \Symfony\Component\HttpFoundation\Response
     */   
      public function handleInvoicePaymentSucceeded($payload)  
        {     
           // 此处处理事件   
         }
      }

订阅锚定日期

{注意} Cashier 中只有 Stripe 支持修改订阅锚定日期。

默认情况下，计费周期锚定是创建订阅的日期，如果使用试用期，则是试用结束的日期。如果要修改账单锚定日期，可以使用 anchorBillingCycleOn 方法：

Route::post( 
   'stripe/webhook',    
   '\App\Http\Controllers\WebhookController@handleWebhook'
  );

有关管理订阅计费周期的详细信息，请参阅 Stripe 计费周期文档

取消订阅

在用户订阅上调用 cancel 方法用来取消订阅：

Route::post( 
   'stripe/webhook',    
   '\Laravel\Cashier\Http\Controllers\WebhookController@handleWebhook'
  );

当一个订阅被取消时，Cashier 将会自动在你的数据库中设置  ends_at 列。这个列经常被用来获悉 subscribed 字段何时应该开始返回 false 。例如，如果客户在 3 月 1 日取消订阅，但是订阅计划直到 3  月 5 日才结束，subscribed 方法将会继续返回 true 一直到 3 月 5 日。

你可以使用 onGracePeriod 方法确定用户是否确定订阅，但是仍然存在一个「宽限期」：

Route::post(
    'braintree/webhook',    
    '\Laravel\Cashier\Http\Controllers\WebhookController@handleWebhook'
    );

如果你想马上取消订阅，请在用户的订阅中调用 cancelNow 方法：

protected $except = [ 
   'braintree/*',
  ];

恢复订阅

如果一个用已经取消订阅，你可以在你希望恢复它的时候使用 resume

<?php
    namespace App\Http\Controllers;
    use Braintree\WebhookNotification;
    use Laravel\Cashier\Http\Controllers\WebhookController as CashierController;
    class WebhookController extends CashierController{ 
       /**
     * Handle a new dispute.
     *
     * @param  \Braintree\WebhookNotification  $webhook
     * @return \Symfony\Component\HttpFoundation\Responses
     */  
      public function handleDisputeOpened(WebhookNotification $webhook)  
        {    
            // 此处处理时事件... 
         }
     }

Date d'ancrage de l'abonnement

{Remarque} Seul Stripe dans Cashier prend en charge la modification la date de référence de la souscription.

Par défaut, le cycle de facturation est ancré à la date de création de l'abonnement, ou si vous utilisez une période d'essai, à la date de fin de l'essai. Si vous souhaitez modifier la date d'ancrage de facturation, vous pouvez utiliser la méthode anchorBillingCycleOn :

Route::post(
    'braintree/webhook',    
    '\Laravel\Cashier\Http\Controllers\WebhookController@handleWebhook'
  );

Pour plus d'informations sur la gestion des cycles de facturation des abonnements, voir Document du cycle de facturation Stripe

Annuler abonnement

Appelez la méthode cancel sur l'abonnement utilisateur pour annuler l'abonnement :

// Stripe 接收分为单位的费用...
$stripeCharge = $user->charge(100);
// Braintree 接收美元为单位的费用...
$user->charge(1);

Lorsqu'un abonnement est annulé, Cashier définira automatiquement ends_at colonne. Cette colonne est souvent utilisée pour savoir quand un champ subscribe doit commencer à renvoyer false . Par exemple, si le client annule son abonnement le 1er mars, mais que le plan d'abonnement ne se termine que le 5 mars, la méthode subscriber continuera à renvoyer true jusqu'au 5 mars.

🎜Vous pouvez utiliser la méthode onGracePeriod pour déterminer si l'utilisateur est sûr de s'abonner, mais il y a toujours un "délai de grâce" : 🎜

$user->charge(100, [ 
   'custom_option' => $value,
  ]);

🎜Si vous souhaitez annuler l'abonnement immédiatement, veuillez appeler < code>annulerMaintenant dans l'abonnement de l'utilisateur Méthode : 🎜

try { 
   $response = $user->charge(100);
   } 
catch (Exception $e) {
    //
    }

🎜🎜🎜

🎜

Reprendre les abonnements< /h3>🎜Si l'on utilise L'abonnement a été annulé, vous pouvez utiliser la méthode resume lorsque vous souhaitez le reprendre. Les utilisateurs 🎜doivent🎜 être encore dans leur délai de grâce avant de pouvoir reprendre leur abonnement : 🎜

// Stripe 接收分为单位的费用...
$user->invoiceFor('One Time Fee', 500);
// Braintree 接收美元为单位的费用...
$user->invoiceFor('One Time Fee', 5);

🎜Si un utilisateur a annulé son abonnement puis le reprend avant son délai de grâce, il ne sera pas facturé immédiatement. Au lieu de cela, leur abonnement sera réactivé et ils devront payer à nouveau selon le processus de paiement initial. 🎜🎜🎜🎜🎜🎜🎜🎜Abonnement d'essai🎜🎜🎜🎜🎜🎜🎜

Abonnez-vous par carte bancaire

Si vous souhaitez offrir une période d'essai à vos clients et collecter en même temps les informations sur les moyens de paiement, alors vous devez utiliser la méthode trialDays lors de la création de l'abonnement : trialDays 方法：

$user->invoiceFor('Stickers', 500,
 [
    'quantity' => 50,
 ], 
 [  
      'tax_percent' => 21,
 ]);

该方法会在数据库订阅记录上设置订阅期结束时间，以便告知 Sripe / Braintree 在此之前不要计算用户的账单信息。

{注意} 如果顾客没有在试用期结束前取消订阅，订阅会被自动结算，所以你应该确保告知你的用户他们的试用结束期。

trialUntil 方法允许提供 DateTime 实例指定试用结束期：

$user->invoiceFor('One Time Fee', 500,
 [
     'description' => 'your invoice description here',
 ]);

你可以使用用户实例的 onTrial 方法或者订阅实例的 onTrial 方法判断用户是否处于试用期。下面两个示例等价：

$stripeCharge = $user->charge(100);
$user->refund($stripeCharge->id);

非信用卡订阅

如果你不想在提供试用期的时候收集用户支付方式信息，只需设置用户记录的 trial_ends_at 列为期望的试用期结束日期即可，这通常在用户注册期间完成：

$invoices = $user->invoices();
// 结果包含处理中的发票...
$invoices = $user->invoicesIncludingPending();

{注意}  确保已添加 trial_ends_at 日期修改器  到模型定义。

Cashier 把这种类型的引用称为「一般体验」，因为它没有关联任何已存在的订阅。如果当前的日期没有超过 trail_ends_at 值， User 实例的 onTrial 方法将会返回 true ：

<table>
    @foreach ($invoices as $invoice) 
    <tr>
       <td>{{ $invoice->date()->toFormattedDateString() }}</td>            
       <td>{{ $invoice->total() }}</td>            
       <td><a href="/user/invoice/{{ $invoice->id }}">Download</a></td>        
     </tr>
    @endforeach
</table>

如果你希望明确的知道用户处于「一般」试用期，并且还未创建实际的订阅，那么你可以使用 onGenericTrial 方法：

use Illuminate\Http\Request;
Route::get('user/invoice/{invoice}', function (Request $request, $invoiceId) {
    return $request->user()->downloadInvoice($invoiceId, [ 
           'vendor'  => 'Your Company',        
           'product' => 'Your Product',    
         ]);
     });

如果你准备给用户创建实际的订阅，通常你可以使用 newSubsription 方法：

rrreee

客户

创建客户

有时，您可能希望在未订阅的情况下创建 Stripe 客户。您可以使用 createAsStripeCustomer 方法完成此操作：

rrreee

一旦在 Stripe 中创建了客户，您可以稍后开始订阅。

{提示} 在 Braintree 中创建客户使用的是 createAsBraintreeCustomer 方法。

银行卡

接收信用卡

可计费模型实例上的 cards 方法返回 LaravelCashierCard 实例的集合：

rrreee

要检索默认卡，可以使用 defaultCardrrreee

Cette méthode enregistrera l'abonnement dans la base de données. Définissez une heure de fin de période d'abonnement sur l'application pour indiquer à Sripe/Braintree de ne pas calculer les informations de facturation de l'utilisateur d'ici là.

{Note} Les abonnements sont automatiquement facturés si le client n'annule pas avant la fin de l'essai, vous devez donc vous assurer d'informer vos utilisateurs de la fin de leur essai.

La méthode trialUntil permet de spécifier la période de fin d'essai en fournissant une instance DateTime :

rrreee

Vous pouvez utiliser le onTrial méthode de l'instance utilisateur ou La méthode onTrial de l'instance d'abonnement détermine si l'utilisateur est en période d'essai. Les deux exemples suivants sont équivalents : 🎜rrreee🎜🎜🎜

🎜🎜Abonnement sans carte de crédit 🎜🎜 Si vous ne souhaitez pas collecter d'informations sur le mode de paiement de l'utilisateur lorsque vous proposez une période d'essai, définissez simplement la colonne trial_ends_at de l'enregistrement utilisateur sur la date de fin d'essai souhaitée, ce qui est généralement effectué lors de l'enregistrement de l'utilisateur : 🎜 rrreee

🎜{Note} Assurez-vous d'avoir ajouté le modificateur de date trial_ends_at à la définition du modèle. 🎜

🎜Cashier qualifie ce type de devis d'"expérience générique" car il n'est associé à aucun abonnement existant. Si la date actuelle ne dépasse pas la valeur trail_ends_at, la méthode onTrial de l'instance User renverra true : 🎜rrreee🎜 Si vous souhaitez savoir explicitement que l'utilisateur est en période d'essai "générale" et n'a pas encore créé d'abonnement proprement dit, alors vous pouvez utiliser la méthode onGenericTrial : 🎜rrreee🎜Si vous êtes va créer un abonnement réel pour l'utilisateur, généralement Vous pouvez utiliser la méthode newSubsription : 🎜rrreee🎜🎜🎜

🎜

Clients

🎜🎜🎜

🎜🎜Création de clients🎜🎜Parfois, vous pouvez souhaitez créer des clients Stripe sans abonnement. Vous pouvez le faire en utilisant la méthode createAsStripeCustomer : 🎜rrreee🎜Une fois le client créé dans Stripe, vous pourrez ultérieurement démarrer un abonnement. 🎜

🎜{Astuce} Pour créer un client dans Braintree, utilisez la méthode createAsBraintreeCustomer. 🎜

🎜🎜🎜

🎜

Cartes bancaires

🎜🎜🎜

🎜🎜Recevoir une carte de crédit🎜🎜La méthode cards sur une instance de modèle facturable renvoie LaravelCashierCard< / Une collection d'instances de code> : 🎜rrreee🎜Pour récupérer la carte par défaut, vous pouvez utiliser la méthode defaultCard 🎜rrreee🎜🎜🎜🎜🎜🎜 ;

Assurez-vous que le numéro de carte est enregistré

Vous pouvez vérifier si le client a une carte de crédit stockée sur son compte en utilisant la méthode hasCardOnFile : hasCardOnFile 方法检查客户是否在其帐户上储存了信用卡：

rrreee

更新信用卡

updateCard 方法可用于更新用户的信用卡信息，该方法接受一个 Stripe 令牌并设置一个新的信用卡作为默认支付源：

rrreee

将您的卡信息与客户的默认卡信息进行 Stripe 同步，可以使用 updateCardFromStripe 方法：

rrreee

删除信用卡

要删除卡，应首先使用 cards 方法检索客户的卡。然后，可以调用要删除的卡实例上的 delete 方法：

rrreee

{注意} 如果要删除默认卡，请确保使用 updateCardFromStripe 方法将新的默认卡与数据库同步。

deleteCards 方法将删除应用程序存储的用户的所有卡信息：

rrreee

{注意} 如果用户已有订阅，则应考虑阻止他们删除最后剩余的付款方式。

处理 Stripe Webhooks

Stripe 和 Braintree 都可以通过 webhook 通知应用各种各样的事件。要处理 Stripe webhook，需要定义一个 Cashier 的 webhook 控制器的路由。这个控制器可以处理所有进入 webhook 的请求并将他们分发到合适的控制器方法中：

rrreee

{注意} 一旦注册了路由，确保在您的 Stripe 控制面板配置了 webhook URL。

默认情况下，这个控制器将会自动对支付失败次数过多（这个次数可以在 Stripe 设置中定义）的订阅进行取消；此外，我们很快会发现，你可以扩展这个控制器去处理任何你想要处理的 webhook 事件。

{注意} 请确保使用 Cashier 的 webhook 验签 中间件来保护传入请求。

Webhooks & CSRF 保护

因为 Stripe webhooks 需要绕过 Laraval 的 CSRF 保护，请确保在你的 VerifyCsrfToken 中间件含有 URI ，或者将其置于 webrrreee

Mettre à jour la carte de crédit

La méthode updateCard peut être utilisée pour mettre à jour les informations de la carte de crédit de l'utilisateur. Cette méthode accepte un jeton Stripe et définit une nouvelle carte de crédit comme paiement par défaut. Source : 🎜rrreee🎜Pour que Stripe synchronise les informations de votre carte avec les informations de carte par défaut du client, vous pouvez utiliser la méthode updateCardFromStripe : 🎜rrreee🎜< a name="deleting-credit-cards">🎜🎜< div name="cf7a10" data-unique="cf7a10">🎜🎜Supprimer une carte de crédit🎜🎜Pour supprimer une carte, vous devez d'abord récupérer les cartes du client à l'aide du < méthode code>cartes. Vous pouvez ensuite appeler la méthode delete sur l'instance de carte que vous souhaitez supprimer : 🎜rrreee

🎜{Note} Si vous souhaitez supprimer la carte par défaut, assurez-vous d'utiliser le updateCardFromStripe Méthode pour mettre à jour la nouvelle carte La carte par défaut est synchronisée avec la base de données. La méthode 🎜

🎜deleteCards supprimera toutes les informations de carte de l'utilisateur stockées par l'application : 🎜rrreee

🎜{Note} Si l'utilisateur a déjà un abonnement, vous devriez envisager de les empêcher de supprimer le dernier mode de paiement restant. 🎜

🎜🎜🎜

🎜

Gestion des webhooks Stripe

🎜Stripe et Braintree Les applications peuvent être informées de divers événements via des webhooks. Pour gérer les webhooks Stripe, vous devez définir un itinéraire vers le contrôleur de webhook de Cashier. Ce contrôleur gère toutes les requêtes entrant dans le webhook et les envoie à la méthode de contrôleur appropriée : 🎜rrreee

🎜{Note} Une fois la route enregistrée, assurez-vous que l'URL du webhook est configurée dans votre panneau de configuration Stripe. 🎜

🎜Par défaut, ce contrôleur annulera automatiquement les abonnements qui ont trop de paiements échoués (ce nombre peut être défini dans les paramètres de Stripe, de plus, nous découvrirons bientôt que vous pouvez étendre ce gestionnaire de contrôle pour gérer n'importe quel webhook) ; les événements que vous souhaitez. 🎜

🎜{Remarque} Veuillez vous assurer d'utiliser le middleware de vérification de signature webhook de Cashier pour protéger les demandes entrantes. 🎜

🎜

Webhooks et protection CSRF

🎜Étant donné que les webhooks Stripe doivent contourner la protection CSRF de Laraval, assurez-vous de l'ajouter votre middleware VerifyCsrfToken contient un URI, ou placez-le en dehors du groupe de middleware web : 🎜rrreee🎜🎜🎜🎜🎜🎜

Définir les gestionnaires d'événements Webhook

Cashier se désabonne automatiquement en cas d'échec de paiement, mais si vous souhaitez gérer d'autres événements Webhook Stripe, vous pouvez étendre le contrôleur Webhook. Les noms de vos méthodes doivent correspondre à la convention attendue par Cashier, plus précisément, la méthode que vous souhaitez gérer le webhook Stripe doit être préfixée par handle et "camelCase" le nom. Par exemple, si vous souhaitez gérer le webhook de invoice.payment_succeeded, vous devez ajouter la méthode handleInvoicePaymentSucceeded dans le contrôleur : handle 和 「驼峰」 名为前缀。举例来说，如果你希望处理 invoice.payment_succeeded 的 webhook，你应该在控制器添加 handleInvoicePaymentSucceeded 方法：

rrreee

接下来，在 routes/web.php 文件中定义 Cashier 控制器的路由：

rrreee

订阅失败

如果用户的信用卡过期怎么办？不用担心 - Cashier 包含了一个 Webhook 控制器可以轻松为你取消用户的订阅。正如上文所述，你需要做的只是将路由指向控制器：

rrreee

就是这样！失败的支付将会被控制器捕获并处理，该控制器会在 Stripe 判断订阅失败后（通常尝试支付失败 3 次及以上）取消用户的订阅。

Webhook 验签

为了保护 Webhook，你需要使用 Stripe 的 webhook 签名。为了方便起见，Cashier 包含一个中间件，用于验证传入 Stripe webhook 的请求是否有效。

如果要启用 Webhook 验证，请确保在 services 配置文件中设置了 stripe.webhook.secret 的值。 Webhook 的 secret 可以从 Stripe 用户控制面板中找到。

处理 Braintree Webhooks

Stripe 和 Braintree 都可以通过 webhooks 通知应用各种各样的事件。要处理 Braintree webhooks，需要定义一个 Cashier webhook 控制器的路由。这个控制器可以处理所有传入 webhook 的请求并将它们分发到合适的路由器方法中：

rrreee

{注意} 一旦注册了路由，确保在 Braintree 控制器面板配置了 webhook URL。

默认情况下，这个控制器将会自动对支付失败次数过多（这个次数可以在 Braintree 设置中定义）的订阅进行取消；此外，我们很快会发现，你可以扩展这控制器去处理任何你想要处理的 webhook 事件。

Webhooks & CSRF 保护

因为 Braintree webhooks 需要绕过 Laravel 的 CSRF 保护，请确保在你的 VerifyCsrfToken 中间件列表中含有 URI ，或者将其置于 webrrreee

Ensuite, dans routes/ web Définissez l'itinéraire du contrôleur de caisse dans le fichier .php :

rrreee

Échec de l'abonnement🎜🎜Que se passe-t-il si la carte de crédit de l'utilisateur expire ? Ne vous inquiétez pas, Cashier comprend un contrôleur de webhook qui peut facilement désabonner les utilisateurs pour vous. Comme mentionné ci-dessus, il vous suffit de pointer l'itinéraire vers le contrôleur : 🎜rrreee🎜 Et voilà ! Les paiements échoués seront capturés et traités par le contrôleur, qui annulera l'abonnement de l'utilisateur une fois que Stripe aura déterminé que l'abonnement a échoué (généralement 3 tentatives de paiement infructueuses ou plus). 🎜🎜🎜🎜

🎜🎜Vérification de la signature du Webhook🎜🎜Pour protéger le Webhook, vous devez utiliser Signatures webhook de Stripe 🎜. Pour plus de commodité, Cashier inclut un middleware qui vérifie que les requêtes transmises au webhook Stripe sont valides. 🎜🎜Si vous souhaitez activer l'authentification webhook, assurez-vous que la valeur de stripe.webhook.secret est définie dans le fichier de configuration services. Le secret du webhook peut être trouvé à partir du panneau de contrôle utilisateur Stripe. 🎜🎜🎜🎜

🎜

Gestion des webhooks Braintree

🎜Stripe et Braintree peuvent tous deux utiliser des webhooks Notifier les applications de divers événements. Pour gérer les webhooks Braintree, vous devez définir un itinéraire vers le contrôleur de webhook Cashier. Ce contrôleur gère toutes les requêtes de webhook entrantes et les envoie à la méthode de routeur appropriée : 🎜rrreee

🎜{Note} Une fois la route enregistrée, assurez-vous que l'URL du webhook est configurée dans le panneau du contrôleur Braintree. 🎜

🎜Par défaut, ce contrôleur annulera automatiquement les abonnements qui ont trop de paiements échoués (ce nombre peut être défini dans les paramètres de Braintree de plus, nous découvrirons bientôt que vous pouvez étendre ce gestionnaire de contrôle pour gérer n'importe quel type de paiement) ; événements webhook souhaités. 🎜

🎜

Webhooks et protection CSRF

🎜Étant donné que les webhooks Braintree doivent contourner la protection CSRF de Laravel, assurez-vous de l'ajouter à votre VerifyCsrfToken< /code> Incluez l'URI dans la liste des middlewares ou placez-le en dehors du groupe de middlewares web : 🎜rrreee🎜🎜🎜🎜🎜🎜

Définir le gestionnaire d'événements Webhook

Le caissier se désabonne automatiquement en cas d'échec de paiement, mais si vous souhaitez gérer d'autres événements Webhook Braintree, vous pouvez étendre le contrôleur Webhook. Les noms de vos méthodes doivent correspondre à la convention attendue par Cashier, plus précisément, la méthode que vous souhaitez gérer le webhook Braintree doit être préfixée par handle et "camelCase" le nom. Par exemple, si vous souhaitez gérer le webhook dispute_opened, vous devez ajouter la méthode handleDisputeOpened à votre contrôleur : handle 和「驼峰」名为前缀。举例来说，如果你希望处理 dispute_opened 这个 webhook，你应该在控制器添加 handleDisputeOpened 方法：

rrreee

订阅失败

如果用户的信用卡过期怎么办？不用担心 - Cashier 包含了一个 Webhook 控制器可以轻松为你取消用户的订阅。只需要将路由指向控制器中：

rrreee

就是这样！失败的支付将会被控制器捕获和处理，该控制器会在 Braintree 判断订阅失败后（通常尝试支付失败 3 次及以上）取消用户的订阅。 不要忘记：在你的 Braintree 控制器面板中配置 webhook URI。

一次性支付

简单支付

{注意} 当使用 Stripe 时，charge 方法接收你想支付于 应用程序使用的货币的最小单位 的金额。然而，当使用 Braintree 时，你应该将全部的美元金额传入 charge 方法：

如果你想对订阅客户的信用卡收取「一次性」费用，可以在可计费模型实例上使用 charge 方法：

rrreee

charge 方法接受一个数组作为它的第二个参数，允许你创建支付时将任何你想要的选项传递给底层的 Stripe / Braintree 。 有关在创建支付时可用的选项，请参阅 Stripe 或 Braintree 文档：

rrreee

如果支付失败，chargerrreee

Échec de l'abonnement

Et si la carte de crédit de l'utilisateur expire ? Ne vous inquiétez pas, Cashier comprend un contrôleur de webhook qui peut facilement désabonner les utilisateurs pour vous. Pointez simplement l'itinéraire dans le contrôleur : 🎜rrreee🎜C'est tout ! Les paiements échoués seront capturés et traités par le contrôleur, qui annulera l'abonnement de l'utilisateur une fois que Braintree aura déterminé que l'abonnement a échoué (généralement 3 tentatives de paiement échouées ou plus). N'oubliez pas : configurez l'URI du webhook dans votre panneau de contrôleur Braintree. 🎜🎜🎜🎜

🎜

Paiement unique

🎜🎜🎜

🎜🎜Paiement simple🎜

🎜{Note} Lors de l'utilisation de Stripe, la méthode charge accepte le paiement que vous souhaitez à réaliser en< La plus petite unité monétaire utilisée par l'applicationMontant. Cependant, lorsque vous utilisez Braintree, vous devez transférer la totalité du montant en dollars dans la méthode charge : 🎜

🎜Si vous souhaitez facturer des frais « uniques » sur la carte de crédit de l'abonné, vous pouvez le faire dans Utilisez la méthode charge sur l'instance du modèle de facturation : 🎜rrreee🎜 La méthode charge accepte un tableau comme deuxième paramètre, vous permettant de créer un paiement avec n'importe quel vous souhaitez que les options soient transmises au Stripe/Braintree sous-jacent. Consultez la documentation Stripe ou Braintree pour les options disponibles lors de la création d'un paiement : 🎜rrreee🎜La méthode charge lèvera une exception si le paiement échoue. Si le paiement réussit, cette méthode renverra la réponse complète de Stripe / Braintree : 🎜rrreee🎜🎜🎜🎜🎜🎜

Frais et factures

Parfois, vous devrez peut-être payer des frais uniques et également générer une facture de frais afin de pouvoir fournir des reçus au format de fichier PDF à vos clients. La méthode invoiceFor vous permet de le faire. Par exemple, facturez à un client des « frais uniques » de 5,00 $ : invoiceFor 方法可以让你做到这一点。 例如，向客户开具 5.00 美元的「一次性费用」发票：

rrreee

该发票会立即通过用户信用卡支付。 invoiceFor 方法接收一个数组作为第三个参数，允许你在创建支付时将任何你想要的选项传递给底层的 Stripe / Braintree ：

rrreee

如果你使用 Braintree 作为你的账单提供者，你在调用 invoiceFor 方法时必须包含 description 选项：

rrreee

{注意} invoiceFor 方法将会创建 Stripe 发票，该发票将会在支付失败后重试。如果你不想失败后重试，你需要在第一次支付失败后调用 Stripe API 关闭它。

关于退款

如果您需要处理退款，您可以使用 refund 方法。此方法接受 Stripe charge ID 作为其唯一参数：

rrreee

发票

您可以使用 invoices 方法轻松获取账单模型的发票数组：

rrreee

当列出客户发票清单时，可以使用发票辅助函数来显示相关的发票信息。例如，您可能希望在表格中列出每张发票，从而方便客户下载它们：

rrreee

生成 PDF 发票

在路由或控制器中，使用 downloadInvoicerrreee

La facture est immédiatement payée sur la carte de crédit de l'utilisateur. La méthode invoiceFor reçoit un tableau comme troisième paramètre, vous permettant de transmettre toutes les options que vous souhaitez au Stripe/Braintree sous-jacent lors de la création du paiement :

rrreeeSi vous utilisez Braintree pour votre fournisseur de factures, vous devez inclure l'option description lors de l'appel de la méthode invoiceFor : rrreee

{Note} La méthode invoiceFor créera une facture Stripe , qui sera réessayé après l'échec du paiement. Si vous ne souhaitez pas réessayer après un échec, vous devez appeler l'API Stripe pour la fermer après l'échec du premier paiement.

🎜🎜🎜

🎜🎜À propos des remboursements🎜🎜Si vous devez traiter un remboursement, vous pouvez utiliser Méthode de remboursement. Cette méthode accepte l'ID de charge Stripe comme seul paramètre : 🎜rrreee🎜🎜🎜

🎜

Factures

🎜 Vous Le tableau de factures du modèle de facturation peut être facilement obtenu en utilisant la méthode factures : 🎜rrreee🎜Lors de la liste d'une liste de factures clients, vous pouvez utiliser la fonction d'aide à la facture pour afficher les informations de facture pertinentes. Par exemple, vous souhaiterez peut-être répertorier chaque facture dans un tableau pour permettre aux clients de les télécharger plus facilement : 🎜rrreee🎜🎜🎜

🎜🎜Générer une facture PDF🎜🎜Dans une route ou un contrôleur, utilisez la méthode downloadInvoice pour générer un téléchargement PDF d'une facture. Cette méthode générera automatiquement une réponse de téléchargement HTTP appropriée au navigateur : 🎜rrreee🎜Cet article a été publié pour la première fois sur le site Web 🎜LearnKu.com🎜. 🎜🎜

Test du navigateur Dusk →