NICEPAY API
...
Payment API - SNAP
API Virtual Account SNAP
Cancel - API Virtual Account SNAP
7 min
about cancel api virtual account snap this api with snap standards uses to request transaction cancellation process on virtual account payment method merchant cancel virtual account api please request the access token firsthand before doing the authentication through the request access token api snap docid 92feymrqs iebhxrfgxuq section service code 31 api endpoint /api/v1 0/transfer va/delete va http method delete description to request va transaction cancellation process content type application/json request cancel 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 cancel body parameter parameter type length required description partnerserviceid string 20 mandatory partner service id / prefix customerno string 40 mandatory customer number (mandatory for fix type) virtualaccountno string 25 mandatory virtual account number trxid string 40 mandatory transaction id (reference number from merchant) additionalinfo object mandatory "additionalinfo" { "totalamount" { }, } totalamount object mandatory "totalamount" { } value string 12 mandatory transaction amount currency string 3 mandatory currency txidva string 40 mandatory transaction id cancelmessage string 255 mandatory cancel message response cancel parameter parameter type length required description responsecode string mandatory general response code and message api snap docid\ bjr4kjamzcknln 5zrnvw responsemessage string mandatory general response code and message api snap docid\ bjr4kjamzcknln 5zrnvw virtualaccountdata object mandatory "virtualaccountdata" { } partnerserviceid string 20 mandatory partner service id / prefix customerno string 40 mandatory customer number (mandatory for fix type) virtualaccountno string 40 mandatory virtual account number trxid string 40 mandatory transaction id (reference number from merchant) additionalinfo object mandatory "additionalinfo" { , "totalamount" { } } txidva string 40 mandatory transaction id cancelmessage string 200 mandatory cancel message cancelvatime string 8 mandatory cancel virtual account time totalamount object mandatory "totalamount" { } value string 12 mandatory transaction amount currency string 3 mandatory currency 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 exid202402111402271707638095 channel id normaltest { "partnerserviceid" "08889", "customerno" "12345678901234567890", "virtualaccountno" "9912304000007307", "trxid" "2024123000000000000001", "additionalinfo" { "totalamount" { "value" "10000 00", "currency" "idr" }, "txidva" "normaltest02202401181001033629", "cancelmessage" "cancel virtual account" } } sample response { "responsecode" "2003100", "responsemessage" "success", "virtualaccountdata" { "partnerserviceid" "088899", "customerno" "12345678901234567890", "virtualaccountno" "9912304000007307", "trxid" "2024123000000000000001", "additionalinfo" { "txidva" "normaltest02202401181001033629", "cancelmessage" "cancel virtual account", "cancelvatime" "2024 12 31t10 11 40+07 00", "totalamount" { "value" "10000 00", "currency" "idr" } } } }