{"id":426,"date":"2022-03-30T17:13:08","date_gmt":"2022-03-30T09:13:08","guid":{"rendered":"https:\/\/sit-open-doc.jkos.app\/?docs=%e7%b7%9a%e4%b8%8a%e6%94%af%e4%bb%98onlinepay\/api%e5%88%97%e8%a1%a8\/%e8%a8%82%e5%96%ae%e5%89%b5%e5%bb%ba-api"},"modified":"2026-02-06T16:47:38","modified_gmt":"2026-02-06T08:47:38","slug":"%e8%a8%82%e5%96%ae%e5%89%b5%e5%bb%ba-api","status":"publish","type":"docs","link":"https:\/\/open-doc.jkos.com\/?docs=%e7%b7%9a%e4%b8%8a%e6%94%af%e4%bb%98onlinepay\/api%e5%88%97%e8%a1%a8\/%e8%a8%82%e5%96%ae%e5%89%b5%e5%bb%ba-api","title":{"rendered":"\u8a02\u55ae\u5275\u5efa Entry API"},"content":{"rendered":"\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p><strong>Method\uff1aPOST<\/strong><br><strong>Domain\uff1a<\/strong><br><em><code>https:\/\/[HOST]\/platform\/entry<\/code><\/em><\/p>\n\n\n\n<p><strong>\u8aaa\u660e\uff1a<\/strong><br>\u96fb\u5546\u5e73\u53f0\u547c\u53eb\u6b64 API \u53d6\u5f97\u8857\u53e3\u4ed8\u6b3e payment_url\uff0c\u96fb\u5546\u5e73\u53f0\u4ea4\u6613\u5e8f\u865f<br>\u70ba\u552f\u4e00\u503c\u4e0d\u53ef\u91cd\u8907\uff1b\u7576\u8a02\u55ae\u4ed8\u6b3e\u672a\u5b8c\u6210\u524d\uff0c\u91cd\u8907\u547c\u53eb\u6b64 API \u6703\u56de\u8986<br>\u540c\u4e00\u8857\u53e3\u4ed8\u6b3e\u7db2\u5740\u3002<\/p>\n<cite>Online merchant platform calls this API to obtain JKOPAY payment_url. Online merchant platform order ID is unique and cannot be repeated. Before a payment is completed, the same payment URL is returned every time this API is called.<\/cite><\/blockquote>\n\n\n\n<h2 class=\"wp-block-heading\">\u6574\u5408\u6d41\u7a0b (Integration Workflow)<\/h2>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"764\" src=\"https:\/\/open-doc.jkos.com\/wp-content\/uploads\/2022\/07\/EntryAPI-2-1024x764.png\" alt=\"\" class=\"wp-image-847\" style=\"width:840px;height:626px\" srcset=\"https:\/\/open-doc.jkos.com\/wp-content\/uploads\/2022\/07\/EntryAPI-2-1024x764.png 1024w, https:\/\/open-doc.jkos.com\/wp-content\/uploads\/2022\/07\/EntryAPI-2-300x224.png 300w, https:\/\/open-doc.jkos.com\/wp-content\/uploads\/2022\/07\/EntryAPI-2-768x573.png 768w, https:\/\/open-doc.jkos.com\/wp-content\/uploads\/2022\/07\/EntryAPI-2-1536x1146.png 1536w, https:\/\/open-doc.jkos.com\/wp-content\/uploads\/2022\/07\/EntryAPI-2-2048x1528.png 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"wp-element-caption\">User Payment Workflow<\/figcaption><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"743\" src=\"https:\/\/open-doc.jkos.com\/wp-content\/uploads\/2022\/07\/PC-1-1024x743.png\" alt=\"\" class=\"wp-image-872\" style=\"width:840px;height:609px\" srcset=\"https:\/\/open-doc.jkos.com\/wp-content\/uploads\/2022\/07\/PC-1-1024x743.png 1024w, https:\/\/open-doc.jkos.com\/wp-content\/uploads\/2022\/07\/PC-1-300x218.png 300w, https:\/\/open-doc.jkos.com\/wp-content\/uploads\/2022\/07\/PC-1-768x558.png 768w, https:\/\/open-doc.jkos.com\/wp-content\/uploads\/2022\/07\/PC-1-1536x1115.png 1536w, https:\/\/open-doc.jkos.com\/wp-content\/uploads\/2022\/07\/PC-1.png 1686w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"wp-element-caption\">PC or Tablet<\/figcaption><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"746\" src=\"https:\/\/open-doc.jkos.com\/wp-content\/uploads\/2022\/07\/Mobile-1-1024x746.png\" alt=\"\" class=\"wp-image-874\" srcset=\"https:\/\/open-doc.jkos.com\/wp-content\/uploads\/2022\/07\/Mobile-1-1024x746.png 1024w, https:\/\/open-doc.jkos.com\/wp-content\/uploads\/2022\/07\/Mobile-1-300x219.png 300w, https:\/\/open-doc.jkos.com\/wp-content\/uploads\/2022\/07\/Mobile-1-768x560.png 768w, https:\/\/open-doc.jkos.com\/wp-content\/uploads\/2022\/07\/Mobile-1-1536x1119.png 1536w, https:\/\/open-doc.jkos.com\/wp-content\/uploads\/2022\/07\/Mobile-1.png 1680w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"wp-element-caption\">Mobile device<\/figcaption><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">\u8acb\u6c42\u53c3\u6578 (Request Parameter)<\/h2>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><thead><tr><th><strong>\u53c3\u6578\u540d\u7a31<\/strong><br>Parameter<\/th><th><strong>\u8cc7\u6599\u578b\u614b<\/strong><br>Data Type<\/th><th><strong>\u6700\u5927\u9577\u5ea6<\/strong><br>Maximum<\/th><th><strong>\u5fc5\u8981<\/strong>\u7684<br>Required<\/th><th><strong>\u8aaa\u660e<\/strong><\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>platform_order_id<\/td><td>string<\/td><td>60<\/td><td>Y<\/td><td>\u96fb\u5546\u5e73\u53f0\u7aef\u4ea4\u6613\u5e8f\u865f<br><strong>\u9700\u70ba\u552f\u4e00\u503c\uff0c\u4e0d\u53ef\u91cd\u8907\u3002<\/strong><\/td><td>The ID of the order is saved on the platform.<br><strong>This ID needs to be unique and unrepeated.<\/strong><\/td><\/tr><tr><td>store_id<\/td><td>string<\/td><td>36<\/td><td>Y<\/td><td>\u5546\u5e97\u7de8\u865f<br>\u8acb\u4f9d\u8857\u53e3\u63d0\u4f9b\u7684\u6e2c\u8a66\/\u6b63\u5f0f\u5546\u5e97<br>\u4ee3\u78bc\u66f4\u65b0\u3002<\/td><td>Store ID. Please update according to the test and production environment ID provided by JKOPAY.<\/td><\/tr><tr><td>currency<\/td><td>string<\/td><td>3<\/td><td>Y<\/td><td>\u4ed8\u6b3e\u8ca8\u5e63[ISO 4217]\uff0c\u8acb\u5e36\u5165<br>&#8220;TWD&#8221;\u3001&#8221;JPY&#8221; \u6216 &#8220;USD&#8221;\u3002<\/td><td>Platform\u2019s order currency [ISO 4217]. Please use &#8220;TWD&#8221;, &#8220;JPY&#8221; or &#8220;USD&#8221;.<\/td><\/tr><tr><td>total_price<\/td><td>decimal<\/td><td>20,0<\/td><td>Y<\/td><td>\u8a02\u55ae\u539f\u59cb\u91d1\u984d\u3002(\u91d1\u984d\u5fc5\u9808\u9001\u5927\u65bc0\u5143)<\/td><td>Original price with order currency.<\/td><\/tr><tr><td>final_price<\/td><td>decimal<\/td><td>20,0<\/td><td>Y<\/td><td>\u8a02\u55ae\u5be6\u969b\u6d88\u8cbb\u91d1\u984d\u3002(\u91d1\u984d\u5fc5\u9808\u9001\u5927\u65bc0\u5143)<\/td><td>Final price with order currency.<\/td><\/tr><tr><td>unredeem<\/td><td>decimal<\/td><td>20,0<\/td><td>N<\/td><td>\u4e0d\u53ef\u6298\u62b5\u91d1\u984d\u3002<\/td><td>Unredeemed amount(Consumer can\u2019t pay in JKO coins &amp; JKO ticket).<\/td><\/tr><tr><td>valid_time<\/td><td>string<\/td><td>19<\/td><td>N<\/td><td>\u8a02\u55ae\u6709\u6548\u671f\u9650\uff0c\u4f9d UTC+8 \u6642<br>\u5340\u3002<br><strong>\u683c\u5f0f : yyyy-MM-dd HH:mm:ss<\/strong><\/td><td><strong>Valid time of order in UTC+8 time zone. <\/strong>User can only complete the transaction within the time limitation.<br>Format : yyyy-MM-dd HH:mm:ss<\/td><\/tr><tr><td>confirm_url<\/td><td>string<\/td><td>500<\/td><td>N<\/td><td>\u7531\u5546\u5bb6\u5be6\u4f5c\u6b64callback URL<br>(\u5fc5\u9808 https )\u3002<br>\u8cb7\u5bb6\u5728\u8857\u53e3\u78ba\u8a8d\u4ed8\u6b3e\u9801\u9762\u8f38\u5165<br>\u5bc6\u78bc\u5f8c\uff0c\u8857\u53e3\u670d\u52d9\u5668\u8a2a\u554f\u6b64\u96fb<br>\u5546\u5e73\u53f0\u670d\u52d9\u5668\u7db2\u5740\u78ba\u8a8d\u8a02\u55ae\u6b63<br>\u78ba\u6027\u8207\u5b58\u8ca8\u5f48\u6027\u3002<\/td><td>Optional for platform to implement the callback URL.<br>After user enters passcode inside JKOPAY app\u2019s payment page, JKOPAY server will access platform\u2019s server URL to confirm the order accuracy and inventory availability.<\/td><\/tr><tr><td>result_url<\/td><td>string<\/td><td>500<\/td><td>Y<\/td><td>\u7531\u96fb\u5546\u5e73\u53f0\u5be6\u4f5c\u6b64callback URL<br>( \u5fc5\u9808 https )\u3002<br>\u6d88\u8cbb\u8005\u4ed8\u6b3e\u5b8c\u6210\u5f8c\uff0c\u8857\u53e3\u670d\u52d9<br>\u5668\u8a2a\u554f\u6b64\u96fb\u5546\u5e73\u53f0\u670d\u52d9\u5668\u7db2<br>\u5740\uff0c\u4e26\u5728\u53c3\u6578\u4e2d\u63d0\u4f9b\u8857\u53e3\u4ea4\u6613<br>\u5e8f\u865f\u8207\u8a02\u55ae\u4ea4\u6613\u72c0\u614b\u4ee3\u78bc\u3002<\/td><td>When user completes a payment, JKOPAY server will callback platform\u2019s server URL and provide JKOPAY transaction record<\/td><\/tr><tr><td>result_display_url<\/td><td>string<\/td><td>500&nbsp;<\/td><td>Y<\/td><td>\u7531\u96fb\u5546\u5e73\u53f0\u5be6\u4f5c\u6b64\u5ba2\u6236\u7aef( \u53ef\u4ee5\u662f http\/https<br>url )\u3002<br>\u6d88\u8cbb\u8005\u4ed8\u6b3e\u5b8c\u6210\u5f8c\u9ede\u9078\u5b8c\u6210\u6309<br>\u9215\uff0c\u5c07\u6d88\u8cbb\u8005\u5c0e\u5411\u6b64\u96fb\u5546\u5e73\u53f0<br>\u5ba2\u6236\u7aef\u4ed8\u6b3e\u7d50\u679c\u9801\u7db2\u5740\u3002<\/td><td>For platform to implement client side http\/https URL.<br>When User selects the \u2018complete\u2019 button in app after completing payment, JKOPAY app will direct user to online platform\u2019s client side web page where the payment result is displayed.<\/td><\/tr><tr><td>payment_type<\/td><td>string<\/td><td><\/td><td>N<\/td><td>\u4ed8\u6b3e\u6a21\u5f0f : \u201conetime\u201d\u70ba\u4e00\u6b21\u6027<br>\u4ed8\u6b3e\uff0c\u201dregular\u201d\u70ba\u5b9a\u671f\u5b9a\u984d\u4ed8<br>\u6b3e\uff1b\u9810\u8a2d\u70ba\u4e00\u6b21\u6027\u4ed8\u6b3e\u3002<\/td><td><\/td><\/tr><tr><td>escrow<\/td><td>bool<\/td><td><\/td><td>N&nbsp;<\/td><td>\u662f\u5426\u652f\u6301\u50f9\u91d1\u4fdd\u7ba1\uff0c\u9810\u8a2d\u70ba<br>false \u4e0d\u652f\u6301\u3002<\/td><td><\/td><\/tr><tr><td>products fields<\/td><td><\/td><td><\/td><td><\/td><td>\u652f\u63f4 JSON\/string \u683c\u5f0f\uff0c\u9663\u5217<br>\u5e36\u5165\u4ee5\u4e0b\u8cc7\u8a0a\u3002<br>\u7576\u4f7f\u7528 products \u6b04\u4f4d\u6642\uff0c\u9664<br>\u4e86 products.img \u5176\u9918\u7686\u70ba\u5fc5\u8981<br>\u6b04\u4f4d\u3002<\/td><td>Supports JSON\/string format; use product array to insert these attributes. Necessary attributes for currency exchange declaration.<\/td><\/tr><tr><td>products.name<\/td><td>string<\/td><td>60<\/td><td>N<\/td><td>\u5546\u54c1\u540d\u7a31\uff08charset=utf-8\uff09<\/td><td>Product name(charset=utf-8)<\/td><\/tr><tr><td>products.img<\/td><td>string<\/td><td>500<\/td><td>N<\/td><td>\u5546\u54c1\u7db2\u5740<\/td><td>Product\u2019s image URL.<\/td><\/tr><tr><td>products.unit_count<\/td><td>int<\/td><td><\/td><td>N<\/td><td>\u5546\u54c1\u6578\u91cf<\/td><td>Quantity of product.<\/td><\/tr><tr><td>products.unit_price<\/td><td>decimal<\/td><td>20,0<\/td><td>N<\/td><td>\u5546\u54c1\u55ae\u50f9\uff08\u539f\u50f9\uff09<\/td><td>Original price with order currency per unit.<\/td><\/tr><tr><td>products.unit_final_price<\/td><td>decimal<\/td><td>20,0<\/td><td>N<\/td><td>\u5546\u54c1\u55ae\u50f9\uff08\u4ed8\u6b3e\u50f9\u683c\uff09<\/td><td>Final price with order currency per unit.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">\u7bc4\u4f8b (Example)\uff1a<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code lang=\"\" class=\" line-numbers\">POST https:\/\/[HOST]\/platform\/entry<br><br>Content-Type: application\/json<br>api-key: c775e7b757ede630cd0aa1113bd102661ab38829ca52a6422ab782862f268646<br>digest: fd9f2e875a9a3baa1daf082fd137b8ae81d7b483f6a701a5aeb1c843cea30c68<br><br>{<br>  \"platform_order_id\": \"kt12345\",<br>  \"store_id\": \"d7120db2-8c76-4124-bf08-02e5b775d8fe\",<br>  \"currency\": \"TWD\",<br>  \"total_price\": 1000,<br>  \"final_price\": 1000,<br>  \"result_url\": \"https:\/\/webhook.site\/callback_result_url\",<br>  \"result_display_url\": \"https:\/\/platform.site\/redirect_result_display_url\",<br>  \"payment_type\": \"onetime\",<br>  \"escrow\": false<br>}<\/code><\/pre>\n\n\n\n<p><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\u8fd4\u56de\u53c3\u6578 (Response JSON Body)<\/h2>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><thead><tr><th><strong>\u53c3\u6578\u540d\u7a31<\/strong><br>Parameter<\/th><th><strong>\u8cc7\u6599\u578b\u614b<\/strong><br>Data Type<\/th><th><strong>\u8aaa\u660e<\/strong><\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>result<\/td><td>string<\/td><td>\u8acb\u53c3\u7167 API \u56de\u8986\u4ee3\u78bc\uff08ResponseCode\uff09\u3002<\/td><td>Please refer to API response code (ResponseCode).<\/td><\/tr><tr><td>message<\/td><td>string<\/td><td>\u7d50\u679c\u8a0a\u606f\u6216\u5931\u6557\u7406\u7531\u3002<\/td><td>Result message or reason of error.<\/td><\/tr><tr><td>result_object fields<\/td><td><\/td><td><\/td><td><\/td><\/tr><tr><td>result_object.payment_url<\/td><td>string<\/td><td>\u4ed8\u6b3e\u5c0e\u5411\u7db2\u5740\uff0c\u8857\u53e3 Server \u5224\u65b7 :<br>&#8211; \u96fb\u8166\u6216\u5e73\u677f\u7db2\u9801\u4ea4\u6613\u74b0\u5883\uff0c\u63d0\u4f9b\u8857\u53e3\u4ed8\u6b3eQRCode\u5c0e\u5411\u7db2\u5740\u3002<a href=\"https:\/\/open-doc.jkos.com\/?docs=%e7%b7%9a%e4%b8%8a%e6%94%af%e4%bb%98onlinepay\/%e4%b8%b2%e6%8e%a5%e8%aa%aa%e6%98%8e\/web-%e9%96%8b%e7%99%bc-onlinepay\">Web \u4e32\u63a5\u8aaa\u660e<\/a><br>&#8211; \u884c\u52d5\u88dd\u7f6e\u652f\u4ed8\u74b0\u5883\uff0c\u5f9e\u6d88\u8cbb\u8005\u624b\u6a5f\u91cd\u65b0\u5c0e\u5411\u5230\u8857\u53e3App\u4ed8\u6b3e\u9801\u9762\u3002<a href=\"https:\/\/open-doc.jkos.com\/?docs=%e7%b7%9a%e4%b8%8a%e6%94%af%e4%bb%98onlinepay\/%e4%b8%b2%e6%8e%a5%e8%aa%aa%e6%98%8e\/app-%e4%b8%b2%e6%8e%a5-onlinepay\">App \u4e32\u63a5\u8aaa\u660e<\/a><br>\u5b57\u4e32\u9577\u5ea6\u6703\u8d85\u904e 255<\/td><td>Payment direct URL, JKOPAY Server determines :<br> &#8211; Personal computer or notebook device payment environment, will provide JKOPAY payment QRCode web URL.<br> &#8211; Mobile device payment environment and direct users to JKOPAY app\u2019s payment interface. length of &#8220;payment_url&#8221; might exceed 255.<\/td><\/tr><tr><td>result_object.qr_img<\/td><td>string<\/td><td>QRCode \u5716\u6a94\uff0c\u96fb\u5546\u5e73\u53f0\u53ef\u5c07 QRCode \u5d4c\u5165\u4ed8\u6b3e\u7db2\u9801\u3002<br>\u5b57\u4e32\u9577\u5ea6\u6703\u8d85\u904e 255<\/td><td>QRCode image &#8211; online merchant platform may integrate QRCode image into his own payment flow according to web page type.<br>length of &#8220;qr_img&#8221; might exceed 255.<\/td><\/tr><tr><td>result_object.qr_timeout<\/td><td>timestamp<\/td><td>QRCode\/payment_url \u5931\u6548\u6642\u9593\u3002\u56de\u8986\u7684 payment_url \u8207<br>QRCode \u53ef\u5728 20 \u5206\u9418\u5167\u4f7f\u7528\uff0c\u53ea\u8981\u5728 valid_time \u671f\u9650\u524d<br>\u90fd\u53ef\u4f7f\u7528\u540c\u7b46 platform_order_id \u8acb\u6c42 entry API \u66f4\u65b0<br>QRCode\/payment_url \u6642\u9650\u3002<\/td><td>QRCode\/payment_url timeout time\u3002<br>The returned payment_url and QRCode is valid within 20 minutes. Before valid_time expires, the same platform_order_id can be used to request entry API again to extend QRCode\/payment_url timeout duration another 20 minutes.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">\u7bc4\u4f8b (Example)\uff1a<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code lang=\"\" class=\" line-numbers\">{<br>  \"result\": \"000\",<br>  \"message\": null,<br>  \"result_object\": {<br>    \"payment_url\": \"https:\/\/test-onlinepay.jkopay.app\/web\/paymentRouter?j=OL%231%3aENT%23T3BRemJsOGtSUXJRUHNNcU5lUlVIdz09%3aS%23d0d91fae-bfe8-11ee-bdc1-f8f21e0d1b98%3aA%235844%3aCUR%23TWD%3aSRC%23REDIRECT_MWEB%3aUNRDM%230.00%3aFX%230%3aTA%235844%3aTCUR%23TWD%3aFXR%231.00%3aUR%231%3aD%23D&amp;s=b7d944b8b5b9b85934fb2ce5d989559810c9199a295230483204639106b183b0\",<br>    \"qr_img\": \"https:\/\/test-onlinepay.jkopay.app\/external\/qr?j=OL%231%3aENT%23T3BRemJsOGtSUXJRUHNNcU5lUlVIdz09%3aS%23d0d91fae-bfe8-11ee-bdc1-f8f21e0d1b98%3aA%235844%3aCUR%23TWD%3aSRC%23REDIRECT_MWEB%3aUNRDM%230.00%3aFX%230%3aTA%235844%3aTCUR%23TWD%3aFXR%231.00%3aUR%231%3aD%23D&amp;s=b7d944b8b5b9b85934fb2ce5d989559810c9199a295230483204639106b183b0\",<br>    \"qr_timeout\": 1528447912<br>  }<br>}<\/code><\/pre>\n\n\n\n<div style=\"height:100px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>confirm_url \u5be6\u4f5c\u898f\u683c<\/strong><\/h2>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p><strong>Method\uff1aPOST<\/strong><\/p>\n\n\n\n<p><strong>\u8aaa\u660e\uff1a\u975e\u5fc5\u8981\u96fb\u5546\u5e73\u53f0\u5be6\u4f5c\u529f\u80fd\uff1b\u70ba\u78ba\u4fdd\u4ed8\u6b3e\u6642\u8a02\u55ae\u6b63\u78ba\u6027\u8207\u4ed8\u6b3e\u5f48\u6027\uff0c\u5728\u57f7\u884c\u4ed8\u6b3e\u6d41\u7a0b\u524d\uff0c\u8857\u53e3 Server callback \u6b64\u96fb\u5546\u5e73\u53f0 Server url \u78ba\u8a8d\u8a02\u55ae\uff0c\u56de\u8986\u6b63\u78ba\u5f8c\u624d\u6703\u57f7\u884c\u4ed8\u6b3e\u6d41\u7a0b\u3002<\/strong><\/p>\n\n\n\n<p><strong>\u9023\u7dda\u898f\u5247\uff1aConnection timeout 5 \u79d2\uff0cRead timeout 10 \u79d2\uff0cRetry 3 \u6b21<\/strong><\/p>\n<cite>Optional for merchant\uff1bto ensure the accuracy of payment and flexibility of payment process, JKOPAY Server will callback online merchant platform\u2019s Server URL to confirm order before executing payment process. Payment process continues only when confirmation is received.<br><br>Connection timeout: 5 seconds<br>Read timeout: 10 seconds<br>Retry: 3 times<\/cite><\/blockquote>\n\n\n\n<p><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\u8acb\u6c42\u53c3\u6578 (Request Parameter)<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">\u7bc4\u4f8b (Example)\uff1a<\/h3>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><thead><tr><th><strong>\u53c3\u6578\u540d\u7a31<\/strong><br>Parameter<\/th><th><strong>\u8cc7\u6599\u578b\u614b<\/strong><br>Data Type<\/th><th><strong><strong>\u6700\u5927\u9577\u5ea6<\/strong><br>Maximum<\/strong><\/th><th><strong>\u5fc5\u8981<\/strong>\u7684<br>Required<\/th><th>\u8aaa\u660e<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>platform_order_id<\/td><td>string<\/td><td>60<\/td><td>Y<\/td><td>\u96fb\u5546\u5e73\u53f0\u7aef\u4ea4\u6613\u5e8f\u865f<\/td><td>Online merchant platform order ID<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<pre class=\"wp-block-code\"><code lang=\"\" class=\" line-numbers\">{<br>  \"platform_order_id\": \"kt12345\"<br>}<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">\u8fd4\u56de\u53c3\u6578 (Response JSON Body)<\/h2>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><thead><tr><th><strong><strong>\u53c3\u6578\u540d\u7a31<\/strong><br>Parameter<\/strong><\/th><th><strong><strong>\u8cc7\u6599\u578b\u614b<\/strong><br>Data Type<\/strong><\/th><th><strong>\u8aaa\u660e<\/strong><\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>valid<\/td><td>bool<\/td><td>\u56de\u8986\u8a02\u55ae\u662f\u5426\u53ef\u4ee5\u5141\u8a31\u6263\u6b3e<\/td><td>Response true(bool value) once order pass the validation.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">\u7bc4\u4f8b (Example)\uff1a<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code lang=\"\" class=\" line-numbers\">{<br>  \"valid\": true<br>}<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>result_url \u5be6\u4f5c\u898f\u683c<\/strong><\/h2>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p><strong>Method\uff1aPOST<\/strong><\/p>\n\n\n\n<p><strong>\u8aaa\u660e\uff1a<\/strong>\u96fb\u5546\u5e73\u53f0\u5be6\u4f5c\u529f\u80fd\uff1b\u7576\u4ed8\u6b3e\u6d41\u7a0b\u7d50\u675f\u4e14\u4ea4\u6613\u6210\u529f\u6642\uff0c\u8857\u53e3\u670d\u52d9\u7aef callback \u6b64\u96fb\u5546\u5e73\u53f0 Server url \u901a\u77e5\u4ea4\u6613\u7d50\u679c\u3002<\/p>\n\n\n\n<p><strong>\u9023\u7dda\u898f\u5247\uff1aConnection timeout 5 \u79d2\uff0cRead timeout 10 \u79d2\uff0c<\/strong>\u6bcf\u9593\u9694 2^\u6307\u6578\u6642\u9593(\u79d2\u6578)Retry\uff0c\u6700\u591a 12 \u6b21\uff0c\u7d04\u5728 2 \u5c0f\u6642\u5167\u5b8c\u6210\u3002\u8209\u4f8b\u8aaa\u660e callback \u5931\u6557\u5f8c\uff0c\u9593\u9694 1 \u79d2\u5f8c\u7b2c\u4e00\u6b21Retry\uff0c\u5982\u679c\u5931\u6557\u518d\u9593\u9694 2 \u79d2\u7b2c\u4e8c\u6b21 Retry\uff0c\u5982\u679c\u5931\u6557\u518d\u9593\u9694 4 \u79d2\u7b2c\u4e09\u6b21 Retry \u4f9d\u6b64\u985e\u63a8\u3002<\/p>\n<cite>When payment process is completed and transaction succeeds, JKOPAY Service will callback online merchant platform\u2019s server URL to notify transaction result.<br><br>Connection timeout: 5 seconds<br>Read timeout: 10 seconds<br>Retry 12 times. Will try again with 2^ error times as time interval.<\/cite><\/blockquote>\n\n\n\n<p><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\u8acb\u6c42\u53c3\u6578 (Request Parameter)<\/h2>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><thead><tr><th><strong><strong><strong>\u53c3\u6578\u540d\u7a31<\/strong><br>Parameter<\/strong><\/strong><\/th><th><strong><strong><strong>\u8cc7\u6599\u578b\u614b<\/strong><br>Data Type<\/strong><\/strong><\/th><th><strong><strong><strong>\u6700\u5927\u9577\u5ea6<\/strong><br>Maximum<\/strong><\/strong><\/th><th><strong>\u5fc5\u8981<\/strong>\u7684<br>Required<\/th><th>\u8aaa\u660e<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>transaction fields<\/td><td><\/td><td><\/td><td><\/td><td><\/td><td><\/td><\/tr><tr><td>transaction.platform_order_id<\/td><td>string<\/td><td>60<\/td><td>Y<\/td><td>\u96fb\u5546\u5e73\u53f0\u7aef\u4ea4\u6613\u5e8f\u865f<\/td><td>ID of order saved in the platform.<\/td><\/tr><tr><td>transaction.status<\/td><td>int<\/td><td><\/td><td>Y<\/td><td>\u8acb\u53c3\u7167 OrderStatusCode<\/td><td>Please refer to OrderStatusCode.<\/td><\/tr><tr><td>transaction.tradeNo<\/td><td>string<\/td><td>25<\/td><td>Y<\/td><td>\u8857\u53e3\u7aef\u4ea4\u6613\u5e8f\u865f<\/td><td>JKOPAY trade number.<\/td><\/tr><tr><td>transaction.trans_time<\/td><td>string<\/td><td><\/td><td>Y<\/td><td>\u4ea4\u6613\u6642\u9593<\/td><td>Time of transaction <strong>in UTC+8 time zone.<\/strong><br>Format: yyyy-MM-dd HH:mm:ss<\/td><\/tr><tr><td>transaction.currency<\/td><td>string<\/td><td>3<\/td><td>Y<\/td><td>\u4ed8\u6b3e\u8ca8\u5e63[ISO 4217]\uff0c\u8acb\u5e36\u5165<br>TWD\u3002<\/td><td>Payment currency [ISO 4217].<\/td><\/tr><tr><td>transaction.final_price<\/td><td>string<\/td><td><\/td><td>Y<\/td><td>\u8a02\u55ae\u5be6\u969b\u6d88\u8cbb\u91d1\u984d\u3002<\/td><td>Final price of order with payment currency.<\/td><\/tr><tr><td>transaction.redeem_amount<\/td><td>string<\/td><td><\/td><td>Y<\/td><td>\u6298\u62b5\u91d1\u984d=\u8857\u53e3\u5e63\u6298\u62b5+\u5b98\u65b9\u8857\u53e3<br>\u5238\u6298\u62b5+\u5e97\u5bb6\u8857\u53e3\u5238\u6298\u62b5<\/td><td>Redeemed amount(JKO coins &amp; JKO ticket).<\/td><\/tr><tr><td>transaction.debit_amount<\/td><td>string<\/td><td><\/td><td>Y<\/td><td>\u4ed8\u6b3e\u65b9\u5f0f\u6263\u6b3e\u91d1\u984d\uff08\u6298\u62b5\u5f8c\u91d1<br>\u984d\uff09<\/td><td>Payment method debit amount (after deduct JKO coins) with payment currecny.<br>(final_price = redeem_amount + debit_amount)<\/td><\/tr><tr><td>transaction.channel_type<\/td><td><\/td><td><\/td><td><\/td><td>\u652f\u4ed8\u5de5\u5177<br>&#8220;account&#8221;: \u5132\u503c\u5e33\u6236<br>&#8220;bank&#8221;: \u9280\u884c\u5e33\u6236<br>&#8220;creditcard&#8221;: \u4fe1\u7528\u5361<\/td><td>Pay tool<br>account : JKOPay account<br>bank : bank account<br>credit card<\/td><\/tr><tr><td>transaction.redeem_detail fields<\/td><td><\/td><td><\/td><td>N<\/td><td><\/td><td><\/td><\/tr><tr><td>transaction.redeem_detail.jko_coin_amount<\/td><td>decimal<\/td><td>20,0<\/td><td><\/td><td>\u8857\u53e3\u5e63\u6298\u62b5<\/td><td>JKO coin redeem amount<\/td><\/tr><tr><td>transaction.redeem_detail.official_coupon_amount<\/td><td>decimal<\/td><td>20,0<\/td><td><\/td><td>\u5b98\u65b9\u8857\u53e3\u5238\u6298\u62b5<\/td><td>Official coupon redeem amount<\/td><\/tr><tr><td>transaction.redeem_detail.store_coupon_amount<\/td><td>decimal<\/td><td>20,0<\/td><td><\/td><td>\u5e97\u5bb6\u8857\u53e3\u5238\u6298\u62b5<\/td><td>Store coupon redeem amount<\/td><\/tr><tr><td>transaction.invoice_vehicle<\/td><td>string<\/td><td><\/td><td>N<\/td><td>\u8857\u53e3\u5e33\u6236\u767c\u7968\u8f09\u5177<\/td><td><\/td><\/tr><tr><td>transaction.maskNo<\/td><td>string<\/td><td>16<\/td><td>N<\/td><td>\u4ed8\u6b3e\u5de5\u5177\u4f7f\u7528\u4fe1\u7528\u5361\u6642\u63d0\u4f9b\u5361\u865f<br>\u524d\u516d\u5f8c\u56db\u78bc<br>\u683c\u5f0f\uff1a222222******3333<\/td><td><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">\u7bc4\u4f8b (Example)\uff1a<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code lang=\"\" class=\" line-numbers\">{<br>  \"transaction\": {<br>    \"platform_order_id\": \"kt12345\",<br>    \"status\": 0,<br>    \"tradeNo\": \"J0026910118070413C4\",<br>    \"trans_time\": \"2018-07-01 12:00:00\",<br>    \"currency\": \"TWD\",<br>    \"final_price\": \"1000\",<br>    \"redeem_amount\": \"300\",<br>    \"debit_amount\": \"700\",<br>    \"channel_type\": \"bank\",<br>    \"redeem_detail\": {<br>      \"jko_coin_amount\": 200,<br>      \"official_coupon_amount\": 0,<br>      \"store_coupon_amount\": 100<br>    }<br>  }<br>}<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">HTTP Response<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">\u7bc4\u4f8b (Example)\uff1a<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code lang=\"\" class=\" line-numbers\">HTTP 200\n<\/code><\/pre>\n","protected":false},"featured_media":0,"parent":44,"menu_order":1,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[],"class_list":["post-426","docs","type-docs","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=\/wp\/v2\/docs\/426","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=\/wp\/v2\/types\/docs"}],"replies":[{"embeddable":true,"href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=426"}],"version-history":[{"count":50,"href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=\/wp\/v2\/docs\/426\/revisions"}],"predecessor-version":[{"id":1694,"href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=\/wp\/v2\/docs\/426\/revisions\/1694"}],"up":[{"embeddable":true,"href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=\/wp\/v2\/docs\/44"}],"next":[{"title":"\u8a02\u55ae\u9000\u6b3e Refund API","link":"https:\/\/open-doc.jkos.com\/?docs=%e7%b7%9a%e4%b8%8a%e6%94%af%e4%bb%98onlinepay\/api%e5%88%97%e8%a1%a8\/%e9%80%80%e6%ac%be-api","href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=\/wp\/v2\/docs\/427"}],"prev":[{"title":"\u4ee3\u78bc\u610f\u7fa9 API Response Code","link":"https:\/\/open-doc.jkos.com\/?docs=%e7%b7%9a%e4%b8%8a%e6%94%af%e4%bb%98onlinepay\/api%e5%88%97%e8%a1%a8\/%e4%bb%a3%e7%a2%bc%e6%84%8f%e7%be%a9","href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=\/wp\/v2\/docs\/466"}],"wp:attachment":[{"href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=426"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_tag&post=426"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}