NICEPAY API
...
API GPN
Payment - API GPN
8 min
about api gpn payment {{api}} {{paymentproduct}} on {{the}} {{gpn}} method used by {{the}} {{merchant}} to receive {{payment}} from all {{bank}} own cards with {{the}} {{gpn}} logo api gpn payment {{paymentproduct}} gpn aims to activate {{the}} {{gpn}} {{paymethod}} on {{merchant}} s this step uses to integrate {{the}} {{merchant}} {{system}} with {{the}} {{nicepay}} {{system}} api endpoint /nicepay/direct/v2/payment request method post post description performs transaction regist to {{nicepay}} merchant token sha256( timestamp + imid + referenceno + amt + merchantkey ) request format application/json request parameter for gpn payment the following is a list of {{parameter}} s for perform {{payment}} {{integration}} {{process}} for {{gpn}} {{paymethod}} this {{parameter}} used through {{api}} {{testing}} platform as one of {{the}} step so {{the}} {{merchant}} {{system}} able to connect with {{nicepay}} {{service}} parameter type size description example/notes timestamp required required n 14 request timestamp ( yyyymmddhh24miss ) 20201202110197 txid required required an 30 transaction id ionpaytest01201804191202084760 cardno required required n 20 {{cc}} number 4222222222222222 cardexpyymm required required a 4 card expiry ( yymm ) 2406 cardcvv required required n 4 card cvv 123 cardholdernm required required a 50 card holder name thomas alfa edison merchanttoken required required an 255 {{merchant}} token f9d30f6c972e2b5718751bd087b178534673a91bbac845f8a24e60e8e4abbbc5 callbackurl required required ans 255 {{paymentproduct}} result url http //merchant com/callbackurl sample request for gpn payment form urlencoded timestamp "20201202110197" txid "ionpaytest01201804191202084760" merchanttoken "f9d30f6c972e2b5718751bd087b178534673a91bbac845f8a24e60e8e4abbbc5" cardno "4222222222222222" cardexpyymm "2406" cardcvv "123" cardholdernm "thomas alfa edison" callbackurl "http //merchant com/callbackurl" java request nicepay settimestamp("20201202110197"); nicepay settxid("ionpaytest01201804191202084760"); nicepay setmerchanttoken(nicepay getmerchanttoken()); nicepay setcardno("4222222222222222"); nicepay setcardexpyymm("2406"); nicepay setcardcvv("123"); nicepay setcardholdernm("thomas alfa edison"); nicepay setcallbackurl("http //merchant com/callbackurl"); // payment request nicepay payment(); callback handling for gpn payment after {{the}} {{transaction}} occurs, you will receive a {{notification}} from us compatible with {{the}} callback url you input on {{the}} {{parameter}} request on docid\ nitggsucyt5lnvyfjqndi when your callback already received callbackurl , we recommended {{the}} {{merchant}} to do {{the}} {{status}} verification using {{the}} docid\ z6mz313pnsr5weunylyta callback handling is very important to minimize {{the}} fraud act, we highly recommend {{the}} {{merchant}} to do {{the}} verification using callback handling urlcallback https //merchat co id/nicepay callback?resultcd=0000\&resultmsg=success\&txid=ionpaytest01202212141112221428\&referenceno=815123412341\&paymethod=09\&amt=10000\&transdt=20221214\&transtm=111222\&description=test+gpn\&authno=221428\&issubankcd=othr\&acqubankcd=bnin\&cardno=62210082 0590\&receiptcode=\&mitracd=\&recurringtoken=\&preauthtoken=\¤cy=idr\&goodsnm=test+transaction+nicepay\&billingnm=john+doe\&cctranstype=1\&mrefno=\&instmnttype=1\&instmntmon=1\&cardexpyymm=2612\&issubanknm=\&acqubanknm=bni\×tamp=20221214111238\&merchanttoken=e1e78e6636ca06834b1bd0ed7d21d4ebae7a1de07b22f5fc22d2ac2dd198b989 response body { "resultcd" "0000", "resultmsg" "success", "txid" "ionpaytest01202212141112221428", "referenceno" "815123412341", "paymethod" "09", "amt" "10000", "transdt" "20221214", "transtm" "111222", "description" "test gpn", "authno" "221428", "issubankcd" "othr" "acqubankcd" "bnin", "cardno" "62210082 0590", "goodsnm" "test transaction nicepay" "billingnm" "john doe", "currency" "idr", "timestamp" "20221214111238", "merchanttoken" "e1e78e6636ca06834b1bd0ed7d21d4ebae7a1de07b22f5fc22d2ac2dd198b989", "cardexpyymm" "2612", "instmntmon" "1", "instmnttype" "1", "cctranstype" "1" }