Order Kuota Deposit Create API

Dokumentasi resmi Order Kuota Deposit Create API dari Maelyn API untuk membuat deposit (top up saldo) via QRIS pada akun Order Kuota

Base Information

  • BASE_URL_API: https://api.maelyn.eu/api
  • Path / Endpoint: /payment/orderkuota/deposit-create
  • Method: POST
  • Credit Usage: 5

Authentication

Gunakan header berikut pada setiap request:

x-maelyn-auth: YOUR_API_KEY

Request Body

Endpoint ini digunakan untuk membuat deposit (top up saldo) ke akun Order Kuota. Setelah deposit berhasil dibuat, endpoint ini otomatis mengambil rincian deposit tersebut (termasuk qris_url dan qris_string) sehingga bisa langsung ditampilkan sebagai QR code ke user.

Note: Maelyn API tidak menyimpan data user seperti username, password, OTP, token, atau data akun lainnya. Untuk menggunakan fitur ini, user harus melakukan alur login terlebih dahulu, yaitu Login OTP kemudian dilanjutkan ke Login Token untuk mendapatkan token akun Order Kuota. Gunakan auth_username (ID akun, bagian sebelum tanda : pada token) dan auth_token (token lengkap format id:token) hasil dari proses tersebut.

Proses pengambilan rincian & QRIS bisa memakan waktu beberapa detik karena menunggu gateway pembayaran selesai men-generate QR code-nya.

Example Request

POST /payment/orderkuota/deposit-create

Body Parameters

NameTypeRequiredDefaultDescription
auth_usernamestringYes-ID akun Order Kuota (bagian sebelum tanda : pada token)
auth_tokenstringYes-Token akun Order Kuota dari endpoint Login Token (format id:token)
amountnumberYes-Nominal deposit, contoh 10000
paymentstringNo"sinarmas"Metode pembayaran (sinarmas untuk QRIS)
option_idstringNo""Opsi tambahan metode pembayaran (jika ada)
qris_retriesnumberNo5Jumlah percobaan ulang mengambil qris_url bila belum siap
qris_retry_delay_msnumberNo1500Jeda antar percobaan ulang, dalam milidetik

Example Usage

{
  "auth_username": "your_username",
  "auth_token": "0202020:xxxxxxx",
  "amount": 10000
}

Success Response

{
    "success": true,
    "message": "Berhasil membuat deposit Order Kuota",
    "result": {
        "success": true,
        "status": 200,
        "timestamp": "1783253467555",
        "amount": 10000,
        "payment": "sinarmas",
        "response": {
            "success": true,
            "status": true,
            "results": {
                "id": 85458367,
                "jumlah": 11198,
                "pembayaran": "Via Scan QRIS",
                "rate": 0,
                "status": "pending",
                "tanggal": "05/07/2026 19:11:06"
            }
        },
        "detail": {
            "success": true,
            "deposit_id": "85458367",
            "title": "Rincian Deposit #85458367",
            "tanggal": "05/07/2026 19:11:06",
            "metode_pembayaran": "Via Scan QRIS",
            "status": "Pending",
            "jumlah": "11.198",
            "jumlah_number": 11198,
            "atas_nama": "ORDER KUOTA",
            "biaya_penanganan": "78",
            "qris_url": "https://qris.orderkuota.com/qrnb/20260705/85458367-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.png",
            "qris_string": "00020101021226670016COM.NOBUBANK.WWW...6304XXXX",
            "qris_regenerated": true,
            "qris_trigger_status": 200,
            "qris_trigger_response": "success"
        },
        "qris_retry_attempts": 0,
        "qris_url": "https://qris.orderkuota.com/qrnb/20260705/85458367-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.png",
        "qris_string": "00020101021226670016COM.NOBUBANK.WWW...6304XXXX"
    }
}

Response Field

NameTypeDescription
successbooleanStatus response API
messagestringPesan status dari Maelyn API
result.successbooleanStatus hasil request pembuatan deposit
result.amountnumberNominal deposit yang diminta
result.response.results.idnumberID deposit, dipakai untuk endpoint Deposit Detail / Deposit Cancel
result.response.results.jumlahnumberTotal nominal yang harus dibayar (termasuk biaya penanganan)
result.response.results.statusstringStatus deposit (mis. pending)
result.detailobjectRincian deposit hasil pengambilan otomatis (lihat Deposit Detail)
result.qris_retry_attemptsnumberJumlah percobaan ulang yang dilakukan sampai qris_url tersedia
result.qris_urlstringURL gambar QRIS untuk pembayaran deposit
result.qris_stringstringString QRIS mentah (EMV), bisa dipakai untuk render ulang QR code

Error Response

Missing Auth Username

{
  "success": false,
  "message": "Body auth_username wajib diisi"
}

Missing Auth Token

{
  "success": false,
  "message": "Body auth_token wajib diisi"
}

Invalid Amount

{
  "success": false,
  "message": "Body amount harus lebih dari 0. Contoh: 10000"
}

Create Deposit Failed

{
  "success": false,
  "message": "Gagal membuat deposit Order Kuota",
  "result": {
    "success": false,
    "response": {
      "success": false,
      "message": "Nominal deposit tidak valid"
    }
  }
}

Internal Server Error

{
  "success": false,
  "message": "Internal server error"
}

Playground