Ubah Suai Pelan Langganan< /h3>🎜Selepas pengguna melanggan apl anda, mereka mungkin sekali-sekala mahu menukar kepada pelan langganan baharu. Untuk menukar pengguna kepada langganan baharu, hantar pengecam pelan langganan kepada kaedah swap: 🎜

$cards = $user->cards();

🎜Jika pengguna berada dalam tempoh percubaan, tempoh tempoh percubaan dikekalkan. Di samping itu, jika terdapat "kongsi" untuk bilangan langganan, bahagian itu juga akan dikekalkan. 🎜🎜Jika anda ingin membatalkan tempoh percubaan langganan semasa pengguna apabila menukar pelan langganan pengguna, anda boleh menggunakan kaedah skipTrial: 🎜

$card = $user->defaultCard();

🎜< /a>🎜

🎜

Langganan

🎜{Nota} Langganan hanya disokong oleh Cashier's Stripe. Braintree tidak mempunyai ciri "kuantiti" yang sepadan dengan Stripe. 🎜🎜🎜Kadangkala langganan akan dipengaruhi oleh "kuantiti". Contohnya, apl anda mungkin dicaj setiap akaun $10 / bulan. Anda boleh menambah atau mengurangkan langganan anda dengan mudah menggunakan kaedah incrementQuantity dan decrementQuantity: 🎜

if ($user->hasCardOnFile()) {
    //
   }

🎜 Sebagai alternatif, anda boleh menetapkannya menggunakan kaedah updateQuantity A kuantiti tertentu: 🎜

$user->updateCard($stripeToken);

🎜 Kaedah noProrate boleh digunakan untuk mengemas kini kuantiti langganan tanpa menetapkan harga caj: 🎜

$user->updateCardFromStripe();

🎜Untuk maklumat lanjut tentang kuantiti langganan, sila rujuk Dokumentasi Jalur.🎜🎜🎜

🎜

Amaun cukai langganan

🎜Laksanakan kaedah taxPercentage pada mod pengebilan dan kembalikan nombor daripada 0 hingga 100 dengan tidak lebih daripada 2 tempat perpuluhan untuk menyatakan Peratusan cukai yang pengguna bayar pada langganan mereka. 🎜

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

🎜 Kaedah taxPercentage membolehkan anda menggunakan kadar cukai berdasarkan model, yang mungkin berguna untuk pangkalan pengguna yang merangkumi berbilang negara dan kadar cukai. 🎜

🎜{Nota} Kaedah taxPercentage hanya digunakan pada model langganan berbayar. Jika anda menggunakan caj untuk membuat caj "sekali", anda perlu menentukan kadar cukai secara manual pada masa yang sama. 🎜🎜🎜🎜

Peratusan Cukai Segerakkan

Apabila menukar nilai kod keras yang dikembalikan melalui kaedah taxPercentage, tetapan kadar cukai untuk sebarang langganan sedia ada pengguna akan kekal tidak berubah. Jika anda ingin mengemas kini kadar cukai untuk langganan sedia ada dengan nilai taxPercentage yang dikembalikan, anda harus memanggil kaedah syncTaxPercentage pada contoh langganan pengguna: taxPercentage 方法返回的硬编码值时，用户的任何现有订阅的税率设置将保持不变。如果要用返回的 taxPercentage 值更新现有订阅的税率，应在用户的订阅实例上调用 syncTaxPercentage 方法：

$user->deleteCards();

订阅锚定日期

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

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

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

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

取消订阅

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

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

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

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

<?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)  
        {     
           // 此处处理事件   
         }
      }

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

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

恢复订阅

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

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

Tarikh sauh langganan

{Nota} Only Stripe in Cashier menyokong pengubahsuaian tarikh sauh langganan.

Secara lalai, kitaran pengebilan berlabuh pada tarikh langganan dibuat atau jika menggunakan tempoh percubaan, tarikh percubaan tamat. Jika anda ingin mengubah suai tarikh utama pengebilan, anda boleh menggunakan kaedah anchorBillingCycleOn:

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

Untuk mendapatkan maklumat lanjut tentang mengurus kitaran pengebilan langganan, lihat Dokumen kitaran pengebilan jalur

Batal langganan

Panggil kaedah batal pada langganan pengguna untuk membatalkan langganan:

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

Apabila langganan dibatalkan, Juruwang akan secara automatik menetapkan ends_at lajur. Lajur ini selalunya digunakan untuk mengetahui bila medan subscribed harus mula mengembalikan false . Sebagai contoh, jika pelanggan membatalkan langganan mereka pada 1 Mac, tetapi pelan langganan tidak tamat sehingga 5 Mac, kaedah dilanggan akan terus mengembalikan true sehingga 5 Mac .

🎜Anda boleh menggunakan kaedah onGracePeriod untuk menentukan sama ada pengguna pasti akan melanggan, tetapi masih ada "tempoh tangguh": 🎜

<?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)  
        {    
            // 此处处理时事件... 
         }
     }

🎜Jika anda ingin membatalkan langganan serta-merta, sila hubungi < kod>batalkanSekarang dalam langganan pengguna Kaedah: 🎜

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

🎜🎜🎜

🎜

Sambung semula langganan< /h3>🎜Jika seseorang menggunakan Langganan telah dibatalkan, anda boleh menggunakan kaedah resume apabila anda ingin meneruskannya. Pengguna 🎜mesti🎜 masih dalam tempoh tangguh mereka sebelum mereka boleh menyambung semula langganan mereka: 🎜

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

🎜Jika pengguna telah membatalkan langganan mereka dan kemudian menyambung semula sebelum tempoh tangguh mereka, mereka tidak akan dibilkan serta-merta. Sebaliknya, langganan mereka akan diaktifkan semula dan mereka perlu membayar semula mengikut proses pembayaran asal. 🎜🎜🎜🎜🎜🎜🎜🎜Langganan Percubaan🎜🎜🎜🎜🎜🎜🎜

Langgan menggunakan kad kredit

Jika anda ingin menyediakan tempoh percubaan kepada pelanggan anda dan mengumpul maklumat kaedah pembayaran pada masa yang sama, maka anda harus menggunakan kaedah trialDays semasa membuat langganan: trialDays 方法：

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

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

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

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

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

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

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

非信用卡订阅

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

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

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

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

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

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

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

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

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

客户

创建客户

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

<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>

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

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

银行卡

接收信用卡

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

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

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

Kaedah ini akan merekodkan langganan dalam pangkalan data Tetapkan masa tamat tempoh langganan pada apl untuk memberitahu Sripe/Braintree supaya tidak mengira maklumat pengebilan pengguna sehingga itu.

{Nota} Langganan dibilkan secara automatik jika pelanggan tidak membatalkan sebelum percubaan tamat, jadi anda harus memastikan untuk memaklumkan pengguna anda tentang penghujung percubaan mereka.

Kaedah trialUntil membenarkan menentukan tempoh tamat percubaan dengan menyediakan contoh DateTime:

rrreee

Anda boleh menggunakan onTrial kaedah contoh pengguna atau Kaedah onTrial tika langganan menentukan sama ada pengguna berada dalam tempoh percubaan. Dua contoh berikut adalah setara: 🎜rrreee🎜🎜🎜

🎜🎜Langganan bukan kad kredit 🎜🎜 Jika anda tidak mahu mengumpul maklumat kaedah pembayaran pengguna semasa menawarkan tempoh percubaan, cuma tetapkan lajur trial_ends_at rekod pengguna kepada tarikh tamat percubaan yang diingini, yang biasanya dilakukan semasa pendaftaran pengguna: 🎜 rrreee

🎜{Nota} Pastikan anda telah menambahkan pengubah tarikh trial_ends_at pada definisi model. 🎜

🎜Juruwang memanggil sebut harga jenis ini sebagai "pengalaman generik" kerana ia tidak dikaitkan dengan sebarang langganan sedia ada. Jika tarikh semasa tidak melebihi nilai trail_ends_at, kaedah onTrial contoh User akan mengembalikan true: 🎜rrreee🎜 Jika anda ingin mengetahui secara jelas bahawa pengguna berada dalam tempoh percubaan "umum" dan belum membuat langganan sebenar, maka anda boleh menggunakan kaedah onGenericTrial: 🎜rrreee🎜Jika anda akan membuat langganan sebenar untuk pengguna, biasanya Anda boleh menggunakan kaedah newSubsription: 🎜rrreee🎜🎜🎜

🎜

Pelanggan

🎜🎜🎜

🎜🎜Mencipta Pelanggan🎜🎜Sometimes, you maySometimes mahu mencipta pelanggan Stripe tanpa langganan. Anda boleh melakukan ini menggunakan kaedah createAsStripeCustomer: 🎜rrreee🎜Setelah pelanggan dibuat dalam Stripe, anda boleh memulakan langganan kemudian. 🎜

🎜{Tip} Untuk mencipta pelanggan dalam Braintree, gunakan kaedah createAsBraintreeCustomer. 🎜

🎜🎜🎜

🎜

Kad bank

🎜🎜🎜

🎜🎜Terima kad kredit🎜🎜Kaedah kad pada contoh model yang boleh dibilkan mengembalikan LaravelCashierCard< / Koleksi kod> contoh: 🎜rrreee🎜Untuk mendapatkan semula kad lalai, anda boleh menggunakan kaedah defaultCard 🎜rrreee🎜🎜🎜🎜🎜🎜;

Pastikan nombor kad ada dalam fail

Anda boleh menyemak sama ada pelanggan mempunyai kad kredit yang disimpan pada akaun mereka menggunakan kaedah 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

Kemas kini Kad Kredit

Kaedah updateCard boleh digunakan untuk mengemas kini maklumat kad kredit pengguna. Kaedah ini menerima token Stripe dan menetapkan kad kredit baharu sebagai pembayaran lalai Sumber: 🎜rrreee🎜Untuk Stripe menyegerakkan maklumat kad anda dengan maklumat kad lalai pelanggan, anda boleh menggunakan kaedah updateCardFromStripe: 🎜rrreee🎜< a name="deleting-credit-cards">🎜🎜< div name="cf7a10" data-unique="cf7a10">🎜🎜Padam Kad Kredit🎜🎜Untuk memadamkan kad, anda perlu mendapatkan semula kad pelanggan menggunakan < kaedah kod>kad. Anda kemudiannya boleh memanggil kaedah delete pada contoh kad yang ingin anda padamkan: 🎜rrreee

🎜{Nota} Jika anda ingin memadamkan kad lalai, pastikan anda menggunakan updateCardFromStripe kaedah untuk mengemas kini kad baharu Kad lalai disegerakkan dengan pangkalan data. Kaedah 🎜

🎜deleteCards akan memadamkan semua maklumat kad pengguna yang disimpan oleh aplikasi: 🎜rrreee

🎜{Nota} Jika pengguna sudah mempunyai langganan, anda harus mempertimbangkan untuk menghalangnya daripada memadamkan baki kaedah pembayaran terakhir. 🎜

🎜🎜🎜

🎜

Mengendalikan Stripe Webhooks

🎜Stripe and Braintree Aplikasi boleh dimaklumkan tentang pelbagai acara melalui webhooks. Untuk mengendalikan webhook Stripe, anda perlu menentukan laluan ke pengawal webhook Cashier. Pengawal ini mengendalikan semua permintaan yang masuk ke webhook dan menghantarnya ke kaedah pengawal yang sesuai: 🎜rrreee

🎜{Nota} Setelah laluan didaftarkan, pastikan URL webhook dikonfigurasikan dalam panel kawalan Stripe anda. 🎜

🎜Secara lalai, pengawal ini secara automatik akan membatalkan langganan yang mempunyai terlalu banyak pembayaran yang gagal (nombor ini boleh ditakrifkan dalam tetapan Stripe, kami akan mendapati bahawa anda boleh melanjutkan pengendali kawalan ini untuk mengendalikan mana-mana webhook). acara yang anda inginkan. 🎜

🎜{Nota} Sila pastikan anda menggunakan perisian tengah pengesahan tandatangan webhook Cashier untuk melindungi permintaan masuk. 🎜

🎜

Webhooks & CSRF Protection

🎜Oleh kerana Stripe webhooks perlu memintas perlindungan CSRF Laraval, sila pastikan anda menambahkannya VerifyCsrfToken middleware anda mengandungi URI, atau letakkan di luar kumpulan middleware web: 🎜rrreee🎜🎜🎜🎜🎜🎜

Tentukan pengendali acara Webhook

Juruwang secara automatik menyahlanggan untuk pembayaran yang gagal, tetapi jika anda mempunyai acara webhook Stripe lain yang anda mahu kendalikan, anda boleh melanjutkan pengawal Webhook. Nama kaedah anda hendaklah sepadan dengan konvensyen yang dijangkakan oleh Cashier, lebih khusus lagi, kaedah yang anda ingin mengendalikan webhook Stripe hendaklah diawali dengan handle dan nama "camelCase". Contohnya, jika anda ingin mengendalikan webhook invoice.payment_succeeded, anda harus menambah kaedah handleInvoicePaymentSucceeded dalam pengawal: 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

Seterusnya, dalam routes/ web Tentukan laluan pengawal Juruwang dalam fail .php:

rrreee

Langganan Gagal🎜🎜Bagaimana jika kad kredit pengguna tamat tempoh? Jangan risau – Juruwang menyertakan pengawal webhook yang boleh menyahlanggan pengguna untuk anda dengan mudah. Seperti yang dinyatakan di atas, semua yang anda perlu lakukan ialah halakan laluan ke pengawal: 🎜rrreee🎜Itu sahaja! Pembayaran yang gagal akan ditangkap dan diproses oleh pengawal, yang akan membatalkan langganan pengguna selepas Stripe menentukan bahawa langganan gagal (biasanya 3 percubaan pembayaran gagal atau lebih). 🎜🎜🎜🎜

🎜🎜Webhook signature verification🎜🎜Untuk melindungi Webhook, anda perlu menggunakan Tandatangan webhook Stripe 🎜. Untuk kemudahan, Cashier menyertakan perisian tengah yang mengesahkan bahawa permintaan yang dihantar ke webhook Stripe adalah sah. 🎜🎜Jika anda ingin mendayakan pengesahan webhook, pastikan nilai stripe.webhook.secret ditetapkan dalam fail konfigurasi services. rahsia webhook boleh didapati daripada panel kawalan pengguna Stripe. 🎜🎜🎜🎜

🎜

Mengendalikan Braintree Webhooks

🎜Stripe dan Braintree boleh menggunakan webhooks Maklumkan permohonan pelbagai acara. Untuk mengendalikan webhooks Braintree, anda perlu menentukan laluan ke pengawal webhook Cashier. Pengawal ini mengendalikan semua permintaan webhook yang masuk dan menghantarnya ke kaedah penghala yang sesuai: 🎜rrreee

🎜{Nota} Setelah laluan didaftarkan, pastikan URL webhook dikonfigurasikan dalam panel pengawal Braintree. 🎜

🎜Secara lalai, pengawal ini secara automatik akan membatalkan langganan yang mempunyai terlalu banyak pembayaran yang gagal (nombor ini boleh ditakrifkan dalam tetapan Braintree, kami tidak lama lagi akan mendapati bahawa anda boleh melanjutkan pengendali kawalan ini untuk mengendalikan sebarang acara webhook yang anda mahukan. 🎜

🎜

Webhooks & CSRF Protection

🎜Oleh kerana webhook Braintree perlu memintas perlindungan CSRF Laravel, sila pastikan anda menambahkannya pada anda VerifyCsrfToken< /code> Sertakan URI dalam senarai middleware, atau letakkan di luar kumpulan middleware web: 🎜rrreee🎜🎜🎜🎜🎜🎜

Tentukan pengendali acara Webhook

Juruwang secara automatik menyahlanggan untuk pembayaran yang gagal, tetapi jika anda mempunyai acara webhook Braintree lain yang anda mahu kendalikan, anda boleh melanjutkan pengawal Webhook. Nama kaedah anda hendaklah sepadan dengan konvensyen yang dijangkakan oleh Cashier, lebih khusus lagi, kaedah yang anda ingin mengendalikan webhook Braintree hendaklah diawali dengan handle dan nama "camelCase". Contohnya, jika anda ingin mengendalikan webhook dispute_opened, anda harus menambahkan kaedah handleDisputeOpened pada pengawal anda: 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

Langganan gagal

Bagaimana jika kad kredit pengguna tamat tempoh? Jangan risau – Juruwang menyertakan pengawal webhook yang boleh menyahlanggan pengguna untuk anda dengan mudah. Hanya halakan laluan ke dalam pengawal: 🎜rrreee🎜Itu sahaja! Pembayaran yang gagal akan ditangkap dan diproses oleh pengawal, yang akan membatalkan langganan pengguna selepas Braintree menentukan bahawa langganan gagal (biasanya 3 percubaan pembayaran gagal atau lebih). Jangan lupa: konfigurasikan URI webhook dalam panel pengawal Braintree anda. 🎜🎜🎜🎜

🎜

Bayaran sekali

🎜🎜🎜

🎜🎜Bayaran mudah🎜

🎜{Nota} Apabila menggunakan Stripe, kaedah caj menerima pembayaran yang anda mahukan untuk membuat dalam < Unit terkecil mata wang yang digunakan oleh aplikasiAmaun. Walau bagaimanapun, apabila menggunakan Braintree, anda harus menyerahkan keseluruhan jumlah dolar ke dalam kaedah caj: 🎜

🎜Jika anda ingin mengenakan bayaran "sekali" kepada kad kredit pelanggan, anda boleh berbuat demikian dalam Gunakan kaedah caj pada contoh model pengebilan: 🎜rrreee🎜 Kaedah caj menerima tatasusunan sebagai parameter kedua, membolehkan anda membuat pembayaran dengan apa sahaja anda mahu Pilihan dihantar ke Stripe/Braintree yang mendasari. Lihat dokumentasi Stripe atau Braintree untuk pilihan yang tersedia semasa membuat pembayaran: 🎜rrreee🎜Kaedah caj akan memberikan pengecualian jika pembayaran gagal. Jika pembayaran berjaya, kaedah ini akan mengembalikan jawapan penuh Stripe / Braintree: 🎜rrreee🎜🎜🎜🎜🎜🎜

Yuran dan Invois

Kadangkala anda mungkin perlu membayar yuran sekali sahaja dan juga perlu menjana invois yuran supaya anda boleh memberikan resit dalam format fail PDF kepada pelanggan anda. Kaedah invoiceFor membolehkan anda melakukan ini. Contohnya, invois pelanggan untuk "yuran sekali" sebanyak $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

Invois dibayar segera kepada kad kredit pengguna. Kaedah invoiceFor menerima tatasusunan sebagai parameter ketiga, membolehkan anda menghantar sebarang pilihan yang anda mahukan kepada Stripe/Braintree asas semasa membuat pembayaran:

rrreeeJika anda menggunakan Braintree untuk Pembekal invois anda, anda mesti memasukkan pilihan penerangan apabila memanggil kaedah invoiceFor: rrreee

{Nota} Kaedah invoiceFor akan mencipta Invois Stripe , yang akan dicuba semula selepas pembayaran gagal. Jika anda tidak mahu mencuba semula selepas kegagalan, anda perlu menghubungi API Stripe untuk menutupnya selepas pembayaran pertama gagal.

🎜🎜🎜

🎜🎜Perihal Bayaran Balik🎜🎜Jika anda perlu memproses bayaran balik, anda boleh menggunakan kaedah bayaran balik. Kaedah ini menerima ID caj Stripe sebagai satu-satunya parameternya: 🎜rrreee🎜🎜🎜

🎜

Invois

🎜 Anda Tatasusunan invois model pengebilan boleh diperoleh dengan mudah menggunakan kaedah invois: 🎜rrreee🎜Apabila menyenaraikan senarai invois pelanggan, anda boleh menggunakan fungsi pembantu invois untuk memaparkan maklumat invois yang berkaitan. Sebagai contoh, anda mungkin mahu menyenaraikan setiap invois dalam jadual untuk memudahkan pelanggan memuat turunnya: 🎜rrreee🎜🎜🎜

🎜🎜Jana invois PDF🎜🎜Dalam laluan atau pengawal, gunakan kaedah muat turunInvois untuk menjana muat turun PDF bagi invois. Kaedah ini secara automatik akan menjana respons muat turun HTTP yang sesuai kepada penyemak imbas: 🎜rrreee🎜Artikel ini pertama kali diterbitkan di tapak web 🎜LearnKu.com🎜. 🎜🎜

Ujian pelayar Senja →