Encryption - Payment API Credit Card

about encryption payment api credit card encryption payment api credit card is the credit card payment transaction data that must going through encryption process firsthand from the merchant side api endpoint /nicepay/direct/v2/payment request method popup, redirect, submit, etc(not server to server api) only support post post description the page redirected to authentication page(in bank side), if 3ds authentication is required the page will be redirected to the card issuer authentication page verification(in bank side) making the payment the page will be forwarded to the callback url merchant token sha256( timestamp + imid + referenceno + amt + merchantkey ) request format sha256 (publickey) api payment credit card which used on this encryption are similar with credit card features full payment & installment, recurring and preauth & capture the difference is on the card data parameter ( cardno , cardexpyymm , cardcvv and cardholdernm ) which merchant must give those parameter through encryption process firsthand during proceeding the payment request to nicepay request parameter for encryption payment api credit card parameter tipe ukuran deskripsi contoh / catatan timestamp required required n 14 api request timestamp ( yyyymmddhh24miss ) 20221202141217 txid required required an 30 transaction id ionpaytest01202212021455054652 cardno required required n 200 full card number using encrypted format & base64 url encode n9auywvp0cgk7m9sjajbwf43%2f6m fi6xzlnqzljsimvdnaeq56p6m6ckhyrd cl14e5tczlrwqzso6pvcpn%2fwgppm wwk%2br0byopuyh%2ffwnjy%2bo bwwlroefe7lpoxawosuzxw%2bqpw mat7vqxzndeis19dq%2fe28pcgfted 0xdqabdtq%3d cardexpyymm required required a 200 card expiry ( yymm ) using encrypted format & base64 url encode q6ye2qcjxrjuq%2b3kyctersf1npu58%2fmas4rp7qthllefx9fdfdyp3snj%2f qkrzatatqbdsm3tcy5ith29ygpgn9y mb1k19ztugtiu9n9nflquiw%2bcttv 4z0ykwfxzntbj3ymgchmangiadi9% 2fdurl5plnpval9ags5xn3ffoy8ru%3 d cardcvv required required n 200 card cvv using encrypted format & base64 url encode fpxq8fdw1y0tbfmdtaoluxqteh7i3rz qyy6%2b0g%2bwopykthm5crtq%2 bd7cyesvlirsvcjbzm4lgtnbfwp5rva hkopqiqmazrf0cql1uuquywfa%2b ngwobg3depybxwdpifmtwove7jd3 zfp4b0ik23ha46b0bdvri1zqiz%2bx7 nwzke%3d cardholdernm required required an 200 card holder name using encrypted format & base64 url encode jy6lrwsw%2bo9815dx8jacpvvijx1wi0 qiovnbieogwewmkzzd92n8vvdi3rw xflu2hqtfk0w6ibglnaprovl5upr3% 2fo4gy0p3u8rjkieunh1qgjp7fo69n dvv6gtwo1ehjs0cmsibvnyublbq72b ttkvkqzpaugqhvquwbwaw6hs%3d recurringtoken required required for recurring payment only an 64 recurring token 9338d54573688ae18e175240b0257d e48d89c6ef1c9c7b5c094dc4beed9e4 35f preauthtoken required required for capture process in preauth o nly an 64 pre auth token 9338d54573688ae18e175240b0257d e48d89c6ef1c9c7b5c094dc4beed9e4 35f imid required required an 10 merchant id ionpaytest merchanttoken required required an 255 {{merchant}} token c91e6531f6c84869439bc5ebe5389bd71e7752c054fc9dbfe193d087a1b797ae callbackurl required required ans 255 {{paymentproduct}} result url https //merchant com/callbackurl encrypted required required n 1 flagging for payment transaction use encryption or not 1 = using encrypt method 0 = not using publickey required required an 64 publickey hashing of your public key (sha256) a5f3445e7dd166b8c6cfef685047098f1a03755aeedb97a06002d7a754081338 response parameter for encryption payment api credit card parameter tipe ukuran deskripsi contoh / catatan resultcd n 14 docid 7o8nl7guqp asiwfdqi3v code of responses resultmsg an 255 result message docid\ wpcemazro xvnxz 1zaib responses message txid an 30 transaction id when success referenceno ans 40 {{merchant}} order number when success paymethod n 2 docid\ iifmsruuw7j9vmwefjz97 when success amt n 12 {{paymentproduct}} amount when success currency an 3 currency when success goodsnm a 100 goods name when success billingnm a 100 buyer name when success transdt n 8 transaction date ( yyyymmdd ) when success transtm n 6 transaction time ( hh24miss ) when success description an 100 transaction description when success authno n 10 approval number when success, cc issubankcd a 4 docid\ ky4ppujot06atnie easf when success, cc acqubankcd a 4 docid\ ky4ppujot06atnie easf when success, cc cardno ans 20 card number with masking when success, cc cardexpyymm n 4 card expiry ( yymm ) when success, cc instmntmon n 2 installment month when success, cc instmnttype n 2 docid\ rt2c32s9hfl aohyoebv5 when success, cc recurringtoken an 64 recurring payment token when success cc recurring preauthtoken an 64 pre auth payment token when success cc pre auth cctranstype n 2 docid 5kylpx5mpjsl96c8mhoik when success, cc 1 normal 2 recurring 3 pre auth 4 capture vat n 12 vat when success, cc fee n 12 service fee when success, cc notaxamt n 12 tax free amount when success, cc mitracd a 4 mitra code when success clickpay, e wallet, payloan receiptcode ans 20 authorization no when success clickpay mrefno an 18 bank reference no when success clickpay cardbrand n 2 card brand name 1 = visa 2 = mastercard 3 = jcb 4 = amex 5 = others sample parameter for encryption payment api credit card request parameter curl curl location 'https //dev nicepay co id/nicepay/direct/v2/payment' \\ \ header 'x forwarded for 1 2 3 4' \\ \ header 'content type application/x www form urlencoded' \\ \ data urlencode 'timestamp=20210103123456' \\ \ data urlencode 'txid=bmritest0102201607291027025291' \\ \ data urlencode 'merchanttoken=b4171e8228be7a75d19ad29b509e76d5fc70a4c000ef87bc55cf0cda72767e72' \\ \ data urlencode 'cardno=n9auywvp0cgk7m9sjajbwf43/6mfi6xzlnqzljsimvdnaeq56p6m6ckhyrdcl14e5tczlrwqzso6pvcpn/wgppmwwk+r0byopuyh/fwnjy+obwwlroefe7lpoxawosuzxw+qpwmat7vqxzndeis19dq/e28pcgfted0xdqabdtq=' \\ \ data urlencode 'cardexpyymm=q6ye2qcjxrjuq+3kyctersf1npu58/mas4rp7qthllefx9fdfdyp3snj/qkrzatatqbdsm3tcy5ith29ygpgn9ymb1k19ztugtiu9n9nflquiw+cttv4z0ykwfxzntbj3ymgchmangiadi9/durl5plnpval9ags5xn3ffoy8ru=' \\ \ data urlencode 'cardcvv=fpxq8fdw1y0tbfmdtaoluxqteh7i3rzqyy6+0g+wopykthm5crtq+d7cyesvlirsvcjbzm4lgtnbfwp5rvahkopqiqmazrf0cql1uuquywfa+ngwobg3depybxwdpifmtwove7jd3zfp4b0ik23ha46b0bdvri1zqiz+x7nwzke=' \\ \ data urlencode 'cardholdernm=jy6lrwsw+o9815dx8jacpvvijx1wi0qiovnbieogwewmkzzd92n8vvdi3rwxflu2hqtfk0w6ibglnaprovl5upr3/o4gy0p3u8rjkieunh1qgjp7fo69ndvv6gtwo1ehjs0cmsibvnyublbq72bttkvkqzpaugqhvquwbwaw6hs=' \\ \ data urlencode 'recurringtoken=' \\ \ data urlencode 'publickey=0caa334154789c7b07eda32db6e450acce722dde2c3cb0582eba2fe855e67a4d' \\ \ data urlencode 'encrypted=1' \\ \ data urlencode 'preauthtoken=' \\ \ data urlencode 'clickpayno=' \\ \ data urlencode 'datafield3=' \\ \ data urlencode 'clickpaytoken=' \\ \ data urlencode 'callbackurl=https //dev nicepay co id/ionpay client/paymentresult jsp?order id=bmritest0102201607291027025291' response parameter sample response