QRIS
Terakhir diperbarui 4 April 2025
Di halaman ini
POST
/v2/order?q=qrishttps://sandbox-api.qoinhub.idversi 1.0
Request Header
| Field | Deskripsi | Tipe | Wajib |
|---|---|---|---|
Signaturein: header | Menggunakan SHA 256 with RSA (Payload, Private Key) | string | M |
Idempotency-Keyin: header | — | stringcontoh: -idem-key-bcaa | M |
Request Body
| Field | Tipe | Deskripsi |
|---|---|---|
transactionM | object | — |
↳ MerchantNumberM | string | Kode Merchant |
↳ amountM | integer · int32default: 50000 | Nominal Transaksi |
↳ ReferenceNumberM | string | Nomor Referensi |
itemsM | object | — |
↳ idM | stringdefault: "1" | Nomor ID barang / jasa. |
↳ priceM | integer · int32default: 50000 | Harga barang / jasa. |
↳ quantityM | integer · int32default: 1 | Jumlah banyaknya barang |
↳ nameM | stringdefault: "Coklat" | Nama barang |
↳ brandM | stringdefault: "Silver Queen" | Nama merk barang |
↳ categoryM | stringdefault: "Product" | Jenis Kategori barang |
↳ merchantnameM | stringdefault: "qoinapps" | Nama Merchant |
customerM | object | — |
↳ first_nameM | stringdefault: "Budi" | Nama pertama pelanggan |
↳ last_nameM | stringdefault: "Santoso" | Nama Terakhir pelanggan |
↳ emailM | stringdefault: "budisantoso@email.com" | Alamat email pelanggan |
↳ phoneM | stringdefault: "081213141516" | Nomor telepon pelanggan |
↳ billing_address | object | Object yang berisi Informasi tentang data alamat penagihan |
↳ first_nameM | stringdefault: "Julia" | Nama pertama pemilik alamat penagihan |
↳ last_nameM | stringdefault: "Wati" | Nama terakhir pemilik alamat penagihan |
↳ emailM | stringdefault: "juliawati@email.com" | Alamat email pemilik alamat penagihan |
↳ phoneM | stringdefault: "08565758595051" | Nomor telepon pemilik alamat penagihan |
↳ addressM | stringdefault: "Jl. Sudirman Raya Kav 41" | Alamat penagihan |
↳ cityM | stringdefault: "Jakarta" | Domisili kota penagihan |
↳ postal_codeM | stringdefault: "12190" | Kode Pos pemilik alamat penagihan |
↳ country_codeM | stringdefault: "ID" | Kode Pos pemilik alamat pelanggan |
↳ shipping_address | object | — |
↳ first_nameM | stringdefault: "Budi" | Nama pertama pemilik alamat pelanggan |
↳ last_nameM | stringdefault: "Santoso" | Nama terakhir pemilik alamat pelanggan |
↳ emailM | stringdefault: "budisantoso@email.com" | Alamat email pemilik alamat pelanggan |
↳ phoneM | stringdefault: "081213141516" | Nomor telepon pemilik alamat pelanggan |
↳ addressM | stringdefault: "Jl. Sudirman Raya Kav 41" | Alamat pelanggan |
↳ cityM | stringdefault: "Jakarta" | Kota pengiriman |
↳ postal_codeM | stringdefault: "12190" | Kode Pos pemilik alamat pelanggan |
↳ country_codeM | stringdefault: "ID" | Kode Pos pemilik alamat pelanggan |
enabledh2hpaymentsM | stringdefault: "8" | — |
callbacksM | object | — |
↳ finish | stringdefault: "https://finish.example.com" | — |
expiryM | object | — |
↳ start_timeM | string · date-timedefault: "2024-08-23T07:44:11+07:00" | Tanggal mulai kadaluarsa. (ISO-8601 Format) |
↳ unitM | string | Satuan waktu kadaluarsa |
↳ duration | integer · int32default: 1 | Jumlah waktu kadaluarsa |
datetime | string · date-timedefault: "2024-08-23T07:44:11+07:00" | Tanggal dan waktu transaksi. (ISO-8601 Format) |
custom_field1M | object | — |
↳ mqt_terminal_idM | stringdefault: "KSR02" | Terminal ID |
↳ IsMPANM | booleandefault: false | Merchant Primary Account Number |
↳ TipCodeM | stringdefault: "02" | Kode tip |
↳ TipAmountM | stringdefault: "2000" | Jumlah nominal tip |
↳ TipPercentM | string | Persentase tip |
custom_field2M | string | — |
custom_field3M | string | — |
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"
}