Payment - API NICEPAY Inquiry Virtual Account SNAP

tentang payment 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) yang memberikan kebebasan untuk merchant menyimpan data pelanggan dan membuat nomor virtual account sendiri di sistemnya selama masih mengikuti ketentuan pembuatan nomor va dari nicepay payment api nicepay inquiry virtual account snap silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian docid\ tbdhymkvqk7c20nukjb0n service code 25 api endpoint \[merchant domain]/api/v1 0/transfer va/payment http method http post description untuk melakukan pembayaran transaksi niva 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 payment 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 payment body parameter parameter tipe ukuran kebutuhan deskripsi partnerserviceid string 20 mandatory partner service id / prefix customerno string 40 mandatory customer number virtualaccountno string 25 mandatory virtual account number virtualaccountname string 100 optional virtual account name trxid string 40 mandatory merchant order number paymentrequestid string 128 mandatory unique identifier hashedsourceaccountno string 32 optional source account number in hash or unhash depend on bank sourcebankcode string 11 optional source account bank paidamount object mandatory total amount "paidamount" { } value string 12 mandatory value currency string 3 mandatory currency trxdatetime string 25 optional date transaction additionalinfo object mandatory additional information "additionalinfo" { } bankcd string 4 mandatory docid 9woqy5 1hlf ucwshsdho response payment parameter parameter tipe ukuran kebutuhan deskripsi responsecode string mandatory docid\ lkqjxsl5cmkdxyxxhyyss responsemessage string mandatory response message virtualaccountdata object mandatory partnerserviceid string 20 mandatory partner service id / prefix customerno string 40 mandatory customer number virtualaccountno string 25 mandatory virtual account number virtualaccountname string 100 mandatory virtual account name trxid string 40 mandatory reference number from merchant paymentrequestid string 128 mandatory unique identifier paidamount object mandatory total amount "paidamount" { } value string 12 mandatory transaction amount currency string 3 mandatory currency trxdatetime string 25 optional date transaction additionalinfo object optional additional information "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 txid202402111402271707638113 channel id fixopen001 { "partnerserviceid" "70151021", "customerno" "10000001", "virtualaccountno" "7015102110000001", "virtualaccountname" "john test", "trxid" "ref100000001", "trxdatetime" "2024 02 01t15 40 06+07 00", "paymentrequestid" "fixopen0010000000006", "hashedsourceaccountno" "abcdefghij12345", "sourcebankcode" "008", "paidamount" { "value" "10000 00", "currency" "idr" }, "additionalinfo" { "bankcd" "bmri", } } sample response { "responsecode" "2002500", "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" "ref100000001" }, "additionalinfo" { "goodsnm" "test item", } }