Create Order
Terakhir diperbarui 4 April 2025
Di halaman ini
POST
/v2/orderhttps://sandbox-api.qoinhub.idversi 1.0
Request Header
| Field | Deskripsi | Tipe | Wajib |
|---|---|---|---|
Signaturein: header | Menggunakan SHA 256 with RSA (Payload, Private Key) | stringcontoh: abcdef123456 | M |
Idempotency-Keyin: header | — | stringcontoh: 12345 | M |
Request Body
| Field | Tipe | Deskripsi |
|---|---|---|
transactionM | object | Informasi transaksi |
↳ MerchantNumberM | stringdefault: "202000215" | — |
↳ amountM | number · doubledefault: 50000 | — |
↳ ReferenceNumberM | stringdefault: "QOIN2TEST57065" | — |
itemsM | array<object> | Informasi barang yang dibayarkan |
↳ idM | stringdefault: "1" | — |
↳ priceM | number · doubledefault: 16000 | — |
↳ quantityM | number · doubledefault: 1 | — |
↳ nameM | stringdefault: "Coklat" | — |
↳ brandM | stringdefault: "Dairy Queen" | — |
↳ categoryM | stringdefault: "Product" | — |
↳ merchantnameM | stringdefault: "Qoin App" | — |
customerM | object | Informasi tentang data pribadi pelanggan |
↳ first_nameM | stringdefault: "Dhuta" | — |
↳ last_nameM | stringdefault: "Pratama" | — |
↳ emailM | stringdefault: "marialusiana11@gmail.com" | — |
↳ phoneM | stringdefault: "0859106588920" | — |
↳ billing_address | object | — |
↳ first_nameM | stringdefault: "Julia" | — |
↳ last_nameM | stringdefault: "Doe" | — |
↳ emailM | stringdefault: "marialusiana11@gmail.com" | — |
↳ phoneM | stringdefault: "0859106588920" | — |
↳ addressM | stringdefault: "Jl. Sudirman Raya Kav 41" | — |
↳ cityM | stringdefault: "Jakarta" | — |
↳ postal_codeM | stringdefault: "12190" | — |
↳ country_codeM | stringdefault: "ID" | — |
↳ shipping_address | object | — |
↳ first_nameM | stringdefault: "Budi" | — |
↳ last_nameM | stringdefault: "email" | — |
↳ emailM | stringdefault: "marialusiana11@gmail.com" | — |
↳ phoneM | stringdefault: "0859106588920" | — |
↳ addressM | stringdefault: "Jl. Raya Antah Berantah" | — |
↳ cityM | stringdefault: "Jakarta" | — |
↳ postal_codeM | stringdefault: "12190" | — |
↳ country_codeM | stringdefault: "ID" | — |
enabled_webview_payment_methods | array<string>default: ["btransfer"] | Untuk membatasi tampilan webview metode pembayaran yang dipilih. (Opsional, Jika tidak diisi akan menampilkan default seluruh payment method) |
enabled_webview_payment_channels | array<string>default: ["agiva"] | Untuk membatasi tampilan webview channel pembayaran yang dipilih. (Opsional, Jjika tidak diisi akan menampilkan default seluruh payment channel) |
callbacksM | object | Informasi callback |
↳ finish | stringdefault: "https://finish.example.com" | — |
expiryM | object | Batas waktu transaksi |
↳ start_timeM | string · date-timedefault: "2024-08-23T07:44:11+07:00" | (ISO-8601 Format) |
↳ unitM | stringdefault: "minutes" | — |
↳ durationM | integer · int32default: 60 | — |
datetimeM | stringdefault: "2024-08-23T07:44:11+07:00" | Waktu Transaksi (ISO-8601 Format) |
custom_field1 | string | — |
custom_field2 | stringdefault: "custom field 2 content" | — |
custom_field3 | stringdefault: "custom field 3 content" | — |
contoh request
{
"value": {
"transaction": {
"MerchantNumber": "{{MERCHANT_NUMBER}}",
"amount": 16000,
"ReferenceNumber": "{{REFERENCE_NUMBER}}"
},
"items": [
{
"id": "1",
"price": 16000,
"quantity": 1,
"name": "Coklat",
"brand": "Dairy Queen",
"category": "Product",
"merchantname": "Qoin App"
}
],
"customer": {
"first_name": "Dhuta",
"last_name": "Pratama",
"email": "marialusiana11@gmail.com",
"phone": "0859106588920",
"billing_address": {
"first_name": "Julia",
"last_name": "Doe",
"email": "marialusiana11@gmail.com",
"phone": "0859106588920",
"address": "Jl. Sudirman Raya Kav 41",
"city": "Jakarta",
"postal_code": "12190",
"country_code": "ID"
},
"shipping_address": {
"first_name": "Budi",
"last_name": "Doe",
"email": "marialusiana11@gmail.com",
"phone": "0859106588920",
"address": "Jl. Raya Antah Berantah",
"city": "Jakarta",
"postal_code": "12190",
"country_code": "ID"
}
},
"enabled_webview_payment_methods": [],
"enabled_webview_payment_channels": [],
"callbacks": {
"finish": ""
},
"expiry": {
"start_time": "2024-04-28 16:30:00",
"unit": "minutes",
"duration": 60
},
"datetime": "{{TIMESTAMP}}",
"custom_field1": null,
"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\": \"202000215-221b08ae-b9ee-4c0b-81f9-8e5c6cc8005a\"\n }\n}"
}400400
contoh response
{
"value": "{}"
}