Terima pembayaran dengan mudah menggunakan Stripe dan PHP

pengenalan

Banyak kali, aplikasi kami memerlukan cara mudah untuk membuat pembayaran untuk membeli produk atau perkhidmatan. Stripe boleh menjadi pilihan yang baik untuk menerima pembayaran. Dalam siaran ini, kami akan mempelajari cara membuat pautan pembayaran berjalur supaya anda boleh mengubah hala pengguna anda ke pautan tersebut untuk menghantar pembayaran mereka.

Apa itu Stripe?

Stripe ialah syarikat teknologi yang menyediakan perkhidmatan pemprosesan pembayaran dalam talian, membolehkan perniagaan menerima pembayaran melalui internet. Ia menawarkan set alatan dan API yang membolehkan syarikat mengurus urus niaga dalam talian, langganan dan tugas berkaitan pembayaran lain.

Sebelum mula menulis kod, kita mesti memahami komponen Stripe berikut:

• Produk: Produk mewakili barang atau perkhidmatan yang ingin anda jual. Ia termasuk nama, perihalan dan butiran harga antara lain.

• Harga: Harga ialah konfigurasi harga khusus untuk produk. Ia mentakrifkan amaun yang pelanggan akan bayar untuk produk, serta sebarang butiran harga tambahan seperti mata wang, kitaran pengebilan dan peringkat harga. Sebagai contoh, untuk perkhidmatan bernama "Keahlian Komuniti" anda boleh mempunyai dua harga:

  • Tahunan yang mana pengguna akan membayar 50$ setahun.
  • Bulanan yang mana pengguna akan membayar 3.5$ sebulan.

• Pautan pembayaran: Pautan pembayaran ialah URL yang membolehkan pelanggan membuat pembayaran untuk harga tertentu. Apabila pelanggan mengklik pada pautan pembayaran, mereka dialihkan ke halaman pembayaran yang dihoskan oleh Stripe di mana mereka boleh memasukkan maklumat pembayaran mereka dan menyelesaikan transaksi. Pautan pembayaran boleh dikongsi melalui e-mel, apl pemesejan atau dibenamkan pada tapak web anda.

Harga juga membolehkan kami menentukan jenis pembayaran yang boleh "berulang" atau "satu_masa". Untuk "Contoh keahlian komuniti", bayaran tahunan boleh menjadi one_type dan bayaran bulanan boleh berulang. Setiap tahun, pengguna akan memperbaharui (atau tidak) keahlian mereka dan akan memilih jenis pembayaran sekali lagi.

Pasang komponen Stripe PHP

Pustaka php jalur boleh dipasang menggunakan komposer, jadi, untuk memasangnya, anda hanya perlu melaksanakan arahan berikut dalam folder akar projek anda:

composer require stripe/stripe-php

Mendapatkan semula kunci API Pembangun

Sebelum anda boleh mendapatkan kunci api anda, anda mesti berdaftar di Stripe. Seseorang yang telah anda daftarkan, anda boleh mengikuti langkah seterusnya:

• Log masuk ke akaun Stripe anda.
• Klik pada ikon gear di penjuru kanan sebelah atas skrin dan pilih "Pembangun".
• Klik pada "kunci API" dan anda akan dapat menciptanya.

Buat Harga Stripe

Kita boleh mencipta Harga Stripe mencipta produk dahulu dan kemudian harga atau membenamkan nama produk ke dalam pilihan harga. Mari kita kodkannya menggunakan cara pertama supaya kita dapat melihat semua prosesnya.

$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'
]);

Mari terangkan kod di atas langkah demi langkah:

• Kami mencipta StripeClient baharu yang melepasi kekunci api jalur kami.
• Kemudian, kami mencipta produk baharu bernama "Langganan Komuniti".
• Akhir sekali, kami mencipta harga untuk produk yang dibuat baru-baru ini dengan ciri-ciri berikut:
  • Ia menggunakan mata wang de USD.
  • Ia merujuk kepada produk yang dicipta oleh idnya.
  • Bayaran tidak akan berulang.

Parameter jumlah_unit patut diberi perhatian khusus. Dokumentasi Stripe menyatakan perkara berikut tentang unit_amount: "Integer positif dalam sen (atau 0 untuk harga percuma) mewakili jumlah yang perlu dicaj." Ini bermakna kita mesti mendarabkan harga dengan 100 untuk menukarnya kepada sen sebelum menghantarnya kepada parameter unit_amount. Sebagai contoh, jika harga ialah $10.99, kami akan menetapkan unit_amount kepada 1099. Ini adalah gotcha biasa, jadi pastikan anda menyemak semula kod anda untuk mengelakkan sebarang isu harga yang tidak dijangka.

Sebagai contoh, jika anda mempunyai pembolehubah "$amount" yang memegang nilai apungan sebagai amaun, anda boleh kodkan sesuatu seperti ini:

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

Buat pautan pembayaran

Setakat ini, kami mempunyai harga yang dibuat dengan jumlah yang diformatkan dengan betul. Kini tiba masanya untuk membuat pautan pembayaran.

$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>
        ]
     ]
]);

Jom terangkan langkah demi langkah:

• 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

Atas ialah kandungan terperinci Terima pembayaran dengan mudah menggunakan Stripe dan PHP. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!