Docs (Panduan Integrasi)

Diperbarui 10 September 2024

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.gx1.org/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.gx1.org/pay/depodomain/22000?order_id=240910HDE7C9

Berikut adalah contoh penggunaan yang salah:

https://pakasir.gx1.org/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).

Transaction Detail API

Cara lain untuk mengetahui status transaksi adalah melalui API. Disini Anda membutuhkan API Key yang terdapat di halaman detail Proyek.

Berikut ini adalah API yang bisa Anda panggil:

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

Contoh penggunaan yang benar dengan CURL:

curl https://pakasir.gx1.org/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"
  }
}