Reversal - API NICEPAY Inquiry Virtual Account SNAP

tentang reversal api nicepay inquiry virtual account snap bagian ini berisi tentang informasi terkait api dengan standar snap yang digunakan pada metode pembayaran virtual account dengan fitur nicepay inquiry virtual account (niva) untuk mengirimkan notifikasi dari bank kepada nicepay kemudian, nicepay akan mengirimkan notifikasi kepada merchant terkait pengembalian dana/pembatalan terhadap pembayaran yang telah berhasil terbayar hal ini sangat jarang terjadi dan disebabkan kondisi tertentu pada bank, sehingga pembayaran yang telah berhasil menjadi batal atau dilakukan pengembalian dana kembali kepada pelanggan ketika mendapatkan notifikasi reversal, merchant disarankan untuk membatalkan transaksi, menghubungi pelanggan atau tindakan lain sesuai prosedur pada sisi merchant reversal api nicepay inquiry virtual account snap silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian docid\ tbdhymkvqk7c20nukjb0n api endpoint \[merchant domain]/api/v1 0/transfer va/reversal method http post description untuk mengirimkan notifikasi reversal kepada merchant content type application/json pada saat melakukan proses integrasi, nicepay akan mengirimkan public key kepada merchant kemudian, merchant wajib memberi informasi terkait endpoint api inquiry va dan mengirimkan client id & client secret sesuai dengan spesifikasi nicepay kepada tim nicepay hal tersebut perlu dilakukan agar nicepay dapat mengajukan akses token dan melakukan inquiry data pelanggan yang berada di sisi merchant sehingga, proses pembayaran dapat dijalankan dengan lancar oleh pelanggan anda request reversal header parameter parameter tipe ukuran kebutuhan deskripsi contoh 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 docid\ uzex33relyenkogbjjnyp 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 tipe ukuran kebutuhan deskripsi 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 docid 9woqy5 1hlf ucwshsdho response reversal parameter parameter tipe ukuran kebutuhan deskripsi responsecode string mandatory docid\ lkqjxsl5cmkdxyxxhyyss 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" } }