NICEPAY API
...
Payment API - SNAP
API Virtual Account SNAP

Check Status Transaction - API Virtual Account SNAP

8min
about check status transaction api virtual account snap this api with the snap standards uses by the merchant to request status inquiry checking to nicepay check status transaction api please request the access token firsthand before doing the authentication through the request access token api snap docid 92feymrqs iebhxrfgxuq section service code 26 api endpoint /api/v1 0/transfer va/status method http post description to request status inquiry checking to nicepay content type application/json request check status header parameter parameter type length required description example content type string mandatory application / json authorization string mandatory bearer “ access token ” x timestamp string mandatory using iso 8601 as timestamp format transaction date time, in format yyyymmddthh\ mm\ ss+07 00 time must be in gmt+7 (jakarta time) 2022 03 21t10 11 40+07 00 x signature string mandatory signature will be generated by merchant snap api testing x partner id string 20 mandatory x partner id = client id x external id string 40 mandatory unique reference number ( 41807553358950093184 ) channel id string mandatory unique channel merchant credential id number client id + "01" = channel id "ionpaytest" + "01" = "ionpaytest01" ionpaytest01 request check status body parameter for partnerserviceid and virtualaccountno parameters can send with an empty value parameter type length required description partnerserviceid string 20 mandatory partner service id / prefix customerno string 40 mandatory customer number virtualaccountno string 25 mandatory virtual account number inquiryrequestid string 128 the same value as x external id additionalinfo object mandatory "additionalinfo" { "totalamount" { }, } totalamount object mandatory "totalamount" { } value string 12 mandatory transaction amount currency string 3 mandatory currency trxid string 40 mandatory reference number from merchant txidva string 30 mandatory transaction id (generated by nicepay) response check status parameter parameter type length required description responsecode string mandatory general response code and message api snap docid\ bjr4kjamzcknln 5zrnvw responsemessage string mandatory response message virtualaccountdata object mandatory partnerserviceid string 20 mandatory partner service id / prefix customerno string 40 mandatory customer number virtualaccountno string 25 mandatory virtual account number inquiryrequestid string 128 mandatory the same value as x external id totalamount object mandatory value string 12 mandatory transaction amount currency string 3 mandatory currency additionalinfo object mandatory bankcd string 4 mandatory bank code api snap docid 9woqy5 1hlf ucwshsdho txidva string 30 mandatory transaction id (generated by nicepay) goodsnm string 200 mandatory goods name vacctvaliddt string 8 mandatory virtual account valid date vacctvalidtm string 6 mandatory virtual account valid time virtualaccountname string 100 mandatory virtual account name trxid string 40 mandatory reference number from merchant transactionstatusdesc string mandatory transaction status description success pending refunded canceled failed latesttransactionstatus string mandatory transaction status api snap docid\ nvclmbygxr5uc 5qmyu7 00 success 03 pending 04 refunded 05 canceled 06 failed sample parameter sample request //header section content type application/json authorization bearer eyj0exaioijkv1qilcjhbgcioijiuzi1nij9 eyjzdwiioijjt05qqvlurvnuiiwiaxnzijoitkldrvbbwsisim5hbwuioijcukloiiwizxhwijoimjaync0wmi0xmvqwodowotoznvoifq== aiyblx36dywffvw7dcoenxkoe2eawiyq84ztpuif3k8= x timestamp 2024 12 31t10 11 40+07 00 x signature ufbw7r8rhw79ioiv/hlv607m60qzaybv8uzmbsryb6/thlo/fhqvp4xryeluehoss9o+qs6vwtkb/ygtucc+tq== x partner id normaltest x external id txid202402111402271707638094 channel id normaltest { "partnerserviceid" "86230927", "customerno" "87654321", "virtualaccountno" "9912304000007307", "inquiryrequestid" "txid202402111402271707638094", "additionalinfo" { "totalamount" { "value" "10000 00", "currency" "idr" }, "trxid" "2024123000000000000001", "txidva" "normaltest02202401181001033629" } } sample response { "responsecode" "2002600", "responsemessage" "successful", "virtualaccountdata" { "partnerserviceid" "86230927", "customerno" "87654321", "virtualaccountno" "9912304000007307", "inquiryrequestid" "txid202402111402271707638094", "totalamount" { "value" "10000 00", "currency" "idr" } }, "additionalinfo" { "bankcd" "cena", "txidva" "normaltest02202401181001033629", "goodsnm" "test", "vacctvaliddt" "20240125", "vacctvalidtm" "100103", "virtualaccountname" "john test", "trxid" "2024123000000000000001", "transactionstatusdesc" "success", "latesttransactionstatus" "00" } }