InovaPayment API Documentation.
\nThe InovaPayment API is a service used to integrate features in InovaPayment with partners.
\nConsist of :
\nPayment
\nError Code
\nURL Production :
\n\nURL Development :
\n\nDevelopment Credentials
\nsandbox：http://merchant.demoipaynova.online/
\nusername : Demo1
pin : demo@1234
For Signature Purpose :
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"6425045","collectionId":"8eacdb0b-add5-4c58-acd4-387c1793a5d9","publishedId":"2sA3JM6gh2","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-05-10T09:36:21.000Z"},"item":[{"name":"Signature","item":[],"id":"bed53d0b-1839-4e86-90c7-1d44b80e9d47","description":"\n\nTransfer method：Use HTTPS to transmit Content-Type \"application/json; charset=utf-8\"
\n
Submit method：Submit via POST
Character Encoding：UTF-8
Signature algorithm：RSA asymmetric encryption method
Transaction amount: The default is IDR-Indonesian rupiah transaction, the unit is Indonesian rupiah, the parameter value cannot contain decimals.
\nstep1：Configure merchant public key
The iNova platform uses the RSA-1024 asymmetric encryption method, that is, when a merchant requests our API, it uses the merchant's private key to encrypt the request parameters, and the iNova platform uses the merchant's public key configured in the background to decrypt; iNova uses the platform for the API return parameters. The private key is encrypted, and the merchant uses the platform public key displayed in the merchant's backend to decrypt and verify the signature.
Key configuration path: Log in to the merchant backend > Personal Center > Key Configuration
\nGenerate signature
\n1.Assume that all data sent or received is a set M, and the parameters with non-empty parameter values in the set M are sorted from small to large according to the ASCII code of the parameter name (lexicographic order), using the format of URL key-value pairs (i.e. key1=value1&key2=value2 ...) are concatenated into string stringA.
\nPay special attention to the following important rules:
◆ Parameter name ASCII codes are sorted from small to large (lexicographic order);
◆ Parameter names are case-sensitive;
◆ When the verification call returns or actively notifies a signature, the signed parameter transmitted does not participate in the signature, and the returned sign is decrypted using the public key provided by the platform;
2.Perform RSA asymmetric encryption on the spliced stringA. For specific encryption methods, please refer to the signature example.
\nSignature Example
\nAssume that the parameters passed are as follows
\n{\n \"trans_id\" : \"202003041233\",\n \"bank_code\":\"BCA\",\n \"name_name\":\"Jack\",\n \"pay_amount\":\"10000\",\n \"expire_time\":\"2020-06-01 10:22:22\",\n \"phone\":\"6282150000001\",\n \"email\":\"luhgdh@gmail.com\"\n}\n\nstep2：Concatenate the parameter values and sort them in ASCII dictionary order as follows: stringA = “bank_code=BCA&email=luhgdh@gmail.com&expire_time=2020-06-01 10:22:22&merchant_no=20200304001 &name=linus Hsfsto&pay_amount=10000&phone=6282150000001&trans_id=2024ffab”
\nstep3：Concatenated string stringA is RSA encrypted using the merchant's private key. The final data sent is in the form of
\n{\n \"trans_id\": \"20203041233\",\n \"bank_code\": \"BCA\",\n \"name\": \"Jack\",\n \"pay_amount\": \"10000\",\n \"expire_time\": \"2020-06-01 10:22:22\",\n \"phone\": \"6282150000001\",\n \"email\": \"luhgdh@gmail.com\",\n \"sign\": \"A+JDQtzJ3J06xAZ4UNLpTOxYliO6XIcfp41aY0fDHEE6+2sHo8eWpGdEuhCcGDPuDanCUKeB71N69YYF9VBADkgRFMArQkirE0FDNuunYqFlLpx7f1w9zDb6oliHV/YGdLL48irabu07FO22euakGzBrVbpwiyzGH9cF2ZsLT2u6etE+lpgYHYt1bYqlO5psFIdC7pxjN3dfz4x26Vo3BAPIdtr9tM7AR0ov59p/dzajo1372XPcqEbxxmhC63i14Oh5K1A0SUuUE5CUMVbf6b4ON8JvgdNZ6ie0Bp2C5gGGy+9qtVkwLkYYe5CbzOkMBiZ8b3YBsJb3da5oRdBRcg==\"\n}\n\nIf it succeeds, it will return success. If it fails, it will return fail. If it fails, it will retry 3 times, with intervals of 30s, 60s and 300s.
\n","urlObject":{"protocol":"htts","path":["xx（Merchant provide）"],"host":["yourdomain","com"],"query":[],"variable":[]}},"response":[{"id":"4fae0f47-413e-462b-880e-371295dac01a","name":"Response Copy","originalRequest":{"method":"GET","header":[]},"_postman_previewlanguage":"","header":[""],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"SUCCESS"}],"_postman_id":"85787a6e-cb28-470b-9022-477aada48357"},{"name":"Payment Bank","id":"35a9e5ec-87bb-4e6d-b728-abf6c88923c9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"","description":"","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"35a9e5ec-87bb-4e6d-b728-abf6c88923c9"}],"id":"380a9892-38ea-4a3e-9ce2-fe15b17c17e8","_postman_id":"380a9892-38ea-4a3e-9ce2-fe15b17c17e8","description":""},{"name":"Credit Card API","item":[{"name":"Credit Card","id":"0fc068fd-a538-4081-aaa1-886e948e8c30","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"merchant_no\": \"20200304001\",\r\n \"phone\": \"6282150000001\",\r\n \"trans_id\": \"202003041270\",\r\n \"email\": \"ferrydemo@gmail.com\",\r\n \"currency\": \"IDR\",\r\n \"real_name\": \"Jack\",\r\n \"pay_amount\": \"10000\",\r\n \"description\": \"desc\",\r\n \"success_url\": \"http://test.com\",\r\n \"notify_url\": \"http://test.com\",\r\n \"sign\": \"trlcdAxIfHcXq3BKXIgwqUvqNd4/FV8IXoq0NQc/8lLLAg5CFSa+M7FPF1o0Cu+XJUOlbb1nEucaHk0CkbwlwnSZNX6nRk+8wrf305QWDikGldQw+ejPiBqVrqu4EGjhAFb4o36BnGVwdSARNnz8H/K8Nbal7gtkiCvp0/k4dLC99E58SxBRQmFYvFMk2rJ4PxU802sTqZd3wm5yzySCUl3AoGXS7NuJlNSHuBf8BY2BdYekzGqo8SCE5y6rxfxMORT/7SNjmynN3fgBX01vue1h5zK6g5BDj4oFGcpV3UFGAcpN9pqOJRwNLMrleLfXlHV5+XLpp4k1ewNpTnIw3w==\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base-url}}/v1/payment/card","description":"If it succeeds, it will return success. If it fails, it will return fail. If it fails, it will retry 3 times, with intervals of 30s, 60s and 300s.
\n","urlObject":{"protocol":"htts","path":["xx（Merchant provide）"],"host":["yourdomain","com"],"query":[],"variable":[]}},"response":[{"id":"e98bc597-fd7e-400f-b1ec-07cd1855ac2b","name":"Response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"htts://yourdomain.com/xx（Merchant provide）"},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Server","value":"nginx"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Fri, 10 May 2024 09:49:31 GMT"},{"key":"X-RateLimit-Limit","value":"120"},{"key":"X-RateLimit-Remaining","value":"119"}],"cookie":[],"responseTime":null,"body":"SUCCESS"}],"_postman_id":"2cf46b41-2a2f-4aee-a556-d272e9595821"}],"id":"f460aea8-fe51-4737-85e1-54e9931891f6","_postman_id":"f460aea8-fe51-4737-85e1-54e9931891f6","description":""}],"id":"f7e6d4b9-4201-478d-9e12-5a83913272ec","_postman_id":"f7e6d4b9-4201-478d-9e12-5a83913272ec","description":""},{"name":"Payout API","item":[{"name":"Disbursement","id":"9707e5bd-6673-485e-8f54-c107604593b8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"merchant_no\": \"20200304001\",\r\n \"trans_id\": \"20200304199901\",\r\n \"pay_amount\": \"100000\",\r\n \"bank_code\": \"BCA\",\r\n \"name\": \"Jack\",\r\n \"phone\": \"62815151515\",\r\n \"account_no\": \"0244121515\",\r\n \"notify_url\": \"http://test.com\",\r\n \"sign\": \"ChenjUY857b5QGH1Z+ul489gDQHyJzyoio/vfySTIPP26ZAvgTYvnVJhOzFk5pq/YLbt3T9aidT1uDSPPqHiTvTRMtXU4ppgwu2rPPp1axFZMEkds7zijq3J61jPhZHHm/HtWtYO8vWGCfG0YvUI7L9J8x9sqEShl/+kNPcQZd0TjVsKo8JR7O/Ph1HaL+p+5Attz4R8KCXP4ckc9sIZlkRj4h8Fy9u5zl2OiqVK5p6obodBVmNCl+nnSiu78s3vleY8AWTt1hiMklvsTqrxBbciy7nPKEdyUQrMz+1bzKg4El07H6+P+JzqxiefWqWvjvvPxkfBluRIpkCqhYi58g==\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base-url}}/v1/cash/transfer","description":"If it succeeds, it will return success. If it fails, it will return fail. If it fails, it will retry 3 times, with intervals of 30s, 60s and 300s.
\n","urlObject":{"protocol":"https","path":["xxxx（Merchant provide）"],"host":["yourdomain","com"],"query":[],"variable":[]}},"response":[{"id":"acd08704-3314-4322-9a50-3f11ba30aa10","name":"Response Copy 2","originalRequest":{"header":[]},"_postman_previewlanguage":"","header":[""],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"SUCCESS"}],"_postman_id":"5740e61c-d015-4dbf-b287-acfbe6d794d0"},{"name":"Disbursement Bank","id":"56d09ca5-f773-4453-8747-848325c01ee7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"","description":"","urlObject":{"query":[],"variable":[]}},"response":[],"_postman_id":"56d09ca5-f773-4453-8747-848325c01ee7"}],"id":"4d00b290-0969-443b-9bff-84ecbebbc511","_postman_id":"4d00b290-0969-443b-9bff-84ecbebbc511","description":""},{"name":"Error Code","item":[],"id":"54612fb0-2d12-4ecf-bf19-fecdad4607c2","description":"","_postman_id":"54612fb0-2d12-4ecf-bf19-fecdad4607c2"}]}