Request Dynamic Qris API

Method : POST
Request Type : application/json, application/x-www-form-
urlencoded, multipart/form-data
URL : https://visipos.id/api/request-qris

Request Parameter From Partner

No. Parameter Desc. Length

Partner unique merchant id given

1 store_identifier automatically when partner STR-30
registering a new merchant

API Key generated on Mitra

2 secret_key STR-150
Bisnis's Dashboard

Amount be paid by customer (Min

3 amount transaction 1 Max transaction NUM-10
10000000)
4 partnerTransactionNo Partner unique transaction number STR-25

Partner’s unique reference number,

5 partnerReferenceNo it’s Optional or can be used for STR-25
Phone Number or can be empty

Sample Request Data

No. Parameter Value

1 store_identifier Ex4a1vL90VYrEa1ihUT91C2GXTndGJ
kuRbMvlUisp5JOLise1oN05ojVAiaAWoxDUf9GgtlrT
gnDPvsRirBRFZoZxRo23ZwENEbINQwPajCD7oqbC4hf
2 secret_key
Q2NWiApiZiqJpoG6sdXzkDDIx4KbtFenHqMlVGmbhQP
u9GmzrmmEe9PWYfQ8nTYI
3 amount 500

4 partnerTransactionNo 20190819184056000

5 partnerReferenceNo 086477876798
Example Request JSON:

{
"store_identifier": "Ex4a1vL90VYrEa1ihUT91C2GXTnVFR",
"secret_key ":
"kuRbMvlUisp5JOLise1oN05ojVAiaAWoxDUf9GgtlrTgnDPvsRirBRFZoZxRo23ZwENEbINQwPajCD7oqb
C4hfQ2NWiApiZiqJpoG6sdXzkDDIx4KbtFenHqMlVGmbhQPu9GmzrmmEe9PWIJH8nfQb",
"amount": "1000",
"partnerTransactionNo": "20240712091011",
"partnerReferenceNo": "2329232212122",
}

Example Success Reponse :

{
"message": "Transaction Success",
"transactionData": {
"store_identifier": "Ex4a1vL90VYrEa1ihUT91C2GXTndGV",
"invoice_number": "VP21072024000000000005495",
"partnerTransactionNo": "2024071209101122255566566733",
"partnerReferenceNo": "2329232212122331265455456766",
"transactionDate": "2024-07-21",
"jenisPembayaran": "Qris",
"qris_data":
"00020101021226670016COM.NOBUBANK.WWW01189360050300000898740214950488392022540303UB
E51440014ID.CO.QRIS.WWW0215ID20232944469430303UBE520454995303360540115802ID5908VISI
ONER6008SURABAYA61056125662610114072109934448050625VP210720240000000000054950702VP0
804POSP6304D877",
"amount": "1",
"nominal_mdr": "0.007",
"mdrPaymentAmount": "0.993"
},
"status": 20011
}
Qris Inquiry API
Method : POST
Request Type : application/json, application/x-www-form-
urlencoded, multipart/form-data
URL : https://visipos.id/api/inquiry-payment

Request Parameter From Partner

No. Parameter Desc. Length

Partner unique merchant id given

1 store_identifier automatically when partner STR-30
registering a new merchant

API Key generated on Mitra

2 secret_key STR-150
Bisnis's Dashboard

3 partnerTransactionNo Partner unique transaction number STR-25

Unique transaction number

4 invoice_number automatically generated by STR-25
Visioner

Sample Request Data

No. Parameter Value

1 store_identifier Ex4a1vL90VYrEa1ihUT91C2GXTndGJ
kuRbMvlUisp5JOLise1oN05ojVAiaAWoxDUf9GgtlrT
gnDPvsRirBRFZoZxRo23ZwENEbINQwPajCD7oqbC4hf
2 secret_key
Q2NWiApiZiqJpoG6sdXzkDDIx4KbtFenHqMlVGmbhQP
u9GmzrmmEe9PWYfQ8nTYI
4 partnerTransactionNo 20190819184056000

5 invoice_number VP22072024000000000011335

Example Request JSON:

{
"store_identifier": "Ex4a1vL90VYrEa1ihUT91C2GXTnVFR",
"secret_key ":
"kuRbMvlUisp5JOLise1oN05ojVAiaAWoxDUf9GgtlrTgnDPvsRirBRFZoZxRo23ZwENEbINQwPajCD7oqb
C4hfQ2NWiApiZiqJpoG6sdXzkDDIx4KbtFenHqMlVGmbhQPu9GmzrmmEe9PWIJH8nfQb",
"partnerTransactionNo": "20190819184056000",
" invoice_number": " VP22072024000000000011335",
}
Example Success Reponse :

{
"message": "Transaction Found",
"transactionData": {
"store_identifier": "Ex4a1vL90VYrEa1ihUT91C2GXTndGV",
"invoice_number": "VP22072024000000000011335",
"partnerTransactionNo": "321321321332",
"partnerReferenceNo": "312323122323",
"transactionDate": "2024-07-22",
"jenisPembayaran": "Qris",
"qris_data":
"00020101021226670016COM.NOBUBANK.WWW01189360050300000898740214950488392022540303UB
E51440014ID.CO.QRIS.WWW0215ID20232944469430303UBE520454995303360540115802ID5908VISI
ONER6008SURABAYA61056125662610114072209935545940625VP220720240000000000113350702VP0
804POSP63049FD6",
"amount": "1",
"nominal_mdr": "0.007",
"mdrPaymentAmount": "0.993"
},
"paymentStatus": "PAID",
"paymentDate": "2024-07-21T17:26:53.000000Z",
"status": 30011
}

QRIS Request Callback From Visioner to Partner API

Method : POST
Request Type : application/json
URL : Provided by partner
Request Parameter From Visioner

No. Parameter Desc. Length

Partner login user createted by

1 login STR-20
partner and given to Visioner

Partner login password created by

2 password STR-20
partner and given to Visioner

Partner api_key created by partner

3 api_key STR-30
and given to Visioner
4 partnerTransactionNo Partner unique transaction number STR-25
Partner’s unique reference number,
5 partnerReferenceNo it’s Optional or can be used for STR-25
Phone Number or can be empty
6 amount Amount paid by customer NUM-10
7 mdrPaymentAmount Amount that calculated with MDR NUM-10
 8 paymentStatus Payment status "PAID" or "UNPAID" STR-10
Unique transaction number
9 invoice_number automatically generated by STR-25
Visioner
Payment timestamp if successfully
10 paymentTimeStamp STR-25
paid
11 responseStatus Payment response status "SUCCESS" STR-10
12 status Transaction success status code NUM-10

Sample Request Data From Visioner

No. Parameter Value

1 login username
2 password password
3 api_key api_key
4 partnerTransactionNo 20240712091011
5 partnerReferenceNo 2329232212122
6 amount 100
7 mdrPaymentAmount 933
8 paymentStatus PAID
9 invoice_number VP20072024000000000005489
10 paymentTimeStamp 2024-07-20T02:35:43.651550Z
11 responseStatus SUCCESS
12 status 20011

Example Request JSON:

{
"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
}

Response Parameter from Partner to Visioner

 No. Parameter Desc. Length

Response status should be

1 responseStatus STR-20
"SUCCESS" or "FAILED"
Transaction success response
2 responseCode NUM-10
code (Check response code list)
Transaction success response
3 responseDescription description (Check response STR-100
description list)
Partner unique transaction
4 partnerTransactionNo STR-25
number
Partner’s unique reference
number, it’s Optional or can be
5 partnerReferenceNo STR-25
used for Phone Number or can be
empty
Partner callback reference
6 partnerCallbackReference STR-25
number, can be optional
Unique transaction number
7 invoice_number automatically generated by STR-25
Visioner
Partner transaction status
8 partnerTransactionStatus STR-25
should be "VALID" or "INVALID"
Payment status "PAID" or
9 partnerPaymentStatus STR-25
"UNPAID" or "FREE
Payment success timestamp by
10 partnerPaymentTimeStamp STR-10
partner

Example Reponse Data From Partner

{
"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",
}

Response Code Description :

QRIS Response Code

No. Code Desc. Detail

1 20011 Transaction Success Transaction Success

2 20012 Invalid Transaction Invalid Value or NULL
3 20013 Null Store Identifier Store Identifier is NULL
4 20014 Null Amount Amount is NULL
Partner Transaction Number Is
5 20015 Null Transaction Number
NULL
6 20016 Null Secret Key Secret Key Is NULL
7 20017 Invalid Secret Key Wrong Secret Key
Store Identifier Not Wrong Store Identifier, Merchant
8 20018
Found cannot be found
Your acount has not been
9 20019 Account Is not Active activated, please contact our
admin
Your account number has not been
10 20020 Number is not verified verified yet, please verify your
number first
Your account has been deactivated
11 20021 Account is deactivated by the admin, please contact
damin for further information
Your merchant is deactivated by
12 20022 Merchant is deactivated admin, please contact the admin
for further information
Duplicate Transaction, this
Duplicate Partner
13 20023 transaction number has been
Transaction Number
requested before
The amount transaction value is
Amount Transaction Number
14 20024 exceeded, the maximum transaction
is Exceeded
is Rp. 10.000.000,00
The amount transaction value is
Amount Transaction Number
15 20025 lesser than minim amount, the
is Less Than Minimum
minimum transaction is Rp. 1
There's an internal server error,
16 20026 Transaction Error please contact the admin for
further action

QRIS Transaction Inquiry Response Code

No. Code Desc. Detail

1 30011 Transaction Found Transaction Found

Invalid Transaction, Transaction
3 30012 Data Not Found
Number Can't Be Found
Invalid Payment Status, pease
6 30013 Invalid Inquiry Status
contact admin

QRIS Callback Response Code From Partner

No. Code Desc. Detail

1 40011 Callback Success Transaction Calback successful

2 40012 Invalid Value Request Value is not valid
3 40013 Null Login Parameter Login Parameter is NULL
4 40014 Null Password Parameter Password Parameter is NULL
5 40015 Null Secret Key Parameter Secret Key Parameter is NULL
Null Partner Partner Transaction Number
6 40016
TransactionNo Parameter Parameter is NULL
7 40017 Null Amount Parameter Amount Parameter is NULL
8 40018 Null Mdr Payment Amount MDR Amount Parameter is NULL
9 40019 Null Invoice Number Invoice Number Parameter is NULL
Payment Timestamp Parameter is
10 Null Payment Time Stamp
40020 NULL
11 40021 Null Payment Status Payment Status Parameter is NULL
Transaction Data Not
12 Transaction data can't be found
40022 Found
13 40023 Invalid login credentials Login Credentials is not valid
Transaction Data Not
14 40024 Transaction data can't be found
Found