alldayPay

Integrasi dalam hitungan menit.

Satu endpoint REST: buat tagihan, terima QRIS dinamis dengan kode unik, dan webhook saat lunas. Semua contoh di halaman ini bisa langsung dijalankan.

Mulai cepat ↓ Buat tagihan ↓

Mulai cepat

Dua langkah: ambil API key dari .env server, lalu kirim request ke gateway. Tidak ada SDK khusus yang perlu diinstal.

Base URL:

URL
https://alldaypay.my.id

Request pertama — buat tagihan Rp10.000:

curl
curl -X POST https://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:

FieldWajibKet
amountyaRupiah, 1.000–10.000.000. Kode unik 100–250 otomatis ditambahkan.
descriptiontidakTeks bebas, tampil di halaman bayar.
referencetidakID pesanan di sistem lo.
callback_urltidakURL webhook saat status berubah.
redirect_urltidakPembeli diarahkan ke sini setelah lunas.
expires_intidakMenit, default 15 (5–60).

Response 201 — field penting: pay_url (redirect pembeli ke sini), amount (yang harus dibayar), qris (payload mentah).

Contoh integrasi PHP:

php
$ch = curl_init("https://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:

php
// 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
curl -X POST https://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)

LangkahDetail
1. Install APKAPK Notif Bridge (release, bukan debug — biar gak keblokir Play Protect). Kalau Play Protect nge-Warning: More details → Install anyway.
2. Notification accessBuka app → Setup wajib → Notification access → Buka → centang Notif Bridge. Tanpa ini app gak bisa baca notif.
3. Battery optimizationSetup wajib → Battery optimization → Izinkan. Tanpa ini OEM (Realme/Xiaomi/dll) bisa matiin app di background.
4. Isi Gateway URLhttps://alldayprem.my.id (atau http://192.168.1.17:3000 kalau masih dev lokal)
5. Isi NOTIF_SECRETSecret sensor dari tabel di bawah (lihat jenis secret). Simpan, lalu tekan Tes koneksi sampai OK — gateway reachable.
6. Pilih app sumber notifKartu App yang disimak → Pilih — centang DANA / Livin' Merchant (MacroDroid style). Default: DANA + Livin' + Livin' Merchant.
7. Tes ujung-ke-ujungTombol 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)

SecretCocok tagihan milikBuat siapa
Sensor secret pribadi (sns_..., generate di Integrasi & API)Akun itu sajaPer anggota — 1 HP per akun, semua member bisa generate sendiri
Secret global (NOTIF_SECRET .env)Semua akunKhusus 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

HTTPcodeArti
400invalid_amountNominal di luar 1.000–10.000.000
401invalid_api_keyAPI key salah / hilang
404not_foundID tagihan tidak ada
409not_pendingTagihan sudah bukan pending
503no_free_codeKode unik habis — terlalu banyak tagihan pending