Mulai cepat
Dua langkah: ambil API key dari .env server, lalu kirim request ke gateway. Tidak ada SDK khusus yang perlu diinstal.
Base URL:
https://www.alldaypay.my.id
Request pertama — buat tagihan Rp10.000:
curl -X POST https://www.alldaypay.my.id/api/payments \
-H "Authorization: Bearer ALldayPay_API_KEY" \
-H "Content-Type: application/json" \
-d '{"amount": 10000, "description": "Pesanan #1287"}'Autentikasi
Semua request pakai header Authorization: Bearer <API_KEY>. API key di-generate saat install dan tersimpan di .env server (variabel API_KEY). Key jangan pernah dipanggil dari browser — selalu server-to-server.
Buat tagihan
POST /api/payments — body JSON:
| Field | Wajib | Ket |
|---|---|---|
| amount | ya | Rupiah, 1.000–10.000.000. Kode unik 100–250 otomatis ditambahkan. |
| description | tidak | Teks bebas, tampil di halaman bayar. |
| reference | tidak | ID pesanan di sistem lo. |
| callback_url | tidak | URL webhook saat status berubah. |
| redirect_url | tidak | Pembeli diarahkan ke sini setelah lunas. |
| expires_in | tidak | Menit, default 15 (5–60). |
Response 201 — field penting: pay_url (redirect pembeli ke sini), amount (yang harus dibayar), qris (payload mentah).
Contoh integrasi PHP:
$ch = curl_init("https://www.alldaypay.my.id/api/payments");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer ALldayPay_API_KEY",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode([
"amount" => 10000,
"description" => "Pesanan #1287",
"redirect_url" => "https://toko.example/selesai",
]),
]);
$res = json_decode(curl_exec($ch), true);
// redirect pembeli ke halaman bayar
header("Location: " . $res["pay_url"]);Cek status
GET /api/payments/:id — untuk polling dari halaman selesai. Status: pending, paid, expired, cancelled. Membatalkan: POST /api/payments/:id/cancel.
Webhook
Saat tagihan lunas, gateway POST JSON ke callback_url dengan header X-Signature — HMAC-SHA256 dari body mentah, key-nya per-invoice secret dari response create. Verifikasi sebelum percaya:
// webhook: payment.paid masuk ke callback_url
$body = file_get_contents("php://input");
$sig = $_SERVER["HTTP_X_SIGNATURE"] ?? ""; // "sha256=<hmac>"
$expected = "sha256=" . hash_hmac("sha256", $body, $INVOICE_SECRET);
if (!hash_equals($expected, $sig)) http_response_code(401);
$event = json_decode($body, true);
if ($event["event"] === "payment.paid") {
// tandai pesanan lunas di database toko
}Gagal deliver di-retry otomatis 6x dengan backoff. Fallback kalau webhook telat: polling endpoint status.
Sensor notifikasi
Selain webhook, gateway menerima notifikasi dana masuk dari sensor HP Android — app Notif Bridge (pengganti MacroDroid). App-nya baca notifikasi pembayaran (DANA, Livin' Merchant, atau app lain yang kamu pilih) lalu POST ke endpoint internal:
curl -X POST https://www.alldaypay.my.id/internal/notification \
-H "x-notif-secret: SENSOR_SECRET" \
-H "Content-Type: application/json" \
-d '{"text": "Kamu telah menerima pembayaran Rp 25.000 dari SEABANK", "source": "phone", "hash": "id-unik-notif"}'Gateway nyocokin nominal notifikasi dengan tagihan pending yang ada — begitu cocok, tagihan langsung paid dan webhook dikirim. Field hash opsional (dedup; tanpa itu server pakai sha1 dari teks). Notif yang identik di-dedup otomatis.
Cara setup app Notif Bridge (per HP)
| Langkah | Detail |
|---|---|
| 1. Install APK | APK Notif Bridge (release, bukan debug — biar gak keblokir Play Protect). Kalau Play Protect nge-Warning: More details → Install anyway. |
| 2. Notification access | Buka app → Setup wajib → Notification access → Buka → centang Notif Bridge. Tanpa ini app gak bisa baca notif. |
| 3. Battery optimization | Setup wajib → Battery optimization → Izinkan. Tanpa ini OEM (Realme/Xiaomi/dll) bisa matiin app di background. |
| 4. Isi Gateway URL | https://alldayprem.my.id (atau http://192.168.1.17:3000 kalau masih dev lokal) |
| 5. Isi NOTIF_SECRET | Secret sensor dari tabel di bawah (lihat jenis secret). Simpan, lalu tekan Tes koneksi sampai OK — gateway reachable. |
| 6. Pilih app sumber notif | Kartu App yang disimak → Pilih — centang DANA / Livin' Merchant (MacroDroid style). Default: DANA + Livin' + Livin' Merchant. |
| 7. Tes ujung-ke-ujung | Tombol Tes notif kirim contoh notif (ditandai "TES BRIDGE", gak akan nyocok invoice asli). Atau buat invoice sungguhan → transfer → lihat log app: Terkirim & MATCH — invoice PAID. |
Autostart ON juga disarankan (Settings HP → izin autostart untuk Notif Bridge). Heartbeat jalan tiap N menit (default 3) — kalau hilang >40 menit, watchdog Telegram nge-alert.
Jenis secret sensor (header x-notif-secret)
| Secret | Cocok tagihan milik | Buat siapa |
|---|---|---|
| Sensor secret pribadi (sns_..., generate di Integrasi & API) | Akun itu saja | Per anggota — 1 HP per akun, semua member bisa generate sendiri |
| Secret global (NOTIF_SECRET .env) | Semua akun | Khusus admin / 1 HP bersama — jangan dibagi ke member |
| sensor_<api_key> | Akun itu saja (fallback lama) | Kompatibilitas HP lama |
Heartbeat pakai secret yang sama: app POST /internal/heartbeat {"source":"phone"} tiap N menit. Endpoint notification, heartbeat, dan ping semuanya menerima ketiga jenis secret di atas.
Secret salah = 401 bad secret. Ganti secret (tombol Generate di Integrasi & API) tanpa menganggu API key store/bot — tapi HP akun itu wajib di-update, secret lama langsung ditolak. Notif pembayaran yang gagal kirim (offline) disimpan di queue app dan dikirim ulang otomatis pas online — gak ada dana masuk yang hilang.
Kode error
| HTTP | code | Arti |
|---|---|---|
| 400 | invalid_amount | Nominal di luar 1.000–10.000.000 |
| 401 | invalid_api_key | API key salah / hilang |
| 404 | not_found | ID tagihan tidak ada |
| 409 | not_pending | Tagihan sudah bukan pending |
| 503 | no_free_code | Kode unik habis — terlalu banyak tagihan pending |