Notification - API Virtual Account SNAP

about notification api virtual account snap this api with the snap standards uses to send the payment transaction notification on the virtual account payment method x signature guidance validation the following is guidance to proceed x signature validation on request header notify sha256withrsa (public key, stringtosign) stringtosign = client id + “|” + x timestamp information specific to {{the}} {{snap}} notification {{api}} regarding {{the}} public key will be provided by {{the}} {{nicepay}} team to {{the}} {{merchant}} via email, because {{the}} public key credential used in {{the}} {{snap}} notification {{api}} is different from {{the}} {{snap}} transaction {{api}} (registration, inquiry & {{paymentproduct}} ) {{please}} contact {{the}} integration team through email ( mailto\ integration\@nicepay co id ) for further {{information}} or assistance the following is the example of x signature result from the above guidance validation" myyscwbs00bm0tjq/xy7uu1goh8qxjyyslo88rfrhq+mlyqkmtq nkmlzdps+ merchant notification api virtual account snap service code 25 api endpoint \[merchant domain]/api/v1 0/transfer va/payment http method post content type application/json description transaction result notification (when success) if your system use firewall, add allow policy for nicepay ip 103 20 51 0/24 103 117 8 0/24 request notification header parameter parameter type required description content type string mandatory application / json 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 client key string mandatory unique partner id, partner id = client id x signature string mandatory signature will be generated by merchant docid\ uzex33relyenkogbjjnyp request notification 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 virtualaccountname string 100 mandatory virtual account name trxid string 40 mandatory transaction id (reference number from merchant) paymentrequestid string 128 mandatory unique identifier from nicepay hashedsourceaccountno string 32 optional source account number in hash or unhash depend on bank sourcebankcode string 11 optional optional source account bank code paidamount object variable mandatory amount of paid value string 12 mandatory value currency string 3 mandatory currency trxdatetime string 25 mandatory transaction date time additionalinfo object variable mandatory additional information bankcd string 4 mandatory docid 5pxu cbdxvy2biili8 cv goodsnm string 200 mandatory goods name vacctvaliddt string 8 mandatory virtual account valid date vacctvalidtm string 6 mandatory virtual account valid time response notification header parameter parameter type required description content type string mandatory application / json 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 response notification body parameter parameter type length required description responsecode string 7 mandatory docid\ bjr4kjamzcknln 5zrnvw responsemessage string 150 mandatory response message virtualaccountdata object variable mandatory virtual account data partnerserviceid string 20 mandatory partner service id / prefix customerno string 40 mandatory customer number virtualaccountno string 16 optional virtual account number virtualaccountname object 100 mandatory virtual account name trxid object 40 mandatory merchant reference number paymentrequestid string 128 mandatory unique identifier from nicepay paidamount object variable mandatory amount of paid value object 12 mandatory value currency string 3 mandatory currency trxdatetime string 25 mandatory transaction date time additionalinfo object variable mandatory additional information bankcd string 4 mandatory docid 5pxu cbdxvy2biili8 cv goodsnm string 200 mandatory goods name sample parameter for notification api virtual account snap request parameter curl curl location 'https //www merchantbaseurl com/api/v1 0/transfer va/payment' \\ \ header 'content type application/json' \\ \ header 'x timestamp 2023 11 23t07 44 11+07 00' \\ \ header 'x signature 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5' \\ \ header 'x client key 82150823919040624621823174737537' \\ \ data '{ "partnerserviceid" "70151021", "customerno" "10000001", "virtualaccountno" "7015102110000001", "virtualaccountname" "john test", "trxid" "abcdefgh1234", "paymentrequestid" "008", "hashedsourceaccountno" "abcdefghijklmnopqrstuvwxyz123456", "paidamount" { "value" "10000 00", "currency" "idr" }, "trxdatetime" "20201231t235959z", "additionalinfo" { "bankcd" "bmri", "goodsnm" "test", "vacctvaliddt" "20221110", "vacctvalidtm" "161037" } }' response parameter sample response //header section content type application/json x timestamp 2023 11 23t07 44 16+07 00 { "responsecode" "2002500", "responsemessage" "success", "virtualaccountdata" { "partnerserviceid" "70151021", "customerno" "10000001", "virtualaccountno" "7015102110000001", "virtualaccountname" "john test", "trxid" "abcdefgh1234", "paymentrequestid" "2020102900000000000001", "paidamount" { "value" "100000 00", "currency" "idr" }, "trxdatetime" "20201231t235959z" }, "additionalinfo" { "bankcd" "bmri", "goodsnm" "test" } }