Amalan Terbaik Integrasi Stripe: Mewujudkan Penyelesaian Pembayaran yang Berkesan

Dalam era digital hari ini, pemilihan sistem pembayaran adalah sangat penting, terutamanya di kalangan syarikat permulaan dan peniaga kecil. Stripe sebagai platform pemprosesan pembayaran terkemuka, sangat popular kerana kemudahan penggunaannya dan API yang kuat. Artikel ini akan memberikan beberapa amalan terbaik untuk integrasi Stripe, membantu pemaju mewujudkan penyelesaian pembayaran yang berkesan.

1. Memahami Fungsi Teras Stripe

Sebelum memulakan integrasi Stripe, adalah penting untuk memahami fungsi teras dan perkhidmatan yang ditawarkan. Stripe membolehkan pengguna melakukan perkara berikut:

• Pemprosesan Pembayaran Dalam Talian: Menyokong kad kredit, kad debit, dan pelbagai kaedah pembayaran.
• Langganan Berkala: Menguruskan kutipan berkala dengan mudah.
• Pengurusan Invois: Menghasilkan dan menghantar invois secara automatik.
• Pengesanan Penipuan: Alat pengesanan penipuan terbina dalam untuk melindungi keselamatan transaksi.

2. Membuat Akaun Stripe

Untuk menggunakan Stripe, anda perlu terlebih dahulu membuat akaun Stripe:

1. Lawati Laman Web Stripe.
2. Klik "Start now", isi maklumat yang berkaitan untuk mendaftar akaun.
3. Sahkan emel dan lengkapkan tetapan akaun.

3. Mendapatkan Kunci API

Semasa mengintegrasikan Stripe, anda perlu menggunakan kunci API, yang terbahagi kepada kunci ujian dan kunci pengeluaran:

1. Log masuk ke papan pemuka Stripe.
2. Navigasi ke bahagian "Pembangun", pilih "Kunci API".
3. Salin "Kunci Terbitan" dan "Kunci Rahsia".

Nota: Jangan sekali-kali mendedahkan kunci rahsia dalam kod klien.

4. Memasang SDK Stripe

Stripe menyediakan SDK dalam pelbagai bahasa, seperti Node.js, Python, Ruby, dan lain-lain. Berikut adalah cara untuk memasang SDK Stripe dalam projek Node.js:

npm install stripe

5. Melaksanakan Proses Pembayaran Asas

Berikut adalah contoh kod untuk melaksanakan pembayaran Stripe dalam aplikasi Node.js:

Membuat Niat Pembayaran

Di belakang, buat niat pembayaran (Payment Intent), ini akan membantu memproses pembayaran pengguna.

const express = require('express');
const stripe = require('stripe')('your_secret_key');

const app = express();
app.use(express.json());

app.post('/create-payment-intent', async (req, res) => {
    const { amount, currency } = req.body;

    try {
        const paymentIntent = await stripe.paymentIntents.create({
            amount,
            currency,
        });
        res.json({ clientSecret: paymentIntent.client_secret });
    } catch (error) {
        res.status(500).send(error);
    }
});

Mengendalikan Pembayaran di Frontend

Di halaman frontend, gunakan perpustakaan JavaScript Stripe untuk mengendalikan pembayaran.

Pembayaran

    const stripe = Stripe('your_publishable_key'); // Gantikan dengan kunci terbitan anda
    const button = document.getElementById('checkout-button');

    button.addEventListener('click', () => {
        fetch('/create-payment-intent', {
            method: 'POST',
            headers: {
                'Content-Type': 'application/json'
            },
            body: JSON.stringify({ amount: 1000, currency: 'usd' }) // Contoh $10.00
        })
        .then(response => response.json())
        .then(data => {
            return stripe.redirectToCheckout({
                sessionId: data.clientSecret
            });
        })
        .then(result => {
            if (result.error) {
                alert(result.error.message);
            }
        });
    });

6. Langganan Berkala

Jika anda perlu mengendalikan langganan berkala, Stripe menyediakan alat yang mudah untuk menyokong fungsi ini. Berikut adalah langkah asas untuk membuat langganan:

Membuat Produk dan Harga

Di papan pemuka Stripe, buat produk dan maklumat harga yang berkaitan. Pastikan maklumat harga ditetapkan untuk penagihan berkala.

Membuat Langganan

Gunakan kod berikut untuk membuat langganan:

const subscription = await stripe.subscriptions.create({
    customer: 'cus_123', // Gantikan dengan ID pengguna
    items: [{
        price: 'price_123', // Gantikan dengan ID harga yang anda buat
    }],
});

7. Mengendalikan Webhook

Untuk mengendalikan acara kejayaan pembayaran, kegagalan atau pengembalian wang, menggunakan Webhook adalah amalan terbaik. Tetapkan Webhook untuk mendengar acara tertentu:

1. Di papan pemuka Stripe, navigasi ke "Webhook".
2. Tambah URL untuk menerima pemberitahuan acara.

Berikut adalah contoh kod asas untuk mengendalikan Webhook:

app.post('/webhook', express.raw({ type: 'application/json' }), (req, res) => {
    const sig = req.headers['stripe-signature'];
    
    let event;

    try {
        event = stripe.webhooks.constructEvent(req.body, sig, endpointSecret);
    } catch (err) {
        console.log(`Ralat Webhook: ${err.message}`);
        return res.status(400).send(`Ralat Webhook: ${err.message}`);
    }

    // Mengendalikan acara
    if (event.type === 'payment_intent.succeeded') {
        const paymentIntent = event.data.object;
        console.log(`PaymentIntent berjaya!`);
    }

    res.json({ received: true });
});

8. Menguji Proses Pembayaran

Sebelum menyebarkan aplikasi ke persekitaran pengeluaran, sentiasa pastikan untuk menguji secara menyeluruh dalam mod ujian Stripe. Gunakan kad ujian yang disediakan oleh Stripe untuk pembayaran.

9. Pertimbangan Keselamatan

• Jangan mendedahkan kunci rahsia di klien.
• Pastikan keselamatan pemindahan data melalui HTTPS.
• Perhatikan amalan keselamatan terbaik yang disediakan dalam dokumentasi Stripe.

10. Kesimpulan

Stripe memberikan penyelesaian pembayaran yang kuat untuk pemaju, melalui langkah-langkah dan amalan terbaik di atas, anda boleh mengintegrasikan sistem pembayaran dengan berkesan. Semasa proses integrasi, pastikan untuk memberi perhatian kepada keselamatan dan pengalaman pengguna untuk meningkatkan kadar penukaran dan kepuasan pelanggan. Diharapkan artikel ini dapat membantu anda menyelesaikan integrasi dan pembangunan aplikasi Stripe dengan lancar.

Untuk sokongan teknikal dan maklumat yang lebih mendalam, sila lawati Dokumentasi Rasmi Stripe.