Reversal - API NICEPAY Inquiry Virtual Account SNAP

about reversal api nicepay inquiry virtual account snap this api with snap standards contains information uses on the virtual account payment method with the nicepay inquiry virtual account (niva) feature to send the notification from the bank to nicepay then, nicepay will send a notification to the merchant about the refund/cancellation of the paid transaction this issue rarely occurs and causes by specific conditions from the bank, so the successful payment becomes canceled or refunded to the customer if receiving the reversal notification, the merchant recommended aborting the transaction, contacting the customer, or proceeding with another action relevant to the merchant procedure reversal api api nicepay inquiry virtual account snap please request the access token firsthand before doing the authentication through the request access token api nicepay inquiry virtual account snap docid\ lihdvaobqwtamwijj4k6e section api endpoint \[merchant domain]/api/v1 0/transfer va/reversal method http post description for sending reversal notification to the merchant content type application/json when proceeding with the integration process, nicepay will send a public key to the merchant then, the merchant must inform the information related to the api va inquiry endpoint and send the client id & client secret based on nicepay specification to the nicepay team that must proceed so nicepay can request an access token and proceed with the customer data inquiry on the merchant side therefore, the payment process can easily proceed by the customers request reversal 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 reversal body parameter parameter type length required description partnerserviceid string 20 mandatory partner service id / prefix customerno string 40 mandatory customer number virtualaccountno string 16 mandatory virtual account number (if you have concern for va number please call our pic) virtualaccountname string 100 optional virtual account name trxid string 40 mandatory merchant order number paymentrequestid string 128 mandatory unique identifier from nicepay trxdatetime string 25 optional transaction date time paidamount object mandatory value string 12 mandatory value currency string 3 mandatory currency additionalinfo object mandatory additional info "additionalinfo" { } bankcd string 4 mandatory bank code api snap docid 5pxu cbdxvy2biili8 cv response reversal parameter parameter type size rq description responsecode string mandatory general response code and message api snap docid\ bjr4kjamzcknln 5zrnvw responsemessage string mandatory response message virtualaccountdata object mandatory "virtualaccountdata" { } partnerserviceid string 20 mandatory partner service id / prefix customerno string 40 mandatory customer number virtualaccountno string 16 mandatory virtual account number (if you have concern for va number please call our pic) virtualaccountname string 100 mandatory virtual account name trxid string 40 mandatory reference number from merchant paymentrequestid string 128 mandatory unique identifier from nicepay trxdatetime string 25 optional transaction date time paidamount object mandatory value string 12 mandatory value currency string 3 mandatory currency additionalinfo object mandatory "additionalinfo" { } goodsnm string 200 mandatory goods name 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 fixopen001 x external id txid202402111402271707638115 channel id fixopen001 { "partnerserviceid" "70151021", "customerno" "10000001", "virtualaccountno" "7015102110000001", "virtualaccountname" "john test", "trxid" "abcdefgh1234", "paymentrequestid" "fixopen0010000000006", "paidamount" { "value" "10000 00", "currency" "idr" }, "trxdatetime" "2024 02 01t15 40 06+07 00", "additionalinfo" { "bankcd" "bmri" } } sample response { "responsecode" "2000000", "responsemessage" "successful", "virtualaccountdata" { "partnerserviceid" "70151021", "customerno" "10000001", "virtualaccountno" "7015102110000001", "virtualaccountname" "john test", "paymentrequestid" "fixopen0010000000006", "paidamount" { "value" "100000 00", "currency" "idr" }, "trxdatetime" "2024 02 01t15 40 06+07 00", "trxid" "abcdefgh1234" }, "additionalinfo" { "goodsnm" "test" } }