PayPal

Apa yang Anda butuhkan

Kenapa kami meminta setiap kolom

Client ID

Mengidentifikasi app PayPal Anda pada panggilan API. Ia hanya berfungsi saat dipasangkan dengan Client secret.

Client secret

Bagian privat dari autentikasi API. Bersama Client ID, ia membiarkan kami membuat pesanannya, agar pembayarannya berjalan lewat akun Anda.

Webhook ID

Cara kami memastikan sebuah webhook benar-benar dari PayPal: PayPal mengidentifikasi setiap webhook dengan sebuah ID, dan kami memakainya untuk bertanya langsung ke PayPal apakah sebuah pesan tertentu otentik. Itu menghentikan siapa pun memalsukan event "paid".

Success and Cancel URL

Pengaturan biasa: tempat pembeli mendarat setelah membayar atau mundur. Bukan rahasia.

Penyiapan

1. Buka dasbor PayPal Developer

   Masuk di developer.paypal.com. PayPal memberi Anda Sandbox gratis dengan akun bisnis dan pembeli palsu, sehingga Anda bisa menguji tanpa memindahkan uang nyata. Panduan ini menggunakan Sandbox; alur Live identik, cukup balik toggle Sandbox / Live (kiri atas) dan gunakan akun PayPal for Business. Dari dasbor, buka Apps & Credentials.

   ⤢
2. Buat aplikasi

   Di halaman API Credentials, pastikan toggle Sandbox dipilih, lalu klik Create App (kanan atas).

   ⤢
3. Beri nama dan pilih Merchant

   Masukkan App Name (misalnya "Coin Moebius"), biarkan Type pada Merchant, pilih akun bisnis sandbox Anda, dan klik Create App.

   ⤢
4. Salin Client ID dan Client secret Anda

   PayPal membuka aplikasi baru Anda. Salin Client ID dan tampilkan serta salin Secret key. (Anda juga bisa menyalin keduanya dari baris Default Application di daftar API Credentials.) Simpan keduanya.

   ⤢

   ⤢

   Client secret bersifat rahasia, perlakukan seperti kata sandi. Aplikasi sandbox dan aplikasi live masing-masing memiliki pasangannya sendiri, jadi jangan mencampurnya.

5. Tambahkan webhook

   Gulir ke bawah halaman aplikasi ke bagian Sandbox Webhooks dan klik Add Webhook. Di kolom Webhook URL, tempel alamat webhook PayPal proyek Anda (di bawah). Kemudian pilih event yang didengarkan Coin Moebius, dan Save.

   • Pembayaran sekali bayar: CHECKOUT.ORDER.APPROVED, PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.DENIED, PAYMENT.CAPTURE.DECLINED, PAYMENT.CAPTURE.REFUNDED, PAYMENT.CAPTURE.REVERSED, CUSTOMER.DISPUTE.CREATED.
   • Langganan (hanya jika Anda menjualnya): BILLING.SUBSCRIPTION.ACTIVATED, BILLING.SUBSCRIPTION.UPDATED, BILLING.SUBSCRIPTION.CANCELLED, BILLING.SUBSCRIPTION.PAYMENT.FAILED, PAYMENT.SALE.COMPLETED. Jika Anda tidak menagih secara berulang, lewati ini.
   • Terburu-buru? Memilih All Events (wildcard di bagian atas) juga bisa, kami mengabaikan yang tidak kami gunakan.

   https://api.coinmoebius.com/webhook/paypal/<your project id>

   ⤢

   ID proyek Anda ada di bawah nama proyek di dasbor Coin Moebius; masukkan ke alamat di atas. Kartu penyedia yang terhubung (langkah terakhir) menampilkan URL yang sama sebagai referensi.

6. Salin Webhook ID

   Webhook Anda kini muncul di daftar Sandbox Webhooks. Salin Webhook ID yang ditampilkan di sebelahnya. Ini adalah cara Coin Moebius meminta PayPal untuk mengonfirmasi bahwa setiap webhook benar-benar asli. Daftarkan webhook terpisah di sandbox dan di live.

   ⤢
7. Kembali di Coin Moebius: Add provider → PayPal

   Di proyek Anda, buka tab Providers, klik Add provider, pilih Connect a service, dan pilih PayPal. Atur Success URL dan Cancel URL Anda. Menguji dengan kredensial sandbox? Gunakan tab Test (opsional) dan tempel Client ID, Client secret, dan Webhook ID di sana, lalu klik Save. Langsung ke live? Gunakan tab Live. Grup Test bersifat semua-atau-tidak-sama-sekali: ketiga kolom, atau tidak sama sekali.

   ⤢
8. Anda sudah terhubung

   PayPal kini muncul di tab Providers Anda beserta tanggal koneksinya (ditandai TEST saat Anda menggunakan kredensial sandbox). Kartu menampilkan URL webhook yang sama yang Anda tempel ke PayPal, plus Edit dan Disconnect.

   ⤢
9. Uji dengan pembeli sandbox

   Untuk membayar melalui checkout uji, Anda memerlukan login pembeli sandbox. Di PayPal, buka Testing Tools → Sandbox Accounts untuk melihat akun Business dan Personal palsu Anda.

   ⤢
10. Dapatkan detail login pembeli

    Buka akun Personal (pembeli) untuk melihat Login Info-nya: URL sandbox, email, dan kata sandi. Masuk di sandbox.paypal.com dengan data tersebut saat checkout uji meminta Anda membayar. Tidak ada uang nyata yang berpindah.

    ⤢

Setelah Anda menghubungkan

Jalankan satu pembayaran uji sebelum tayang:

1. Buat sebuah produk dan atur Environment-nya ke Testing. Itu menjalankan produknya pada kredensial sandbox Anda, jadi Anda bisa memesan penuh tanpa memindahkan uang. (Jika Anda melewatkan set sandbox, produk Testing kembali ke live, jadi tambahkan dulu.)
2. Taruh tombol beli di sebuah halaman (berkas HTML lokal pun berfungsi) yang menunjuk ke proyek Anda.
3. Selesaikan checkout dengan membayar memakai akun pembeli sandbox Anda.
4. Buka tab Transaksi. Sebuah baris baru muncul, bertanda Testing. Saat statusnya mencapai succeeded, kredensial dan webhook Anda keduanya berfungsi dari ujung ke ujung.

Alihkan Environment produk ke Live saat Anda siap untuk pembayaran sungguhan.

Pemecahan masalah

Mulai dengan Verify. Di dasbor, klik Verify (atau Verify test credentials untuk sandbox) untuk memeriksa kredensial klien Anda.

Verify gagal.

Salin ulang Client ID dan Client secret. App sandbox dan app live punya pasangan berbeda, jadi jangan mencampurnya.

Pembayaran selesai tapi pesanan tetap pending.

Webhook ID harus berasal dari app dan lingkungan yang sama dengan kredensial klien Anda. Kredensial live butuh webhook id live. Pastikan URL webhook cocok.

Pastikan dari ujung ke ujung.

Dasbor Developer PayPal → Webhooks Simulator: kirim event contoh ke URL webhook Anda, lalu amati pesanannya diperbarui.

Baik untuk diketahui

Memutar secret. Hasilkan client secret baru kapan saja, lalu tempel. Kolom rahasia tetap kosong saat diedit.

Ada pertanyaan? Join our Discord