Inquiry - API NICEPAY Inquiry Virtual Account SNAP

tentang inquiry 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) agar dapat memeriksa status transaksi inquiry api nicepay inquiry virtual account snap silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian docid\ tbdhymkvqk7c20nukjb0n service code 24 api endpoint \[merchant domain]/api/v1 0/transfer va/inquiry method http post description untuk melakukan pemeriksaan status 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 inquiry 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 inquiry 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 inquiryrequestid string 40 mandatory unique identifier for this inquiry additionalinfo object mandatory "additionalinfo" { } bankcd string 4 mandatory docid 9woqy5 1hlf ucwshsdho response inquiry parameter parameter tipe ukuran kebutuhan deskripsi responsecode string mandatory docid\ lkqjxsl5cmkdxyxxhyyss responsemessage string mandatory response message virtualaccountdata object mandatory "virtualaccountdata" { "partnerserviceid" "70151021", "customerno" "89101110", "virtualaccountno" "7015102189101110", "virtualaccountname" "john test", "inquiryrequestid" "41807553358950093184", "totalamount" { } }, 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 virtualaccountname string 100 mandatory virtual account name inquiryrequestid string 40 mandatory unique identifier for this inquiry totalamount object mandatory "totalamount" { } value string 12 mandatory value currency string 3 mandatory currency additionalinfo object mandatory "additionalinfo" { } trxid string 40 mandatory merchant order number 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 txid202402111402271707638114 channel id fixopen001 { "partnerserviceid" "70151021", "customerno" "89101110", "virtualaccountno" "7015102189101110", "inquiryrequestid" "41807553358950093184", "additionalinfo" { "bankcd" "bmri" } } sample response { "responsecode" "2002400", "responsemessage" "success", "virtualaccountdata" { "partnerserviceid" "70151021", "customerno" "89101110", "virtualaccountno" "7015102189101110", "virtualaccountname" "john test", "inquiryrequestid" "41807553358950093184", "totalamount" { "value" "10000 00", "currency" "idr" } }, "additionalinfo" { "trxid" "ref100000001", "goodsnm" "test item" } }