Dokumentasi API Qios Payment

Register

Mendaftarkan akun user baru. Menolak jika uid, alamat_email, atau no_handphone sudah terdaftar.

Request Body

Contoh Request

curl -X POST https://qiospayment.biz.id/partner/v1/auth/register.php \
  -H "Content-Type: application/json" \
  -d '{
    "uid": "AHTB",
    "nama_pengguna": "Ahmad Taufik",
    "alamat_email": "ahmad@example.com",
    "no_handphone": "081234567890"
  }'

{
    "status": true,
    "message": "Registrasi berhasil",
    "data": {
        "id": 872222,
        "uid": "AHTB",
        "code_merchant": "MAC-29822",
        "code_referral": "REFAHTB4821",
        "status_akun": "belum terverifikasi",
        "jenis_akun": "member"
    }
}

{
    "status": false,
    "code": "AUTH_001",
    "message": "uid, alamat_email, atau no_handphone sudah terdaftar"
}

{
    "status": false,
    "code": "SYS_003",
    "message": "uid wajib diisi, format alamat_email tidak valid"
}

Buat PIN

Membuat PIN baru. Hanya berhasil jika user belum pernah punya PIN sebelumnya.

Request Body

Contoh Request

curl -X POST https://qiospayment.biz.id/partner/v1/auth/create-pin.php \
  -H "Content-Type: application/json" \
  -d '{
    "uid": "AHTB",
    "nama_pengguna": "Ahmad Taufik",
    "alamat_email": "ahmad@example.com",
    "no_handphone": "081234567890",
    "pin": "1234"
  }'

{
    "status": true,
    "message": "PIN berhasil dibuat",
    "data": { "sudah_punya_pin": true }
}

{
    "status": false,
    "code": "AUTH_002",
    "message": "User sudah memiliki PIN, tidak bisa membuat PIN baru"
}

Verifikasi PIN

Memeriksa apakah PIN yang dimasukkan benar. Dipakai sebagai konfirmasi sebelum transaksi.

Request Body

Contoh Request

curl -X POST https://qiospayment.biz.id/partner/v1/auth/verify-pin.php \
  -H "Content-Type: application/json" \
  -d '{
    "uid": "AHTB",
    "nama_pengguna": "Ahmad Taufik",
    "alamat_email": "ahmad@example.com",
    "no_handphone": "081234567890",
    "pin": "1234"
  }'

{
    "status": true,
    "message": "PIN benar",
    "data": { "pin_valid": true }
}

{
    "status": false,
    "code": "AUTH_004",
    "message": "PIN salah"
}

{
    "status": false,
    "code": "AUTH_003",
    "message": "User belum memiliki PIN, silakan buat PIN terlebih dahulu"
}

Cek Saldo

Mengambil saldo akun, saldo QRIS, dan poin saja - lebih ringan dibanding menarik seluruh data profil.

Request Body

Contoh Request

curl -X POST https://qiospayment.biz.id/partner/v1/account/balance.php \
  -H "Content-Type: application/json" \
  -d '{
    "uid": "AHTB",
    "nama_pengguna": "Ahmad Taufik",
    "alamat_email": "ahmad@example.com",
    "no_handphone": "081234567890"
  }'

{
    "status": true,
    "message": "Saldo ditemukan",
    "data": {
        "saldo_akun": "150000.00",
        "saldo_qris": "50000.00",
        "poin_akun": "120"
    }
}

{
    "status": false,
    "code": "SYS_004",
    "message": "Data tidak ditemukan"
}

Info Profil

Menarik seluruh data profil user, termasuk saldo dan poin.

Request Body

Contoh Request

curl -X POST https://qiospayment.biz.id/partner/v1/profile/info.php \
  -H "Content-Type: application/json" \
  -d '{
    "uid": "AHTB",
    "nama_pengguna": "Ahmad Taufik",
    "alamat_email": "ahmad@example.com",
    "no_handphone": "081234567890"
  }'

{
    "status": true,
    "message": "Data ditemukan",
    "data": {
        "id": "872222",
        "uid": "AHTB",
        "nama_pengguna": "Ahmad Taufik",
        "alamat_email": "ahmad@example.com",
        "no_handphone": "081234567890",
        "jenis_kelamin": "L",
        "alamat_lengkap": "Jl. Merdeka No. 10",
        "saldo_akun": "150000.00",
        "saldo_qris": "50000.00",
        "poin_akun": "120",
        "code_referral": "REFAHTB4821",
        "status_akun": "belum terverifikasi",
        "jenis_akun": "member",
        "tanggal_mendaftar": "2026-08-16 05:10:22"
    }
}

{
    "status": false,
    "code": "SYS_004",
    "message": "Data tidak ditemukan"
}

Daftar Kode Error

Setiap response gagal menyertakan field "code" agar partner bisa menangani error berdasarkan kode, bukan menebak dari teks pesan.

Umum / Sistem

Auth