Docs (Panduan Integrasi)

Persiapan

Pertama Anda bisa lakukan dengan mendaftar/login. Setelah itu mulailah dengan membuat Proyek.

Proyek

Proyek adalah identitas dari aplikasi/website Anda. Jadi, dengan satu akun Pakasir, Anda dapat mengintegrasikan untuk banyak website/aplikasi. Yaitu dengan membuat proyek untuk masing-masing website/aplikasi.

Yang perlu dicatat disini adalah slug dari proyek Anda. slug ini nantinya akan Anda butuhkan untuk melakukan integrasi.

Integrasi Pembayaran

Untuk mengarahkan pelanggan Anda ke halaman pembayaran, cukup gunakan URL berikut:

https://pakasir.zone.id/pay/{slug}/{amount}?order_id={order_id}

• slug diambil dari proyek yang Anda miliki
• amount merupakan nominal transaksi tanpa titik dan spasi. contoh: 100000 atau 25000
• order_id adalah ID dari transaksi atau invoice di sistem Anda. contoh: INV20240910-123456 atau 1298

Berikut adalah contoh penggunaan yang benar:

https://pakasir.zone.id/pay/depodomain/22000?order_id=240910HDE7C9

Berikut adalah contoh penggunaan yang salah:

https://pakasir.zone.id/pay/Depodomain.com/Rp 22.000?order_id=-

Webhook

Ketika pelanggan berhasil melakukan pembayaran dan dana masuk ke sistem kami, maka kami akan memberitahukan sistem Anda melalui webhook.

Kami akan mengirimkan http POST dengan struktur body sebagai berikut:

{
  "amount": 22000,
  "order_id": "240910HDE7C9",
  "project": "depodomain",
  "status": "completed",
  "payment_method": "qris",
  "completed_at": "2024-09-10T08:07:02.819+07:00"
}

Untuk menerima webhook tersebut, silakan siapkan URL dan input pada proyek Anda (yaitu lewat form Edit Proyek).

Penting: Saat menerima webhook pastikan amount dan order_id sesuai dengan transaksi di sistem Anda. Kami sarankan untuk tetap menggunakan API dibawah ini untuk pengecekan status yang lebih valid.

Transaction Detail API

Untuk mengetahui status sebuah transaksi Anda bisa lakukan melalui API ini. Disini Anda membutuhkan API Key yang terdapat di halaman detail Proyek.

Berikut ini adalah API yang bisa Anda panggil:

GET https://pakasir.zone.id/api/transactiondetail?project={slug}&amount={amount}&order_id={order_id}&api_key={api_key}

Contoh penggunaan yang benar dengan CURL:

curl https://pakasir.zone.id/api/transactiondetail?project=depodomain&amount=22000&order_id=240910HDE7C9&api_key=JHGejwhe237dkhjeukyw8e33

Untuk response yang akan Anda dapatkan kurang lebih seperti berikut:

{
  "transaction": {
    "amount": 22000,
    "order_id": "240910HDE7C9",
    "project": "depodomain",
    "status": "completed",
    "payment_method": "qris",
    "completed_at": "2024-09-10T08:07:02.819+07:00"
  }
}

Wordpress/Woocomerce Plugin

Untuk panduan pemasangan plugin wordpress silakan lihat di halaman Github kami.