Decode QR MPM
Specification
The Following tabel is spesification for this API :
| API Name | Decode QR MPM |
|---|---|
| Function | This API is used to decode QRIS that user already scanned using merchant App |
| Service Code | 48 |
| Method | POST |
| URL | /snap/v1.0/qr/qr-mpm-decode |
| Accept | application/json |
| Content Type | application/json |
| Related Service | QRIS MPM (Issuer) |
Request
The following part will be describe about parameter of request in this API:
Request Parameter
The following table is a list of request parameter in this API:
Header
The following table is Header of Request Parameters :
| No | Name | Type | Length | Required | Condition | Remarks |
|---|---|---|---|---|---|---|
| 1 | Content-Type | String | Variable, 127 max | Mandatory | - | Content type, value always application/json |
| 2 | Authorization | String | Variable | Mandatory | - | Contains B2B Bearer JWT Token, you've got it from Access Token B2B |
| 3 | Authorization-Customer | String | Variable, 64 max | Mandatory | - | Contains customer token, you've got it from Access Token B2B2C |
| 4 | X-TIMESTAMP | String | Fixed, 25 max | Mandatory | - | Transaction date time, in format YYYY-MM-DDTHH:mm:ss+07:00. Time must be in GMT+7 (Jakarta time) |
| 5 | X-PARTNER-ID | String | Variable, 36 max | Mandatory | - | ID for partner was generated by Paydia. Unique ID for a partner |
| 6 | X-EXTERNAL-ID | String | Variable, 36 max | Mandatory | - | Unique messaging reference ID generated by merchant. Numeric String. Reference number that should be unique in the same day |
| 7 | CHANNEL-ID | String | Variable, 5 max | Mandatory | - | Device identification on which the API services is currently being accessed by the end user (customer) |
| 8 | X-SIGNATURE | String | Variable | Mandatory | - | Signature need to be generated with Symmetric Signature method |
Body
The following table is a body of request parameter:
| No | Name | Type | Length | Required | Condition | Remarks |
|---|---|---|---|---|---|---|
| 1 | qrContent | String | Variable, 512 max | Mandatory | - | QR String MPM |
| 2 | scanTime | String | Fixed, 25 max | Mandatory | - | The time when the QRIS scanned by the user, in format YYYY-MM-DDTHH:mm:ss+07:00. Time must be in GMT+7 (Jakarta time) |
Request Sample
The following script is a request sample of this API:
POST /snap/v1.0/qr/qr-mpm-decode
Authorization-Customer: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJQYXlkaWEiLCJpYXQiOjE3MjQ5MDA0MDEsImV4cCI6MTc0MDY2ODQwMSwianRpIjoiYjYwNDdiNTBkOTRmZWQ4YzA3ZjQzZTBjOGY0NGQ1NGMwMzUzZjE0NGM2NzI4YzhlOWYyMWNhYTBkNjFjMjBmNyIsImNsaWVudF9pZCI6ImRVVT0iLCJtZXJjaGFudF9taWQiOiJja1FFUzFVREJBSUJBZ0p3UUFSSiIsInNjb3BlIjoiUFVCTElDX0lEIiwic3RhdGUiOiI0YzVjOTZiNS04ZDJmLTQ2NzEtYTQ2Yy1kNzQ3ZDU3OTkxMjgifQ.Hmj5skRUj2TtA4fCCtREXwT9PkkdI2I83W-rDZx72n0
X-TIMESTAMP: 2024-09-06T10:10:42+07:00
X-PARTNER-ID: 35d1a1127182a65e4fe0256242a40a6d
X-SIGNATURE: wacETrEoT3rkNYfQHkL2XHwEnBHhioY3QgZWqy2TZThIS96AWGhSxQ6Z85gAGpFF3XUIAzDdrDU+ntUArAyPgw==
X-EXTERNAL-ID: 1725592261
CHANNEL-ID: 379
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJQYXlkaWEiLCJpYXQiOjE3MjQxMjI2NzgsImV4cCI6MTcyNDIwOTA3OCwiZGF0YSI6eyJlbnYiOiJwcm9kdWN0aW9uIn19.qejS3HEFtioUn0fZ5txN2Vr1o_fHF_GWYd1H5a3ePAk
{
"qrContent": "00020101021226650013ID.PAYDIA.WWW011893600818024021200102152402120010000000303UME51440014ID.CO.QRIS.WWW02150000000000000000303UME5204731153033605405100005802ID5913 FIRMAN ZAIN6008PONOROGO61056349162480125b502330a73a049d1a574c86720708Device 10803api63046D0E",
"scanTime": "2024-09-06T10:10:42+07:00"
}
Response
The following part will be describe about parameter of response in this API:
Response Parameter
The following table is a list of response parameter in this API:
Body
The following table is a body of response parameter:
| No | Name | Type | Length | Required | Condition | Remarks |
|---|---|---|---|---|---|---|
| 1 | responseCode | String | Fixed, 7 max | Mandatory | - | Refer to response code list |
| 2 | responseMessage | String | Variable, 150 max | Mandatory | - | Refer to response code list |
| 3 | merchantName | String | Variable, 25 max | Mandatory | - | Merchant name |
| 4 | merchantCategory | String | Variable, 32 max | Mandatory | - | Merchant category |
| 5 | merchantLocation | String | Variable, 25 max | Mandatory | - | Merchant location |
| 6 | transactionAmount | Money | Variable | Mandatory | - | Amount. Contains two sub-fields:
|
Response Sample
The following script is a response sample of this API:
{
"responseCode": "2004800",
"responseMessage": "Successful",
"merchantName": " FIRMAN ZAIN",
"merchantCategory": "Advertising & Marketing",
"merchantLocation": "PONOROGO",
"transactionAmount": {
"value": "10000.00",
"currency": "IDR"
}
}
Response Code and Message
The following table is the list response code and message of Direct Debit Payment API:
| No | Response Code | Response Message | Remarks |
|---|---|---|---|
| 1 | 2004800 | Request has been processed successfully | Success |
| 2 | 4004801 | Invalid Field Format | Invalid format for certain field |
| 3 | 4004802 | Invalid Mandatory Field | Missing or invalid format on mandatory field |
| 4 | 4014800 | Unauthorized. [reason] | General unauthorized error |
| 5 | 4014801 | Invalid Token (B2B) | Invalid or Expired Access Token |
| 6 | 4034802 | Do Not Honor | Account or User status is abnormal |
| 7 | 5004801 | Internal Server Error | 500 internal server error |