NICEPAY API
...
Payment API - SNAP
API E-Wallet (Direct Debit) SN...
Registration - API E-Wallet (Direct Debit) SNAP
7min
tentang registration api e wallet (direct debit) snap api ini digunakan untuk mengajukan pendaftaran transaksi melakukan pembayaran menggunakan metode pembayaran e wallet dengan fitur direct debit host to host yang sesuai standar snap bi registration api e wallet (direct debit) snap silakan mengajukan akses token terlebih dahulu untuk melakukan autentikasi melalui bagian request access token api snap docid\ gcgqbiyxg1etcd0ji9chx service code 54 api endpoint /nicepay/api/v1 0/debit/payment host to host https //dev nicepay co id/nicepay/api/v1 0/debit/payment host to host http method post description request direct debit transaction for authentication payment content type application/json request registration header parameter parameter tipe ukuran kebutuhan deskripsi contoh content type string 127 mandatory content type, value always application/json authorization string variable mandatory bearer “ accesstoken ” x timestamp string 25 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 variable mandatory signature will be generated by merchant snap api testing x partner id string 20 mandatory unique partner id, partner id = client id x external id string 40 mandatory unique messaging reference id generated by merchant numeric string reference number that should be unique in every transaction channel id string 20 mandatory unique channel merchant credential id number client id + "01" = channel id "ionpaytest" + "01" = "ionpaytest01" ionpaytest01 request registration body parameter parameter tipe kebutuhan ukuran deskripsi atau contoh partnerreferenceno string mandatory 40 transaction id from merchant merchantid string mandatory 10 merchant identifier that is unique per each merchant submerchantid string optional 32 sub merchant identifier externalstoreid string optional 32 unique identifier of shop id in client system amount array of json object mandatory variable amount information value string mandatory 12 transaction amount, including thecents currency string mandatory 3 currency code based on iso urlparam array of json object mandatory variable notify url that merchant must send the payment notification url string mandatory 512 indicates the url of the client’s app to redirect back to once payment has been completed in merchant merchant accepts http links and url scheme formats type string mandatory 32 indicates the type of the sent url only accepts ‘ pay return ” and ‘ pay notify ” value isdeeplink string mandatory 1 indicates whether the url is a deep link or not, only accepts ‘y’ value validupto string optional 25 the time when the payment will be automatic only expired iso 8601, in yyyy mmddthh format mm\ ss+07 00 time must be in gmt+7 (jakarta time) pointofinitiation string optional 20 used for getting more info regarding source of request of the ser additionalinfo array of json object optional variable additional information "additionalinfo" { } mitracd string mandatory 4 mitra code api snap docid\ mebnfcdeq1gfus9oe mof example ovo ovoe link aja link dana dana shopeepay eshp goodsnm string mandatory 200 goods name billingnm string mandatory 100 buyer name billingphone string mandatory 20 buyer phone number billingemail string optional 40 buyer e mail callbackurl string mandatory 500 payment result forward url (on browser) dbprocessurl string mandatory 500 payment notification url (async notification) cartdata string mandatory 4000 {json format} msid string optional 20 merchant seller id msfee string optional 7 merchant seller fee msfeetype string optional 2 merchant seller fee type mbfee string optional 7 merchant balance fee mbfeetype string optional 2 merchant balance fee type response registration parameter parameter tipe kebutuhan ukuran deskripsi atau contoh responsecode string mandatory 7 refer to general response code and message api snap docid\ lkqjxsl5cmkdxyxxhyyss list responsemessage string mandatory 150 refer to general response code and message api snap docid\ lkqjxsl5cmkdxyxxhyyss list partnerreferenceno string mandatory 40 merchant transaction identifier referenceno string mandatory 40 original transaction identifier on service provider system appredirecturl string optional 2048 returns an url scheme to payment page in native app for shopeepay, this value will be deprecated for shopeepay, this value will be deprecated webredirecturl string optional 2048 partner checkout url additionalinfo string optional variable additional information "additionalinfo" { } redirecttoken string optional 255 partner checkout token 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 tniceew05 x external id txid202402111402271707638099 channel id tniceew05 { "partnerreferenceno" "2020102900000000000001", "merchantid" "tniceew05", "submerchantid" "310928924949487", "amount" { "value" "12345678 00", "currency" "idr" }, "urlparam" \[ { "url" "https //test1 bi go id/v1/test", "type" "pay notify", "isdeeplink" "y" }, { "url" "https //test2 bi go id/v1/test", "type" "pay return", "isdeeplink" "y" } ], "externalstoreid" "239840198240795109", "validupto" "2020 12 23t07 44 11+07 00", "pointofinitiation" "mobile app", "additionalinfo" { "mitracd" "dana", "goodsnm" "merchant goods 1", "billingnm" "buyer name", "billingphone" "02112345678", "billingemail" "jhondoe\@gmail com", "callbackurl" "http //www merchant com/callback”, "dbprocessurl" "http //www merchant com/notification”, "cartdata" "{\\"count\\" \\"2\\",\\"item\\" \[{\\"img url\\" \\"http //img aaa com/ima1 jpg\\",\\"goods name\\" \\"item 1 name\\",\\"goods detail\\" \\"item 1 detail\\",\\"goods amt\\" \\"0 00\\",\\"goods quantity\\" \\"1\\"},{\\"img url\\" \\"http //img aaa com/ima2 jpg\\",\\"goods name\\" \\"item 2 name\\",\\"goods detail\\" \\"item 2 detail\\",\\"goods amt\\" \\"12345678 00\\",\\"goods quantity\\" \\"1\\"}]}", "msid" "123", "msfee" "2000", "msfeetype" "2", "mbfee" "2000", "mbfeetype" "2" } } sample response { "responsecode" "2005400", "responsemessage" "successful", "partnerreferenceno" "2020102900000000000001", "referenceno" "tniceew05105202210141451109841", "webredirecturl" "https //pjsp com/universal?bizno=ref993883& ", "additionalinfo" { "redirecttoken" " df548fff93e82aad9174c657820a85aa5d10042535157c7e89f52499" } }