Apa itu PayPal API
API PayPal adalah antarmuka yang berperan sebagai perantara antara server dan program klien. Dalam kasus kami, program server yang menyediakan API bagi pengembang pihak ketiga adalah PayPal. Klien adalah program yang dibuat pengembang berdasarkan API PayPal untuk melakukan pembayaran di situs web, mengembalikan penjualan, melihat detail transaksi, menyusun rencana penagihan, menyimpan riwayat kartu kredit secara aman, dll. PayPal adalah API REST, menggunakan metode HTTP agar mudah diintegrasikan ke dalam situs web dan aplikasi seluler.
Cara Mendapatkan Kunci API PayPal, Kredensial, dan Tanda Tangan
Perlu diingat bahwa menggunakan PayPal API hanya tersedia jika Anda memiliki akun PayPal Premier, Business, atau Website Payments Pro. Pertama-tama, dalam tutorial ini Anda perlu membuat akun bisnis.
Buat akun bisnis PayPal
Langkah 1. Daftar di PayPal.
Langkah 2. Pertama-tama, Anda harus memberikan informasi tentang diri Anda: nama depan, nama belakang, email bisnis, dan kata sandi.
Langkah 3. Setelah itu, Anda harus memberikan rincian tentang bisnisnya: nama resmi, nomor telepon, dan alamatnya.
Perhatikan bahwa PayPal tersedia untuk beberapa provinsi dan negara di seluruh dunia.
Mereka adalah: Alberta, British Columbia, Manitoba, New Brunswick, NewFoundland and Labrador, Northwest Territories, Nova Scotia, Nunavut, Ontario, Prince Edward Island, Quebec, Saskatchewan, Yukon.
Jika bisnis Anda tidak termasuk di antara provinsi-provinsi ini, sebaiknya Anda membaca FAQ PayPal untuk Pengembang Internasional. Singkatnya, jika Anda adalah pengembang non-AS atau non-Inggris Raya, Anda bisa menggunakan API NVP/SOAP mereka.
Langkah 4. Selanjutnya, pilih jenis bisnis Anda dari opsi berikut: Individu, Usaha Perseorangan, Kemitraan, Korporasi, Perusahaan Swasta, Perusahaan Publik, Organisasi Nirlaba, Badan Pemerintah.
Selanjutnya, jelaskan bisnis Anda secara lebih rinci dan jawab beberapa pertanyaan:
Klik “Kirim”. Lalu, ceritakan tentang diri Anda.
Langkah 5. Setelah itu, Anda perlu memilih tujuan akun PayPal Anda. Anda bisa menggunakannya untuk meminta atau mengirim uang, mengirim faktur kepada pelanggan, atau menawarkan pembayaran PayPal di situs web. Pilih Siapkan Pembayaran Online. Sekarang, Anda sudah setengah jalan untuk mendapatkan kunci PayPal Anda.
Dapatkan kredensial API PayPal
Langkah 1. Setelah Anda membuat akun bisnis, buka Halaman Pengembang PayPal dan masuk ke dasbor.
Langkah 2. Setelah masuk, Anda bisa mendapatkan API key PayPal pribadi. Untuk ini, buka bagian “Aplikasi & Kredensial Saya” dan klik “Buat Aplikasi”
Langkah 3. Masukkan nama aplikasi dan klik “Buat” sekali lagi. Anda akan mendapatkan Client ID, nama akun Sandbox, dan “Secret”.
Dapatkan Tanda Tangan API PayPal atau Sertifikat
Langkah berikutnya adalah menghasilkan kredensial PayPal API Signature atau kredensial API Certificate. Jika Anda bingung memilih yang mana, berikut penjelasan perbedaannya:
- PayPal API Signature includes an API Username, API Password, and Signature, which does not expire.
- Kredensial Sertifikat API mencakup Nama Pengguna API di PayPal, Kata Sandi API, dan Sertifikat, yang kedaluwarsa secara otomatis setelah tiga tahun.
Perlu diingat: untuk mendapatkan kredensial API di PayPal, Anda perlu memiliki alamat email yang terverifikasi.
Inilah cara mendapatkan kredensial Tanda Tangan API atau Sertifikat untuk akun PayPal Anda:
- Masuk ke PayPal akun Sandbox, gunakan data profil bisnis Anda.
- Klik ikon Pengaturan.
- Klik Akses Akun di bawah “Akun & Keamanan” di sisi kiri halaman.
- Di bagian “Akses API”, klik “Perbarui”.
- Klik “Kelola kredensial API” di bawah “Integrasi API NVP/SOAP”.
- Pilih salah satu opsi berikut. Request API Signature – Pilih untuk otentikasi API Signature. Request API Certificate – Pilih untuk otentikasi API Certificate.
- Klik “Setuju” dan “Kirim”.
- Selesai! Setelah itu, PayPal akan menghasilkan kredensial API Anda.
Contoh API PayPal
PayPal menawarkan beberapa REST API dan membaginya menjadi tiga kategori:
- Live – baru dirilis, sepenuhnya didukung, dan tersedia untuk pelanggan baru.
- Rilis terbatas – API yang sepenuhnya didukung, tersedia di pasar tertentu.
- Usang – diarsipkan tetapi API tetap didukung sepenuhnya.
Anda bisa menemukan contoh paling populer di bawah ini.
API Pencairan
Jenis API ini digunakan untuk mengirim uang ke beberapa penerima PayPal. Cocok bagi Anda yang ingin mengirim hadiah, rebate, dan komisi. Penerima harus memberikan alamat email, nomor telepon seluler, atau Payer ID mereka.
API REST Pembayaran
Jenis API yang paling luas dan fungsional. Digunakan untuk menerima pembayaran online secara aman dan lancar di situs web maupun aplikasi. Dapat menerima pembayaran segera atau menundanya, menampilkan detail transaksi yang telah selesai, serta melakukan pengembalian penuh atau sebagian.
PayPal Express Checkout API
Tombol pembayaran PayPal pintar memberi pengguna proses pembayaran yang paling relevan, mudah, dan aman. Anda bisa dengan mudah menyesuaikan tombol PayPal, dan ada peluang untuk menambahkan metode pembayaran alternatif seperti Venmo atau kartu kredit. Jika Anda menambahkannya ke situs web atau aplikasi Anda, cara kerjanya adalah: pertama, jendela pop-up checkout muncul dan meminta pengguna untuk masuk ke PayPal. Kedua, setelah pembeli menyetujui pembayaran, PayPal Orders API akan menyelesaikan transaksi.
API Langganan
Anda diizinkan memulai proses pembayaran PayPal berulang untuk barang fisik dan jasa, serta produk digital. Ada opsi untuk menentukan jumlah pembayaran tetap dan rencana berjenjang.
API Sengketa PayPal
Jika ada masalah yang terjadi di pihak PayPal, mereka menawarkan untuk membuka sengketa dan berkomunikasi dengan tim dukungan mereka.
API Pembayaran Berulang PayPal
Contoh API ini sudah tidak direkomendasikan lagi, meskipun tim PayPal tetap mendukung pedagang yang masih menggunakannya. API pembayaran berulang adalah analog dari API Langganan, tetapi memiliki fungsionalitas yang lebih terbatas.
API Faktur
Contoh API ini sudah usang, meskipun tim PayPal sepenuhnya mendukung pedagang yang masih menggunakannya. API pembayaran berulang adalah analog dari API Langganan, tetapi memiliki fungsionalitas yang lebih sedikit. Untuk melacak pembayaran faktur, Anda bisa menggunakan webhook — callback HTTP khusus yang menerima pesan notifikasi untuk peristiwa.
PayPal menyediakan eksekutor API yang memungkinkan pengembang menguji dan mengintegrasikan produk sebelum diluncurkan. Gunakan ini untuk memeriksa kinerja produk apa pun yang Anda pilih.
Integrasi PayPal di situs web
Untuk menampilkan tombol PayPal di situs web, Anda perlu menjalankan alur kerja Tim Teknik (Engineering) dan Tim Bisnis secara bersamaan.
Pertama, buat solusi API Anda sendiri seperti yang dijelaskan dalam artikel ini sebelumnya. Kedua, buat sandbox untuk menguji produk (sebagai pengembang) dan ajukan permintaan akun Live. Akun Live akan mengintegrasikan semua fungsi PayPal. Integrasikan dan uji produk yang telah Anda buat. Setelah semuanya berjalan dengan baik, tandatangani kontrak untuk mendapatkan akun Live. Siapkan semua hal untuk go-live, periksa dengan teliti, dan akhirnya luncurkan solusi berbasis PayPal API Anda!
Jika Anda tidak ingin menghabiskan banyak waktu untuk melewati semua langkah tersebut, manfaatkan Tombol PayPal yang bisa disesuaikan, menarik, dan mudah diintegrasikan oleh Elfsight. Cukup buat akun bisnis di PayPal dan siap untuk menyematkan tombol di situs web.
Salah satu contoh API yang paling populer adalah PayPal Express Checkout yang menggunakan metode Integrasi NVP dan SOAP. Ini sudah usang, dan meskipun PayPal masih mendukungnya, API Checkout yang lebih baru menggunakan fitur-fitur baru yang lebih canggih.
Batas API PayPal dan Harga
Jika Anda menerima pembayaran dari akun PayPal, Anda akan dikenakan biaya persentase tertentu ditambah biaya tetap berdasarkan mata uang. Jika Anda menggunakan PayPal, Anda tidak perlu membayar biaya bulanan atau biaya terminasi pada 2020. Di bawah ini, Anda akan melihat berapa biaya menggunakan PayPal di beberapa negara:
| Jika pembayaran yang Anda terima berasal dari akun PayPal di: | Anda perlu membayar |
| Kanada | biaya sebesar 2,9% dari jumlah transaksi ditambah $0,30 CAD |
| USA | biaya sebesar 3,7% dari jumlah transaksi ditambah US$0,30 |
| Eropa | Biaya sebesar 3,9% dari jumlah transaksi, ditambah €0,35 EUR |
| Rusia | biaya sebesar 3,9% dari jumlah transaksi ditambah 10 RUB |
| Brasil | Biaya sebesar 3,9% dari jumlah transaksi ditambah 0,60 BRL |
| Meksiko | biaya sebesar 3,9% dari jumlah transaksi ditambah $4,00 MXN |
| Singapura | Biaya sebesar 3,9% dari jumlah transaksi ditambah $0.50 SGD |
Periksa daftar negara dan biaya lengkap di halaman PayPal Payments Standard page.
Mengenai batas harian tentang berapa kali Anda bisa mengakses PayPal API, Anda bisa melakukan sebanyak-banyaknya panggilan. Namun, kami menyarankan agar tidak terlalu sering mengakses API.
Dokumentasi PayPal
Dokumentasi API PayPal sangat luas karena menjelaskan proses pembayaran di seluruh dunia. Untuk menggunakannya, Anda perlu memilih jenis akun: Developer, Personal atau Business. Kedua, pilih jenis API yang ingin Anda gunakan dalam proyek (kami telah enumerasikan sebelumnya). Selanjutnya, temukan halaman dengan jenis API yang dibutuhkan, pelajari metode dan objek yang ditawarkan oleh PayPal, dan akhirnya uji apa yang Anda dapatkan di Sandbox pengembang.
Perubahan API PayPal
PayPal telah menghentikan beberapa tipe API, meskipun tetap didukung. Memahami sederet perubahan pada API PayPal bisa membantu mempelajari proses integrasinya ke dalam sebuah situs web.
Perubahan 2018: Tata letak tombol horizontal mulai digunakan secara baku; contoh kode dalam Integrasi API Payouts diperbarui; notasi yang direkomendasikan dan baku untuk tombol Smart Payment kecil dihapus.
Perubahan 2019: Contoh kode ditambahkan ke fitur konversi mata uang, serta daftar negara yang dikecualikan.
Perubahan 2020: Penanganan pembayaran berulang telah diperbarui. Pengguna sekarang harus membuat pembayaran berulang, daripada hingga 10 pembayaran sekaligus.
FAQ
Haruskah saya mendaftar sebagai pengembang jika saya bisa mengakses sandbox tanpa masuk ke situs pengembang?
Tidak wajib. Namun jika Anda ingin mengakses beberapa fitur keren seperti membuat akun uji pra-konfigurasi, kredensial REST API, dan dasbor transaksi, sebaiknya Anda melakukannya.
Bisakah riwayat transaksi saya dipulihkan menggunakan API NVP/SOAP jika saya saat ini menggunakan REST API?
Maaf, tidak, tetapi khusus untuk kasus ini, para pengembang PayPal telah memperkenalkan API TransactionSearch.
Haruskah saya biarkan string kosong jika nilainya opsional?
Handler sebaiknya tidak dibiarkan berisi string kosong; jika Anda tidak ingin mengisi bidang opsional, cukup tidak menambahkannya.
Akankah semua API NVP/SOAP PayPal diperbarui menjadi REST?
PayPal saat ini meningkatkan layanan mereka, dan API NVP, yang termasuk generasi lama, akan segera diperbarui.
Kesimpulan
Membaca seluruh dokumentasi PayPal bisa memakan waktu berjam-jam, karena Anda perlu mengatur proses penerimaan dan pembayaran melalui situs atau aplikasi. Masalah lain adalah PayPal saat ini beralih dari API NVP/SOAP lama ke REST, yang berarti dokumentasi dua kali lipat dibanding sebelumnya.
Saat ini, Anda bisa memasang tombol PayPal Elfsight yang mudah disesuaikan di situs web tanpa coding dan tanpa membaca banyak halaman dokumentasi. Cukup daftar akun bisnis PayPal — prosesnya ada di tutorial kami — dan buat widget dengan fungsionalitas luar biasa. Coba sekarang!
