Panduan Integrasi API Sibayar untuk Merchant
Sebagai panduan, berikut ini adalah dokumentasi yang disyaratkan sesuai dengan entitas bisnis.
Deni Boy Firmansyah
Tanggal Pembaruan Terakhir 17 hari yang lalu
Berikut adalah panduan umum untuk integrasi API Sibayar bagi merchant. Integrasi API ini memungkinkan merchant untuk menghubungkan sistem mereka dengan platform Sibayar, mempermudah proses pembayaran dan pengelolaan transaksi.
---
1. Persiapan
Akses API Key: Dapatkan API Key dari Sibayar yang akan digunakan untuk autentikasi saat mengakses API. API Key ini unik untuk setiap merchant dan harus dijaga kerahasiaannya.
Dokumentasi API: Pastikan Anda memiliki akses ke dokumentasi API terbaru dari Sibayar, yang berisi endpoint, parameter, dan respons yang tersedia.
2. Konfigurasi Endpoint
URL: Sibayar menyediakan dua URL yang dapat digunakan, yaitu Sandbox dan Live
Sandbox URL : api-dev.sibayar.co.id
Live : live.sibayar.co.id
Beberapa endpoint yang bisa digunakan:
Authentication: /auth/access-token untuk memperoleh token autentikasi.
Create Transaction: /payment/:method/initiate untuk membuat transaksi baru.
Check Transaction Status: /payment/:method/status/:transaction_id untuk memeriksa status transaksi.
3. Autentikasi
Untuk mengakses API, menggunakan metode JWT Token.
Langkah-langkah:
1. Kirim request POST ke /auth/access-token dengan API Key Anda.
2. Dapatkan access token dari respons yang berhasil.
3. Gunakan token ini di header untuk setiap permintaan lainnya:
Authorization: Bearer <access_token>
4. Membuat Transaksi
Endpoint: POST /payment/:method/initiate
Parameter yang dibutuhkan:
amount: Jumlah yang harus dibayar.
callback_url: URL callback client
timeout: waktu expired transaksi yang dibuat
firstName: nama depan pembeli
lastName: nama belakang pembeli
email: email pembeli
mobilePhone: nomor telepon pembeli
send_whatsapp: pilihan untuk mengirimkan whatsapp ke pembeli
Contoh Request:
{
"amount": 20000,
"callback_url": "https://your-callback-url.com/payment/notification",
"customer": {
"firstName": "First Name Example",
"lastName": "Last Name Example",
"email": "[email protected]",
"mobilePhone": "08123456789"
},
"custom_meta": {
"partnerOrderId": "Your Transaction ID",
"source": "Mobile App",
"promoCode": "PROMO10",
"category": "apparel",
"description": "Your Custom Description"
},
"timeout": 6,
"send_whatsapp": true
}
Respons akan memberikan detail transaksi, termasuk transaction_id untuk pelacakan.
5. Memeriksa Status Transaksi
Endpoint: GET /payment/:method/status/:transaction_id
Gunakan transaction_id untuk mengecek status pembayaran dari transaksi.
Status yang diberikan:
pending: Menunggu pembayaran.
paid: Pembayaran berhasil.
expired: Transaksi sudah kadaluarsa.
6. Uji Coba Integrasi
Environment Pengujian: Lakukan uji coba di lingkungan sandbox atau staging yang disediakan Sibayar untuk memastikan integrasi berjalan dengan baik sebelum masuk ke lingkungan produksi.
Pengujian Endpoint: Uji setiap endpoint utama, termasuk autentikasi, pembuatan transaksi, pengecekan status, dan Webhook.
7. Error Handling dan Logging
Pastikan untuk menangani berbagai kode respons error dari API Sibayar, seperti:
400 Bad Request: Parameter tidak valid atau kurang lengkap.
401 Unauthorized: Autentikasi gagal atau token kadaluarsa.
500 Internal Server Error: Terjadi masalah pada server Sibayar.
Implementasikan logging untuk setiap transaksi dan respons yang diterima agar mudah melacak jika ada masalah.
---
Panduan ini mencakup langkah-langkah dasar yang dibutuhkan untuk integrasi API Sibayar dengan sistem merchant. Untuk informasi lebih detail, silakan merujuk ke dokumentasi resmi dari Sibayar.
untuk informasi selengkapnya tentang integrasi API klik disini