AldiXDPAY
MasukDaftar

Autentikasi

Kirim API key dari halaman Profil lewat header X-API-Key (disarankan) atau field apikey pada body POST. Jangan taruh key di URL atau kode front-end, panggil API hanya dari server Anda. Batas 60 request per menit per IP.

Buat tagihan QRIS

POST https://aldixdpay.com/api/qris/create

ParameterWajibKeterangan
amountYaNominal Rp 1.000 - Rp 10.000.000
order_idTidakID order unik Anda (3-50 karakter). Dibuat otomatis jika kosong
customer_nameTidakNama pelanggan
project_idTidakID proyek. Default: proyek pertama
curl -X POST https://aldixdpay.com/api/qris/create \
  -H "X-API-Key: pk_xxxxxxxx" \
  -d amount=150000 -d order_id=INV-2041 -d customer_name="Budi"

Respons:

{
  "status": true,
  "result": {
    "trx_id": "TRX261031101500AB12CD",
    "order_id": "INV-2041",
    "amount": 150000,
    "kode_unik": 237,
    "total_bayar": 150237,
    "saldo_masuk": 149182,
    "fee_by": "buyer",
    "expired_at": "2026-10-31 10:45:00",
    "qris_string": "00020101021226...",
    "qr_image": "https://api.qrserver.com/v1/create-qr-code/?...",
    "checkout_url": "https://aldixdpay.com/pay/TRX261031101500AB12CD"
  }
}

Arahkan pembeli ke checkout_url atau tampilkan qr_image sendiri. total_bayar adalah nominal yang harus ditransfer pembeli.

Cek status

GET https://aldixdpay.com/api/qris/status?order_id=INV-2041 dengan header X-API-Key

Status: pending, paid, expired.

Webhook ke server Anda

Saat pembayaran berhasil, kami mengirim POST JSON ke URL webhook proyek. Header X-Signature berisi HMAC-SHA256 dari body mentah dengan secret webhook (lihat halaman Profil) sebagai kunci.

{"event":"payment.success","trx_id":"TRX...","order_id":"INV-2041","status":"paid",
 "amount":150000,"kode_unik":237,"total_paid":150237,"credited":149182,"fee_by":"buyer","paid_at":"2026-10-31T10:20:11+07:00"}
$body = file_get_contents("php://input");
$sig  = hash_hmac("sha256", $body, "SECRET_WEBHOOK_ANDA");
if (!hash_equals($sig, $_SERVER["HTTP_X_SIGNATURE"] ?? "")) { http_response_code(401); exit; }
$data = json_decode($body, true);   // tandai order lunas
echo "OK";