PAYQRIS : PUSAT PPOB & PAYMENT GATEWAY DENGAN API LENGKAP.

Dokumentasi Lengkap API Nokos

Base URL: https://payqris.web.id/api/nokos
Semua request menggunakan POST, format application/x-www-form-urlencoded, dan wajib mengirim api_key serta action. Gunakan API key dari halaman Setting API. Harga pada response adalah harga jual user.

Action	Parameter wajib	Parameter opsional	Hasil
`getcountry`	`api_key, action=getcountry`		Daftar negara yang tersedia.
`getservice`	`api_key, action=getservice` `country_id`		Daftar layanan pada negara.
`getproduct`	`api_key, action=getproduct` `country_id, service_id, page (opsional)`	page	Daftar produk, harga jual, stok, dan meta.
`order`	`api_key, action=order` `country_id, service_id, product_id, country_name, service_name`		Membuat order dan mengurangi saldo user.
`status`	`api_key, action=status` `id`		Mengecek status order dan mengambil OTP jika sudah tersedia.
`cancel`	`api_key, action=cancel` `id`		Membatalkan order setelah 3 menit dan sebelum 20 menit; saldo dikembalikan sesuai aturan.

getcountry — Daftar negara yang tersedia.

Parameter: Tanpa parameter tambahan

Contoh request cURL

curl -X POST "https://payqris.web.id/api/nokos" -d "api_key=API_KEY_ANDA" -d "action=getcountry"

Body request

{
    "api_key": "API_KEY_ANDA",
    "action": "getcountry"
}

Contoh response sukses

{
    "status": true,
    "data": {
        "countries": [
            {
                "id": "1",
                "name": "Indonesia"
            }
        ]
    }
}

getservice — Daftar layanan pada negara.

Parameter: country_id

Contoh request cURL

curl -X POST "https://payqris.web.id/api/nokos" -d "api_key=API_KEY_ANDA" -d "action=getservice" -d "country_id=1"

Body request

{
    "api_key": "API_KEY_ANDA",
    "action": "getservice",
    "country_id": "1"
}

Contoh response sukses

{
    "status": true,
    "data": {
        "services": [
            {
                "id": "25",
                "name": "WhatsApp"
            }
        ]
    }
}

getproduct — Daftar produk, harga jual, stok, dan meta.

Parameter: country_id, service_id, page (opsional)

Contoh request cURL

curl -X POST "https://payqris.web.id/api/nokos" -d "api_key=API_KEY_ANDA" -d "action=getproduct" -d "country_id=1" -d "service_id=25" -d "page=1"

Body request

{
    "api_key": "API_KEY_ANDA",
    "action": "getproduct",
    "country_id": "1",
    "service_id": "25",
    "page": "1"
}

Contoh response sukses

{
    "status": true,
    "data": {
        "products": [
            {
                "id": "987",
                "name": "Indonesia WhatsApp",
                "price": 1100,
                "available": 42
            }
        ],
        "meta": {
            "count": 1,
            "page": 1,
            "limit": 200
        }
    }
}

order — Membuat order dan mengurangi saldo user.

Parameter: country_id, service_id, product_id, country_name, service_name

Contoh request cURL

curl -X POST "https://payqris.web.id/api/nokos" -d "api_key=API_KEY_ANDA" -d "action=order" -d "country_id=1" -d "service_id=25" -d "product_id=987"

Body request

{
    "api_key": "API_KEY_ANDA",
    "action": "order",
    "country_id": "1",
    "service_id": "25",
    "product_id": "987",
    "country_name": "Indonesia",
    "service_name": "WhatsApp"
}

Contoh response sukses

{
    "status": true,
    "data": {
        "id": "1234567890",
        "phone_number": "+628123456789",
        "price": 1100,
        "status": "Pending"
    }
}

status — Mengecek status order dan mengambil OTP jika sudah tersedia.

Parameter: id

Contoh request cURL

curl -X POST "https://payqris.web.id/api/nokos" -d "api_key=API_KEY_ANDA" -d "action=status" -d "id=1234567890"

Body request

{
    "api_key": "API_KEY_ANDA",
    "action": "status",
    "id": "1234567890"
}

Contoh response sukses

{
    "status": true,
    "data": {
        "id": "1234567890",
        "status": "Success",
        "phone_number": "+628123456789",
        "otp_code": "123456"
    }
}

cancel — Membatalkan order setelah 3 menit dan sebelum 20 menit; saldo dikembalikan sesuai aturan.

Parameter: id

Contoh request cURL

curl -X POST "https://payqris.web.id/api/nokos" -d "api_key=API_KEY_ANDA" -d "action=cancel" -d "id=1234567890"

Body request

{
    "api_key": "API_KEY_ANDA",
    "action": "cancel",
    "id": "1234567890"
}

Contoh response sukses

{
    "status": true,
    "data": {
        "id": "1234567890",
        "status": "Canceled",
        "refunded": true
    }
}

Response error umum

{
    "status": false,
    "data": {
        "pesan": "Pesan error sesuai kondisi request."
    }
}

Status order dapat berupa Pending, Success, Canceled, atau Expired. OTP tersedia di data.otp_code setelah status Success. Alias yang tetap didukung: getcoutry, countries, services, products, dan pemesanan.