Bantuan

FAQ

Pertanyaan yang sering diajukan tentang integrasi AKD Pay.

Metode pembayaran apa yang didukung?#

QRIS (QR dinamis) dan VIRTUAL_ACCOUNT (alias VA), hanya dalam rupiah (IDR) untuk Indonesia. Kartu dan e-wallet belum didukung. Metode yang aktif untuk project Anda bisa dicek dengan GET /v1/integration-context?project_id=….

Berapa nominal minimum?#

QRIS minimal IDR 1, Virtual Account minimal IDR 10.000. Nominal selalu bilangan bulat tanpa desimal.

Berapa lama pembayaran berlaku?#

Saat ini 30 menit (expires_at di respons). Setelah itu pembayaran menjadi EXPIRED dan Anda menerima payment.expired. Untuk mencoba lagi, buat pembayaran baru dengan external_order_id dan Idempotency-Key baru.

Apakah sandbox memakai uang sungguhan?#

Tidak. Sandbox memakai mode uji penyedia pembayaran, dan pembayaran dilunasi dengan simulasi. Uang sungguhan hanya ada di live.

Apakah API key sandbox bisa dipakai di live?#

Tidak. Sandbox dan live adalah sistem terpisah dengan merchant_id, project_id, API key, endpoint webhook, dan secret masing-masing. Lihat Sandbox vs Live.

Apakah ada halaman bayar di live?#

Tidak. payment_url dan POST /v1/hosted/payments hanya ada di sandbox. Di live, tampilkan checkout.qr_string (QRIS) atau checkout.account_number (VA) di aplikasi Anda.

Kapan pesanan boleh ditandai lunas?#

Hanya dari webhook payment.paid yang signature-nya terverifikasi, atau dari GET /v1/payments/{id} berstatus PAID. Jangan dari redirect browser atau return_url.

Webhook saya tidak datang. Apa yang harus dilakukan?#

Cek riwayat webhook di Dashboard Merchant → Pengembang. Delivery yang gagal dicoba ulang sampai 10 kali (sekitar 1,5 hari); setelah itu berstatus DEAD dan bisa dikirim ulang dari dashboard. Sambil menunggu, baca status dengan GET /v1/payments/{id}. Detail: Retry, DEAD, dan kirim ulang.

Bagaimana jika request pembuatan pembayaran timeout?#

Ulangi dengan Idempotency-Key dan body yang sama. AKD mengembalikan pembayaran yang sama, bukan pembayaran baru. Lihat Idempotensi.

API key saya bocor. Apa yang harus dilakukan?#

Segera minta pencabutan ke tim AKD di partnership@algoritmakitadigital.id. Key baru bisa dibuat sebelum key lama dicabut, sehingga rotasi tidak memutus layanan.

Bisakah saya melakukan refund lewat API?#

Belum di v1.0.x. Refund dilakukan oleh tim AKD atas permintaan Anda, dan hasilnya dikirim lewat webhook payment.refunded. Lihat Refund.

Siapa yang memproses dana pembayaran?#

AKD menyediakan layanan integrasi teknis pembayaran. Pemrosesan pembayaran dan penyelesaian dana dilakukan oleh mitra penyedia jasa pembayaran berizin Bank Indonesia.