3

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

Apa artikel ini membantu?

0 dari 0 menyukai artikel ini