0% found this document useful (0 votes)
35 views7 pages

Kontol Bapakmu Mbeledos Cok

The document outlines the Qris API request and response formats, including examples for successful transactions, validation errors, and various error responses related to account status and transaction issues. It also details callback responses for both successful and failed transactions, highlighting the necessary parameters and their expected values. Overall, it serves as a comprehensive guide for implementing the Qris API for payment processing.
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as DOCX, PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
35 views7 pages

Kontol Bapakmu Mbeledos Cok

The document outlines the Qris API request and response formats, including examples for successful transactions, validation errors, and various error responses related to account status and transaction issues. It also details callback responses for both successful and failed transactions, highlighting the necessary parameters and their expected values. Overall, it serves as a comprehensive guide for implementing the Qris API for payment processing.
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as DOCX, PDF, TXT or read online on Scribd
You are on page 1/ 7

Request Qris API

Example Request JSON:

{
"store_identifier": "Ex4a1vL90VYrEa1ihUT91C2GXTndGV",
"secret_key ":
"kuRbMvlUisp5JOLise1oN05ojVAiaAWoxDUf9GgtlrTgnDPvsRirBRFZoZxRo23ZwENEbINQwPajCD7oqb
C4hfQ2NWiApiZiqJpoG6sdXzkDDIx4KbtFenHqMlVGmbhQPu9GmzrmmEe9PWYfQ8nfQb",
"amount": "1000",
"partnerTransactionNo": "20240712091011",
"partnerReferenceNo": "2329232212122",
}

Example Success Reponse :

{
"message": "Transaction Success",
"store_identifier": "Ex4a1vL90VYrEa1ihUT91C2GXTndGV",
"invoice_number": "VP20072024000000000005489",
"partnerTransactionNo": "20240712091011",
"partnerReferenceNo": "2329232212122",
"transactionDate": "2024-07-20T02:35:43.651550Z",
"jenisPembayaran": "Qris",
"qris_data":
"00020101021226670016COM.NOBUBANK.WWW01189360050300000898740214950488392022540303UB
E51440014ID.CO.QRIS.WWW0215ID20232944469430303UBE520454995303360540410005802ID5908V
ISIONER6008SURABAYA61056125662610114072009857655700625VP200720240000000000054890702
VP0804POSP630470D0",
"amount": "1000",
"nominal_mdr": 7,
"mdrPaymentAmount": 993,
"status": 20011
}

Example Validation Error Response :

{
"message": "Invalid Value",
"errors": {
"amount": [
"The amount field must be a number."
]
},
"status": 20012
}
Example NULL Value Response :

{
"message": "Partner Transaction Number Is NULL",
"status": 20015
}

Example Store Identifier Not Found Response :

{
"message": "Wrong Store Identifier, Merchant cannot be found",
"status": 20018
}

Example Wrong Secret Key Response :

{
"message": "This transaction number has been requested before",
"status": 20023
}

Example Account Has Not Been Verified Response :

{
"message": "Your account whatsapp number has not been verified yet, please
verify your number first",
"status": 20020
}

Example Account Has Not Been Activated by Admin Response :

{
"message": "Your acount has not been activated, please contact our admin",
"status": 20019
}

Example Account Has Been Deactivated by Admin Response :

{
"message": "Your account has been deactivated by the admin, please contact
damin for further information",
"status": 20021
}

Example Your Merchant Has Been Deactivated by Admin Response :

{
"message": "Your merchant is deactivated by admin, please contact the admin for
further information",
"status": 20022
}
Example Your Duplicate Transaction Number Response :

{
"message": "This transaction number has been requested before",
"status": 20023
}

Qris Inquiry API

Qris Callback API

Example Response JSON Callback to Partner API From Visioner :

{
"login": "username",
"password": "password",
"api_key": "api_key",
"partnerTransactionNo": "20240712091011",
"partnerReferenceNo": "2329232212122",
"amount": "1000",
"mdrPaymentAmount": "933",
"paymentStatus": "PAID",
"invoice_number": "VP20072024000000000005489",
"paymentTimeStamp": "2024-07-20T02:35:43.651550Z",
"responseStatus": "SUCCESS",
"status": 20011
}

Example Response Callback API From Partner to Visioner :

Success Callback

{
"responseStatus": "SUCCESS",
"responseCode": "40011",
"responseDescription": "Transaction Calback successful",
"partnerTransactionNo": "20240712091011",
"partnerReferenceNo": "2329232212122",
"partnerCallbackReference": "202407120910011",
"invoice_number": " VP20072024000000000005489",
"partnerTransactionStatus": "VALID",
"partnerPaymentStatus": "PAID",
"partnerPaymentTimeStamp": "2024-07-20T02:35:43.651550Z",
}

Invalid Value Callback


{
"responseStatus": "FAILED",
"responseCode": "40012",
"responseDescription": "Request Value is not valid",
"partnerTransactionNo": "20240712091011",
"partnerReferenceNo": "2329232212122",
"partnerCallbackReference": "202407120910011",
"invoice_number": " VP20072024000000000005489",
"partnerTransactionStatus": "INVALID",
"partnerPaymentStatus": "FAILED",
"partnerPaymentTimeStamp": NULL
}

Null Login Parameter

{
"responseStatus": "FAILED",
"responseCode": "40013",
"responseDescription": "Login Parameter is NULL",
"partnerTransactionNo": "20240712091011",
"partnerReferenceNo": "2329232212122",
"partnerCallbackReference": "202407120910011",
"invoice_number": " VP20072024000000000005489",
"partnerTransactionStatus": "INVALID",
"partnerPaymentStatus": "FAILED",
"partnerPaymentTimeStamp": NULL
}

Null Password Parameter

{
"responseStatus": "FAILED",
"responseCode": "40014",
"responseDescription": "Password Parameter is NULL",
"partnerTransactionNo": "20240712091011",
"partnerReferenceNo": "2329232212122",
"partnerCallbackReference": "202407120910011",
"invoice_number": " VP20072024000000000005489",
"partnerTransactionStatus": "INVALID",
"partnerPaymentStatus": "FAILED",
"partnerPaymentTimeStamp": NULL
}

Null Secret Key Parameter

{
"responseStatus": "FAILED",
"responseCode": "40015",
"responseDescription": "Secret Key Parameter is NULL",
"partnerTransactionNo": "20240712091011",
"partnerReferenceNo": "2329232212122",
"partnerCallbackReference": "202407120910011",
"invoice_number": " VP20072024000000000005489",
"partnerTransactionStatus": "INVALID",
"partnerPaymentStatus": "FAILED",
"partnerPaymentTimeStamp": NULL
}

Null Partner TransactionNo Parameter

{
"responseStatus": "FAILED",
"responseCode": "40016",
"responseDescription": "Partner Transaction Number Parameter is NULL",
"partnerTransactionNo": "20240712091011",
"partnerReferenceNo": "2329232212122",
"partnerCallbackReference": "202407120910011",
"invoice_number": " VP20072024000000000005489",
"partnerTransactionStatus": "INVALID",
"partnerPaymentStatus": "FAILED",
"partnerPaymentTimeStamp": NULL
}

Null Amount Parameter

{
"responseStatus": "FAILED",
"responseCode": "40017",
"responseDescription": "Amount Parameter is NULL",
"partnerTransactionNo": "20240712091011",
"partnerReferenceNo": "2329232212122",
"partnerCallbackReference": "202407120910011",
"invoice_number": " VP20072024000000000005489",
"partnerTransactionStatus": "INVALID",
"partnerPaymentStatus": "FAILED",
"partnerPaymentTimeStamp": NULL
}

Null Mdr Payment Amount

{
"responseStatus": "FAILED",
"responseCode": "40018",
"responseDescription": "MDR Amount Parameter is NULL",
"partnerTransactionNo": "20240712091011",
"partnerReferenceNo": "2329232212122",
"partnerCallbackReference": "202407120910011",
"invoice_number": " VP20072024000000000005489",
"partnerTransactionStatus": "INVALID",
"partnerPaymentStatus": "FAILED",
"partnerPaymentTimeStamp": NULL
}
Null Invoice Number

{
"responseStatus": "FAILED",
"responseCode": "40019",
"responseDescription": "Invoice Number Parameter is NULL",
"partnerTransactionNo": "20240712091011",
"partnerReferenceNo": "2329232212122",
"partnerCallbackReference": "202407120910011",
"invoice_number": " VP20072024000000000005489",
"partnerTransactionStatus": "INVALID",
"partnerPaymentStatus": "FAILED",
"partnerPaymentTimeStamp": NULL
}

Null Payment Time Stamp

{
"responseStatus": "FAILED",
"responseCode": "40020",
"responseDescription": "Payment Timestamp Parameter is NULL",
"partnerTransactionNo": "20240712091011",
"partnerReferenceNo": "2329232212122",
"partnerCallbackReference": "202407120910011",
"invoice_number": " VP20072024000000000005489",
"partnerTransactionStatus": "INVALID",
"partnerPaymentStatus": "FAILED",
"partnerPaymentTimeStamp": NULL
}

Null Payment Status

{
"responseStatus": "FAILED",
"responseCode": "40021",
"responseDescription": "Payment Status Parameter is NULL",
"partnerTransactionNo": "20240712091011",
"partnerReferenceNo": "2329232212122",
"partnerCallbackReference": "202407120910011",
"invoice_number": " VP20072024000000000005489",
"partnerTransactionStatus": "INVALID",
"partnerPaymentStatus": "FAILED",
"partnerPaymentTimeStamp": NULL
}

Transaction Data Not Found


{
"responseStatus": "FAILED",
"responseCode": "40022",
"responseDescription": "Transaction data can't be found",
"partnerTransactionNo": "20240712091011",
"partnerReferenceNo": "2329232212122",
"partnerCallbackReference": "202407120910011",
"invoice_number": " VP20072024000000000005489",
"partnerTransactionStatus": "INVALID",
"partnerPaymentStatus": "FAILED",
"partnerPaymentTimeStamp": NULL
}

Invalid login credentials

{
"responseStatus": "FAILED",
"responseCode": "40023",
"responseDescription": "Login Credentials is not valid",
"partnerTransactionNo": "20240712091011",
"partnerReferenceNo": "2329232212122",
"partnerCallbackReference": "202407120910011",
"invoice_number": " VP20072024000000000005489",
"partnerTransactionStatus": "INVALID",
"partnerPaymentStatus": "FAILED",
"partnerPaymentTimeStamp": NULL
}

Transaction Data Not Found

{
"responseStatus": "FAILED",
"responseCode": "40024",
"responseDescription": " Transaction data can't be found",
"partnerTransactionNo": "20240712091011",
"partnerReferenceNo": "2329232212122",
"partnerCallbackReference": "202407120910011",
"invoice_number": " VP20072024000000000005489",
"partnerTransactionStatus": "INVALID",
"partnerPaymentStatus": "FAILED",
"partnerPaymentTimeStamp": NULL
}

You might also like