Dokumentasi API Integrasi
Gunakan API RedPay untuk memproses pembayaran QRIS, E-Wallet, dan Penarikan Dana secara otomatis ke sistem Anda.
BASE URL: https://redpay.zhero.web.id/bill/api
POST Generate Payment
Endpoint ini digunakan untuk membuat instruksi pembayaran IDR (QRIS atau DANA).
/generate
Request Parameters
| Parameter | Type | Req | Description |
|---|---|---|---|
username | String | Yes | ID Agen yang terdaftar. |
key | String | Yes | API Key rahasia Anda. |
amount | Integer | Yes | Nominal (Tanpa titik/koma). |
player_username | String | Yes | ID pemain di sistem Anda. |
channel | String | No | QRIS (default) atau DANA. |
Response Sukses (QRIS)
{
"success": true,
"data": {
"type": "QRIS",
"currency": "IDR",
"username": "player_01",
"transaction_id": "QR-ABC12345",
"amount": "10000",
"expired_at": "2025-12-25 21:30:00",
"qris_image": "https://redpay.zhero.web.id/qris/QR-ABC12345.png",
"qris_data": "00020101021226670016COM.NOBUBANK.WWW..."
}
}
Response Sukses (DANA)
{
"success": true,
"data": {
"type": "DANA",
"transaction_id": "DN-XYZ98765",
"amount": "50000",
"payment_url": "https://m.dana.id/n/link/..."
}
}
POST Check Status
Cek status transaksi secara manual menggunakan transaction_id kustom (QR-/DN-).
/status
Response Sukses
{
"success": true,
"data": {
"type": "QRIS",
"username": "player_01",
"transaction_id": "QR-ABC12345",
"amount": "10000",
"remark": "Payment successful",
"status": "success"
}
}
POST Withdrawal (Payout)
Mengirimkan dana dari saldo RedPay Anda ke rekening Bank tujuan.
/payout
Specific Parameters
| Parameter | Type | Description |
|---|---|---|
bank_target | String | Contoh: BCA, BNI, BRI, MANDIRI. |
account_number | String | Nomor rekening tujuan. |
account_name | String | Nama pemilik rekening. |
Response Sukses
{
"success": true,
"data": {
"type": "WITHDRAW",
"transaction_id": "WD1766624581",
"amount": "100000",
"bank_target": "BCA",
"account_number": "887099231",
"account_name": "BUDI SUDARSONO",
"status": "success"
}
}
Error Handling
| HTTP Code | Message | Reason |
|---|---|---|
| 400 | Authentication required | Username atau Key kosong dalam request. |
| 400 | Invalid credentials | Username atau API Key tidak ditemukan/tidak aktif. |
| 400 | Missing required fields | Parameter seperti amount atau player_username tidak ada. |
| 400 | IP Network Unauthorized | IP server Anda belum didaftarkan di whitelist GSPay. |
| 400 | Transaction not found | ID Transaksi tidak ditemukan di database. |