QoinHub

QRIS

Terakhir diperbarui 4 April 2025

Di halaman ini
POST/v2/order?q=qris
https://sandbox-api.qoinhub.idversi 1.0

Request Header

FieldDeskripsiTipeWajib
Signaturein: headerMenggunakan SHA 256 with RSA (Payload, Private Key)stringM
Idempotency-Keyin: header—stringcontoh: -idem-key-bcaaM

Request Body

FieldTipeDeskripsi
transactionMobject—
↳ MerchantNumberMstringKode Merchant
↳ amountMinteger · int32default: 50000Nominal Transaksi
↳ ReferenceNumberMstringNomor Referensi
itemsMobject—
↳ idMstringdefault: "1"Nomor ID barang / jasa.
↳ priceMinteger · int32default: 50000Harga barang / jasa.
↳ quantityMinteger · int32default: 1Jumlah banyaknya barang
↳ nameMstringdefault: "Coklat"Nama barang
↳ brandMstringdefault: "Silver Queen"Nama merk barang
↳ categoryMstringdefault: "Product"Jenis Kategori barang
↳ merchantnameMstringdefault: "qoinapps"Nama Merchant
customerMobject—
↳ first_nameMstringdefault: "Budi"Nama pertama pelanggan
↳ last_nameMstringdefault: "Santoso"Nama Terakhir pelanggan
↳ emailMstringdefault: "budisantoso@email.com"Alamat email pelanggan
↳ phoneMstringdefault: "081213141516"Nomor telepon pelanggan
↳ billing_addressobjectObject yang berisi Informasi tentang data alamat penagihan
↳ first_nameMstringdefault: "Julia"Nama pertama pemilik alamat penagihan
↳ last_nameMstringdefault: "Wati"Nama terakhir pemilik alamat penagihan
↳ emailMstringdefault: "juliawati@email.com"Alamat email pemilik alamat penagihan
↳ phoneMstringdefault: "08565758595051"Nomor telepon pemilik alamat penagihan
↳ addressMstringdefault: "Jl. Sudirman Raya Kav 41"Alamat penagihan
↳ cityMstringdefault: "Jakarta"Domisili kota penagihan
↳ postal_codeMstringdefault: "12190"Kode Pos pemilik alamat penagihan
↳ country_codeMstringdefault: "ID"Kode Pos pemilik alamat pelanggan
↳ shipping_addressobject—
↳ first_nameMstringdefault: "Budi"Nama pertama pemilik alamat pelanggan
↳ last_nameMstringdefault: "Santoso"Nama terakhir pemilik alamat pelanggan
↳ emailMstringdefault: "budisantoso@email.com"Alamat email pemilik alamat pelanggan
↳ phoneMstringdefault: "081213141516"Nomor telepon pemilik alamat pelanggan
↳ addressMstringdefault: "Jl. Sudirman Raya Kav 41"Alamat pelanggan
↳ cityMstringdefault: "Jakarta"Kota pengiriman
↳ postal_codeMstringdefault: "12190"Kode Pos pemilik alamat pelanggan
↳ country_codeMstringdefault: "ID"Kode Pos pemilik alamat pelanggan
enabledh2hpaymentsMstringdefault: "8"—
callbacksMobject—
↳ finishstringdefault: "https://finish.example.com"—
expiryMobject—
↳ start_timeMstring · date-timedefault: "2024-08-23T07:44:11+07:00"Tanggal mulai kadaluarsa. (ISO-8601 Format)
↳ unitMstringSatuan waktu kadaluarsa
↳ durationinteger · int32default: 1Jumlah waktu kadaluarsa
datetimestring · date-timedefault: "2024-08-23T07:44:11+07:00"Tanggal dan waktu transaksi. (ISO-8601 Format)
custom_field1Mobject—
↳ mqt_terminal_idMstringdefault: "KSR02"Terminal ID
↳ IsMPANMbooleandefault: falseMerchant Primary Account Number
↳ TipCodeMstringdefault: "02"Kode tip
↳ TipAmountMstringdefault: "2000"Jumlah nominal tip
↳ TipPercentMstringPersentase tip
custom_field2Mstring—
custom_field3Mstring—
contoh request
{
  "value": {
    "transaction": {
      "MerchantNumber": "202200001",
      "amount": 100000,
      "ReferenceNumber": "RE230103002"
    },
    "items": [
      {
        "id": "PRXT0005",
        "price": 10000,
        "quantity": 1,
        "name": "Extra Serve",
        "brand": "Qoin",
        "category": "Services",
        "merchantname": "Qoin App"
      }
    ],
    "customer": {
      "first_name": "Bbb",
      "last_name": "Ggg",
      "email": "rendifajri@gmail.com",
      "phone": "+6285726100714",
      "billing_address": {
        "first_name": "Aaa",
        "last_name": "Ffff",
        "email": "rendi@loyalto.id",
        "phone": "08565758595051",
        "address": "Jl. Sudirman Raya Kav 41",
        "city": "Jakarta",
        "postal_code": "12190",
        "country_code": "ID"
      },
      "shipping_address": {
        "first_name": "Budi",
        "last_name": "Doe",
        "email": "budi@example.com",
        "phone": "0817181910111213",
        "address": "Jl. Raya Antah Berantah",
        "city": "Jakarta",
        "postal_code": "12190",
        "country_code": "ID"
      }
    },
    "enabledh2hpayments": 8,
    "callbacks": {
      "finish": "https://finish.example.com"
    },
    "expiry": {
      "start_time": "2024-01-24 11:46:55",
      "unit": "minutes",
      "duration": 1
    },
    "datetime": "2023-09-07 11:46:55",
    "custom_field1": {
      "mqt_terminal_id": "KSR02",
      "IsMPAN": "false",
      "TipCode": "02",
      "TipAmount": "2000",
      "TipPercent": ""
    },
    "custom_field2": "custom field 2 content",
    "custom_field3": "custom field 3 content"
  }
}

Response

200200
contoh response
{
  "value": "{\n  \"status_code\": \"000\",\n  \"status\": \"success\",\n  \"message\": \"creating order is in proccess, please use ticket_id to retrieve response\",\n  \"data\": {\n    \"ticket_id\": \"202100520-d6535b76-d0ba-4249-81d4-7d25533e6849\"\n  }\n}\n"
}
400400
contoh response
{
  "value": "{\n  \"status_code\": \"013\",\n  \"status\": \"error\",\n  \"message\": \"please provide idempotency key\"\n}\n"
}