Qris Query
Query Payment
Service ini digunakan untuk cek status pembayaran dari QRIS
Service Info
HTTP Method | POST |
---|---|
Service Code | 51 |
Http Method | POST |
Path | .../v1.0/qr/qr-mpm-query |
Authentication | OAuth 2.0 |
Header
Header Name | Tipe Data | Wajib | Deskripsi |
---|---|---|---|
Content-Type | String | Y | application/json |
X-TIMESTAMP | String | Y | Waktu lokal klien saat ini yyyy-MM-ddTHH:mm:ss.SSSTZD format |
X-PARTNER-ID | String | Y | Client’s client_id (diberikan pada saat onboarding ) |
X-CHANNEL-ID | String | Y | ID channel merchant |
X-SIGNATURE | String | Y | Dibuat dengan algoritma asymmetric with token : Signature Generation |
X-EXTERNAL-ID | String | Y | ID external merchant (tidak boleh sama di hari yang sama) |
Body
Nama Field | Tipe Data | Wajib | Deskripsi |
---|---|---|---|
originalReferenceNo | String | C | Kode transaksi yang milik speedcsh di dapat dari callback |
originalPartnerReferenceNo | String | C | Kode transaksi yang di miliki partner saat generate qr |
serviceCode | String | Y | Kode service Create QRIS Payment |
merchantId | String | Y | Kode unik yang dimiliki setiap merchant |
additionalInfo | Object | C | Informasi tambahan. |
qrId | String | C | Kode unik QRIS di dapat dari generate qr |
- JSON
- CURL
- PHP
- NODE JS
- GO
{
"originalReferenceNo": "5188671",
"merchantId": "121xxxx",
"serviceCode": "47"
}
curl --location --request POST '../v1.0/qr/qr-mpm-query' \
--header 'x-client-key: 6c57db4e-9e11-4951-9bcf-d6f177dafbcc' \
--header 'x-timestamp: 2024-01-16T10:54:21+07:00' \
--header 'x-signature: qrQQSSkvCXxYE3MWJpsn+loHuh4+1xlNWEF6oKmqJgbBJHYqnYoBAYgsv/+DXC7dMeGgdu2dkbXBuMQUD/cGZQ==' \
--header 'x-partner-id: 6c57db4e-9e11-4951-9bcf-d6f177dafbcc' \
--header 'channel-id: 23412' \
--header 'x-external-id: 2024-05-15T06:56:02.642Z' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 6430fe8b-79d5-4e58-a337-6eb498e117a5' \
--data-raw '{
"originalReferenceNo": "5188671",
"merchantId": "121xxxx",
"serviceCode": "47"
}'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => '../v1.0/qr/qr-mpm-query',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"originalReferenceNo": "5188671",
"merchantId": "121xxxx",
"serviceCode": "47"
}',
CURLOPT_HTTPHEADER => array(
'x-client-key: 6c57db4e-9e11-4951-9bcf-d6f177dafbcc',
'x-timestamp: 2024-01-16T10:54:21+07:00',
'x-signature: qrQQSSkvCXxYE3MWJpsn+loHuh4+1xlNWEF6oKmqJgbBJHYqnYoBAYgsv/+DXC7dMeGgdu2dkbXBuMQUD/cGZQ==',
'x-partner-id: 6c57db4e-9e11-4951-9bcf-d6f177dafbcc',
'channel-id: 23412',
'x-external-id: 2024-05-15T06:56:18.301Z',
'Content-Type: application/json',
'Authorization: Bearer 6430fe8b-79d5-4e58-a337-6eb498e117a5'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var request = require('request');
var options = {
'method': 'POST',
'url': '../v1.0/qr/qr-mpm-query',
'headers': {
'x-client-key': '6c57db4e-9e11-4951-9bcf-d6f177dafbcc',
'x-timestamp': '2024-01-16T10:54:21+07:00',
'x-signature': 'qrQQSSkvCXxYE3MWJpsn+loHuh4+1xlNWEF6oKmqJgbBJHYqnYoBAYgsv/+DXC7dMeGgdu2dkbXBuMQUD/cGZQ==',
'x-partner-id': '6c57db4e-9e11-4951-9bcf-d6f177dafbcc',
'channel-id': ' 23412',
'x-external-id': '2024-05-15T06:56:45.081Z',
'Content-Type': ' application/json',
'Authorization': 'Bearer 6430fe8b-79d5-4e58-a337-6eb498e117a5'
},
body: '{\n "originalReferenceNo": "5188671",\n "merchantId": "121xxxx",\n "serviceCode": "47"\n}'
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "../v1.0/qr/qr-mpm-query"
method := "POST"
payload := strings.NewReader(`{
"originalReferenceNo": "5188671",
"merchantId": "121xxxx",
"serviceCode": "47"
}`)
client := &http.Client {
}
req, err := http.NewRequest(method, url, payload)
if err != nil {
fmt.Println(err)
return
}
req.Header.Add("x-client-key", "6c57db4e-9e11-4951-9bcf-d6f177dafbcc")
req.Header.Add("x-timestamp", "2024-01-16T10:54:21+07:00")
req.Header.Add("x-signature", "qrQQSSkvCXxYE3MWJpsn+loHuh4+1xlNWEF6oKmqJgbBJHYqnYoBAYgsv/+DXC7dMeGgdu2dkbXBuMQUD/cGZQ==")
req.Header.Add("x-partner-id", "6c57db4e-9e11-4951-9bcf-d6f177dafbcc")
req.Header.Add("channel-id", " 23412")
req.Header.Add("x-external-id", "2024-05-15T06:57:04.004Z")
req.Header.Add("Content-Type", " application/json")
req.Header.Add("Authorization", "Bearer 6430fe8b-79d5-4e58-a337-6eb498e117a5")
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
Response
Parameter | Tipe Data | Deskripsi |
---|---|---|
responseCode | String | Kode response |
responseMessage | String | Pesan response |
originalPartnerReferenceNo | String | ID transaksi pada sistem Merchant. |
serviceCode | String | Kode service Create QRIS Payment |
latestTransactionStatus | String | 00 - Success, 01 - Initiated, 02 - Paying, 03 - Pending, 04 - Refunded, 05 - Canceled, 06 - Failed, 07 - Not found. |
amount | Object | |
value | String | Jumlah total nominal transaksi. |
currency | String | Mata uang. |
feeAmount | Object | |
value | String | Jumlah total tips transaksi. |
currency | String | Mata uang. |
additionalInfo | Object | Informasi tambahan. |
buyyerReff | String | Nama Customer |
brandName | String | Nama brand Issuer |
{
"responseCode": "2005100",
"responseMessage": "Successful",
"originalReferenceNo": "5188671",
"serviceCode": 47,
"latestTransactionStatus": "00",
"transactionStatusDesc": "Success",
"amount": {
"value": "15000.00",
"currency": "IDR"
},
"feeAmount": {
"value": "0",
"currency": "IDR"
},
"additionalInfo": {
"buyyerReff":"Rosidi Dragons",
"brandName":"GOPAY",
}
}
List Response Code
Response Code | Response Message | Description |
---|---|---|
2005100 | Success | |
4005101 | Invalid field format { field name } | |
4015100 | Unauthorized. Invalid Signature | X-Signature salah |
4095100 | Cannot use same X-EXTERNAL-ID in same day | X-External-ID sudah pernah digunakan di hari yang sama |
4045101 | Bad Request | Request header ada yang salah / kurang |
4045100 | Unauthorized. Client Forbidden Access API | Partner tidak dapat mengakses api terkait |
4035119 | Merchant Blacklisted | Merchant telah di blacklist |
4045108 | Invalid Merchant | MerchantId tidak valid |