Notification - API Virtual Account SNAP

tentang notification api virtual account snap {{api}} dengan standar {{snap}} ini digunakan untuk mengirimkan {{notifikasi}} {{transaksi}} {{pembayaran}} pada {{metodebayar}} {{va}} panduan validasi x signature berikut adalah cara untuk melakukan validasi x signature pada request header notify sha256withrsa (public key, stringtosign) stringtosign = client id + “|” + x timestamp informasi khusus {{api}} notifikasi {{snap}} terkait kredensial public key akan diberikan oleh tim {{nicepay}} kepada {{merchant}} melalui email, karena kredensial public key {{yang}} akan digunakan di {{api}} notifikasi {{snap}} berbeda dengan {{api}} transaksi {{snap}} (registration, inquiry & {{paymentproduct}} ) {{silakan}} menghubungi tim integrasi melalui email ( mailto\ integration\@nicepay co id ) untuk {{informasi}} atau bantuan lebih lanjut berikut adalah contoh hasil x signature dari cara validasi di atas 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 = ip public environtment production 103 20 51 34 103 20 51 33 ip public environtment dev 103 20 51 39 103 20 51 40 request notification header parameter parameter tipe kebutuhan deskripsi 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 tipe ukuran kebutuhan deskripsi partnerserviceid string 20 mandatory {{partner}} service id / prefix customerno string 40 mandatory {{customer}} number virtualaccountno string 16 mandatory {{va}} number virtualaccountname string 100 mandatory {{va}} 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 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 9woqy5 1hlf ucwshsdho goodsnm string 200 mandatory goods name vacctvaliddt string 8 mandatory {{va}} valid date vacctvalidtm string 6 mandatory {{va}} valid time response notification header parameter parameter tipe kebutuhan deskripsi 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 tipe ukuran kebutuhan deskripsi responsecode string 7 mandatory docid\ lkqjxsl5cmkdxyxxhyyss responsemessage string 150 mandatory response message virtualaccountdata object variable mandatory {{va}} data partnerserviceid string 20 mandatory {{partner}} service id / prefix customerno string 40 mandatory {{customer}} number virtualaccountno string 16 optional {{va}} number virtualaccountname object 100 mandatory {{va}} name trxid object 40 mandatory {{merchant}} reference number 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 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 9woqy5 1hlf ucwshsdho goodsnm string 200 mandatory goods name vacctvaliddt string 8 mandatory {{va}} valid date vacctvalidtm string 6 mandatory {{va}} valid time 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", "sourcebankcode" "008", "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", "hashedsourceaccountno" "abcdefghijklmnopqrstuvwxyz123456", "sourcebankcode" "008", "paidamount" { "value" "10000 00", "currency" "idr" }, "trxdatetime" "20201231t235959z", "additionalinfo" { "bankcd" "bmri", "goodsnm" "test", "vacctvaliddt" "20221110", "vacctvalidtm" "161037" } } }