Stripe と PHP を使用して簡単に支払いを受け取ります

導入

多くの場合、当社のアプリケーションでは、製品やサービスを購入するための簡単な支払い方法を提供する必要があります。 Stripe は支払いを受け取るのに適したオプションです。この投稿では、ストライプ支払いリンクを作成して、ユーザーをそれらのリンクにリダイレクトして支払いを送金できるようにする方法を学びます。

ストライプとは何ですか？

Stripe は、企業がインターネット上で支払いを受け取れるようにするオンライン支払い処理サービスを提供するテクノロジー企業です。企業がオンライン取引、サブスクリプション、その他の支払い関連タスクを管理できるようにする一連のツールと API を提供します。

コードを書き始める前に、次の Stripe コンポーネントを理解する必要があります。

• 製品: 製品は、販売したい商品またはサービスを表します。これには、名前、説明、価格の詳細などが含まれます。

• 価格: 価格は、製品の特定の価格設定です。これは、顧客が製品に対して支払う金額のほか、通貨、請求サイクル、価格帯などの追加の価格設定の詳細を定義します。たとえば、「コミュニティ メンバーシップ」という名前のサービスの場合、次の 2 つの価格を設定できます。

  • ユーザーは年間 50 ドルを支払うことになります。
  • ユーザーは毎月 3.5 ドルを支払います。

• 支払いリンク: 支払いリンクは、顧客が特定の価格で支払いを行うための URL です。顧客が支払いリンクをクリックすると、Stripe がホストする支払いページにリダイレクトされ、そこで支払い情報を入力して取引を完了できます。支払いリンクは、電子メール、メッセージング アプリ経由で共有したり、Web サイトに埋め込んだりできます。

価格では、「定期」または「1 回限り」の支払いタイプを定義することもできます。 「コミュニティ メンバーシップの例」の場合、年払いは one_type で、月払いは定期的である可能性があります。毎年、ユーザーはメンバーシップを更新し (または更新しません)、支払いタイプを再度選択します。

Stripe PHP コンポーネントをインストールする

ストライプ PHP ライブラリは、composer を使用してインストールできるため、プロジェクトのルート フォルダーで次のコマンドを実行するだけでインストールできます。

composer require stripe/stripe-php

開発者 API キーの取得

API キーを取得するには、Stripe に登録する必要があります。登録が完了したら、次の手順に進むことができます:

• Stripe アカウントにログインします。
• 画面の右上隅にある歯車アイコンをクリックし、「開発者」を選択します。
• 「API キー」をクリックすると、API キーを作成できます。

ストライプ価格を作成する

最初に製品を作成してから価格を作成するか、価格オプションに製品名を埋め込むことでストライプ価格を作成できます。すべてのプロセスを確認できるように、最初の方法を使用してコーディングしましょう。

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

上記のコードをステップごとに説明してみましょう:

• ストライプ API キーを渡す新しい StripeClient を作成します。
• 次に、「コミュニティ サブスクリプション」という名前の新しい製品を作成します。
• 最後に、次の機能を備えた最近作成された製品の価格を作成します。
  • 米ドル通貨を使用します。
  • 作成されたプロダクトを ID で参照します。
  • 支払いは繰り返し行われません。

unit_amount パラメータには特別な注意が必要です。 Stripe のドキュメントには、unit_amount について次のように記載されています。「請求金額を表すセント単位の正の整数 (無料価格の場合は 0)」。これは、unit_amount パラメーターに渡す前に、価格を 100 倍してセントに変換する必要があることを意味します。たとえば、価格が $10.99 の場合、unit_amount を 1099 に設定します。これはよくある落とし穴なので、予期しない価格設定の問題を避けるために必ずコードを再確認してください。

たとえば、浮動小数点数を金額として保持する「$amount」変数がある場合、次のようなコードを作成できます。

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

支払いリンクを作成する

これまでのところ、正しくフォーマットされた金額で価格が作成されました。次に、支払いリンクを作成します。

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

ステップバイステップで説明しましょう:

• 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

以上がStripe と PHP を使用して簡単に支払いを受け取りますの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。