{"id":833,"date":"2022-07-04T18:43:58","date_gmt":"2022-07-04T10:43:58","guid":{"rendered":"https:\/\/open-doc.jkos.com\/?docs=%e6%8e%88%e6%ac%8a%e6%89%a3%e6%ac%be-authorized-payment\/api%e5%88%97%e8%a1%a8-api-lists\/%e4%bb%a3%e7%a2%bc%e6%84%8f%e7%be%a9-api-response-code"},"modified":"2026-02-06T16:59:07","modified_gmt":"2026-02-06T08:59:07","slug":"%e4%bb%a3%e7%a2%bc%e6%84%8f%e7%be%a9-api-response-code","status":"publish","type":"docs","link":"https:\/\/open-doc.jkos.com\/?docs=%e6%8e%88%e6%ac%8a%e6%89%a3%e6%ac%be-authorized-payment\/api%e5%88%97%e8%a1%a8-api-lists\/%e4%bb%a3%e7%a2%bc%e6%84%8f%e7%be%a9-api-response-code","title":{"rendered":"\u4ee3\u78bc\u610f\u7fa9 API Response Code"},"content":{"rendered":"\n

\ud83d\udccb \u91cd\u8981\u8aaa\u660e\uff1a\u6b04\u4f4d\u5927\u5c0f\u5beb\u5dee\u7570<\/h2>\n\n\n\n
API \u985e\u578b<\/strong><\/th>result \u6b04\u4f4d<\/strong><\/th>message \u6b04\u4f4d<\/strong><\/th>result_object \u6b04\u4f4d<\/strong><\/th>Result Code \u985e\u578b<\/strong><\/th><\/tr>
Platform APIs<\/strong><\/td>result<\/code> (\u5c0f\u5beb)<\/td>message<\/code> (\u5c0f\u5beb)<\/td>result_object<\/code> (\u5c0f\u5beb)<\/td>\u5b57\u4e32 (“000”, “999”)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Platform APIs<\/h2>\n\n\n\n

\u91cd\u8981: <\/strong>\u6240\u6709 Platform APIs \u4f7f\u7528\u4ee5\u4e0b Response \u683c\u5f0f\uff1a(\u5c0f\u5beb\u6b04\u4f4d: result, message, result_object)<\/p>\n\n\n\n

{\n  \"result\": \"string\",\n  \"message\": \"string or null\",\n  \"result_object\": object or null\n}\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
1.1 POST \/platform\/authpay\/limited<\/h3>\n\n\n\n
\u529f\u80fd\uff1a<\/strong>\u6388\u6b0a\u7d81\u5b9a (Authorization Binding)<\/p>\n\n\n\n
\u6240\u6709\u53ef\u80fd\u7684 Response\uff1a<\/strong><\/p>\n\n\n\n
result<\/th>message<\/th>result_object<\/th>\u89f8\u767c\u689d\u4ef6<\/th><\/tr><\/thead>
\"000\"<\/code><\/td>null<\/code><\/td>{auth_no, authpay_url, qr_img, qr_timeout}<\/code><\/td>\u6210\u529f\u5efa\u7acb\u6388\u6b0a\u7d81\u5b9a\u9023\u7d50<\/td><\/tr>
\"200\"<\/code><\/td>\"Bad request\"<\/code><\/td>null<\/code><\/td>BadParams (\u53c3\u6578\u932f\u8aa4)<\/td><\/tr>
\"201\"<\/code><\/td>\"Validation error\"<\/code><\/td>null<\/code><\/td>\u9a57\u8b49\u932f\u8aa4<\/td><\/tr>
\"999\"<\/code><\/td>\"Internal Error\"<\/code><\/td>null<\/code><\/td>\u8857\u53e3\u65b9\u7cfb\u7d71\u51fa\u73fe\u975e\u9810\u671f\u932f\u8aa4<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\u6210\u529f result_object \u7d50\u69cb\uff1a<\/strong><\/p>\n\n\n\n
{
  \"auth_no\": \"650660555924205568\",
  \"authpay_url\": \"https:\/\/test.jkopay.com\/web\/authpay\/url?j=...\",
  \"qr_img\": \"https:\/\/test.jkopay.com\/web\/authpay\/qr?j=...\",
  \"qr_timeout\": 1635297229729
}
<\/code><\/pre>\n\n\n\n
\n\n\n\n
1.2 POST \/platform\/authpay\/transaction<\/h3>\n\n\n\n
\u529f\u80fd\uff1a<\/strong>\u6388\u6b0a\u6263\u6b3e\u8acb\u6c42 (Merchant Platform Authorization Request)<\/p>\n\n\n\n
\u6240\u6709\u53ef\u80fd\u7684 Response\uff1a<\/strong><\/p>\n\n\n\n
result<\/th>message<\/th>result_object<\/th>\u89f8\u767c\u689d\u4ef6<\/th><\/tr><\/thead>
\"000\"<\/code><\/td>null<\/code><\/td>Transaction \u7269\u4ef6<\/code><\/td>\u6263\u6b3e\u6210\u529f<\/td><\/tr>
\"100\"<\/code><\/td>\"Order does not exist\"<\/code><\/td>null<\/code><\/td>\u8a02\u55ae\u4e0d\u5b58\u5728<\/td><\/tr>
\"101\"<\/code><\/td>\"Order has been paid\"<\/code><\/td>null<\/code><\/td>\u8a02\u55ae\u5df2\u4ed8\u6b3e<\/td><\/tr>
\"104\"<\/code><\/td>\"Payment\/transfer amount is over the monthly limit\"<\/code><\/td>null<\/code><\/td>\u4ed8\u6b3e\/\u8f49\u5e33\u91d1\u984d\u8d85\u904e\u6708\u9650\u984d<\/td><\/tr>
\"110\"<\/code><\/td>\"Store not found\"<\/code><\/td>null<\/code><\/td>\u67e5\u7121\u6b64\u5546\u5e97<\/td><\/tr>
\"115\"<\/code><\/td>\"Payment failed\"<\/code><\/td>null<\/code><\/td>\u4ed8\u6b3e\u5931\u6557<\/td><\/tr>
\"200\"<\/code><\/td>\"Bad request\"<\/code><\/td>null<\/code><\/td>BadParams (\u53c3\u6578\u932f\u8aa4)<\/td><\/tr>
\"201\"<\/code><\/td>\"Validation error\"<\/code><\/td>null<\/code><\/td>\u9a57\u8b49\u932f\u8aa4<\/td><\/tr>
\"301\"<\/code><\/td>\"Invalid auth_no\"<\/code><\/td>null<\/code><\/td>\u7121\u6548\u7684\u6388\u6b0a\u7de8\u865f<\/td><\/tr>
\"302\"<\/code><\/td>\"Canceled auth_no\"<\/code><\/td>null<\/code><\/td>\u6388\u6b0a\u7de8\u865f\u5df2\u53d6\u6d88<\/td><\/tr>
\"303\"<\/code><\/td>\"FinalPrice exceeded the max amount quota set by the user\"<\/code><\/td>null<\/code><\/td>\u6700\u7d42\u91d1\u984d\u8d85\u904e\u7528\u6236\u8a2d\u5b9a\u7684\u6700\u9ad8\u984d\u5ea6<\/td><\/tr>
\"304\"<\/code><\/td>\"Order finalPrice is not consistent with authpay billing amount\"<\/code><\/td>null<\/code><\/td>\u8a02\u55ae\u6700\u7d42\u91d1\u984d\u8207\u6388\u6b0a\u6263\u6b3e\u5e33\u55ae\u91d1\u984d\u4e0d\u4e00\u81f4<\/td><\/tr>
\"305\"<\/code><\/td>\"Authpay payment exceeds current billing cycle times\"<\/code><\/td>null<\/code><\/td>\u6388\u6b0a\u6263\u6b3e\u8d85\u904e\u7576\u524d\u8a08\u8cbb\u9031\u671f\u6b21\u6578<\/td><\/tr>
\"306\"<\/code><\/td>\"Authpay payment transaction time invalid.(Available at 08:00 - 20:00 UTC+8)\"<\/code><\/td>null<\/code><\/td>\u6388\u6b0a\u6263\u6b3e\u4ea4\u6613\u6642\u9593\u7121\u6548\uff08\u50c5\u9650 08:00 – 20:00 UTC+8\uff09<\/td><\/tr>
\"307\"<\/code><\/td>\"Payment with the same auth_no is allowed one at a time\"<\/code><\/td>null<\/code><\/td>\u540c\u4e00\u6388\u6b0a\u7de8\u865f\u540c\u6642\u50c5\u5141\u8a31\u4e00\u7b46\u4ed8\u6b3e<\/td><\/tr>
\"999\"<\/code><\/td>\"Internal Error\"<\/code><\/td>null<\/code><\/td>\u8857\u53e3\u65b9\u7cfb\u7d71\u51fa\u73fe\u975e\u9810\u671f\u932f\u8aa4<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\u6210\u529f result_object \u7d50\u69cb\uff1a<\/strong><\/p>\n\n\n\n
{\n  \"platform_order_id\": \"test-roy-010\",\n  \"status\": 0,\n  \"tradeNo\": \"J000384112110270000E\",\n  \"trans_time\": \"2021-10-27 09:04:51\",\n  \"currency\": \"TWD\",\n  \"final_price\": \"50\",\n  \"redeem_amount\": \"0\",\n  \"redeem_detail\": {\n    \"jko_coin_amount\": 0,\n    \"official_coupon_amount\": 0,\n    \"store_coupon_amount\": 0\n  },\n  \"debit_amount\": \"50\",\n  \"refund_history\": [],\n  \"invoice_vehicle\": \"\/9-99+99\",\n  \"maskNo\": null,\n  \"channel_type\": \"account\"\n}\n<\/code><\/pre>\n\n\n\n
\u5931\u6557 Response \u7bc4\u4f8b\uff1a<\/strong><\/p>\n\n\n\n
{\n  \"result\": \"121\",\n  \"message\": \"Insufficient bank account balance.\",\n  \"result_object\": null\n}\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
1.3 POST \/platform\/authpay\/refund<\/h3>\n\n\n\n
\u529f\u80fd\uff1a<\/strong>\u8a02\u55ae\u9000\u6b3e (Order Refund)<\/p>\n\n\n\n
\u6240\u6709\u53ef\u80fd\u7684 Response\uff1a<\/strong><\/p>\n\n\n\n
result<\/th>message<\/th>result_object<\/th>\u89f8\u767c\u689d\u4ef6<\/th><\/tr><\/thead>
\"000\"<\/code><\/td>null<\/code><\/td>\u9000\u6b3e\u8cc7\u8a0a\u7269\u4ef6<\/code><\/td>\u6210\u529f\u5efa\u7acb\u9000\u6b3e<\/td><\/tr>
\"100\"<\/code><\/td>\"Order does not exist\"<\/code><\/td>null<\/code><\/td>\u8a02\u55ae\u4e0d\u5b58\u5728<\/td><\/tr>
\"103\"<\/code><\/td>\"Error in refund amount\"<\/code><\/td>null<\/code><\/td>\u9000\u6b3e\u91d1\u984d\u932f\u8aa4<\/td><\/tr>
\"105\"<\/code><\/td>\"Inconsistent refund amount\"<\/code><\/td>null<\/code><\/td>\u9000\u6b3e\u91d1\u984d\u4e0d\u4e00\u81f4<\/td><\/tr>
\"113\"<\/code><\/td>\"Refund reject due to refund amount exceeds total unreimbursed amount.\"<\/code><\/td>null<\/code><\/td>\u9000\u6b3e\u91d1\u984d\u8d85\u904e\u53ef\u9000\u6b3e\u7e3d\u984d<\/td><\/tr>
\"116\"<\/code><\/td>\"JKOPAY coupon reimbursement failed, please contact JKOPAY for assistance in refund\"<\/code><\/td>null<\/code><\/td>\u9000\u6b3e\u5931\u6557 (Coupon)\uff0c\u8acb\u806f\u7e6b\u8857\u53e3\u5354\u52a9\u9000\u6b3e<\/td><\/tr>
\"200\"<\/code><\/td>\"Bad request\"<\/code><\/td>null<\/code><\/td>BadParams (\u53c3\u6578\u932f\u8aa4)<\/td><\/tr>
\"201\"<\/code><\/td>\"Validation error\"<\/code><\/td>null<\/code><\/td>\u9a57\u8b49\u932f\u8aa4<\/td><\/tr>
\"999\"<\/code><\/td>\"Internal Error\"<\/code><\/td>null<\/code><\/td>\u8857\u53e3\u65b9\u7cfb\u7d71\u51fa\u73fe\u975e\u9810\u671f\u932f\u8aa4<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\u6210\u529f result_object \u7d50\u69cb\uff1a<\/strong><\/p>\n\n\n\n
{\n  \"refund_tradeNo\": \"K0026910118070413C4001\",\n  \"debit_amount\": 70,\n  \"redeem_amount\": 30,\n  \"redeem_detail\": {\n    \"jko_coin_amount\": 20,\n    \"official_coupon_amount\": 0,\n    \"store_coupon_amount\": 10\n  },\n  \"refund_time\": \"2018-07-01 12:20:20\"\n}\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
1.4 GET \/platform\/authpay\/inquiry<\/h3>\n\n\n\n
\u529f\u80fd\uff1a<\/strong>\u8a02\u55ae\u67e5\u8a62 (Inquiry)<\/p>\n\n\n\n
\u6240\u6709\u53ef\u80fd\u7684 Response\uff1a<\/strong><\/p>\n\n\n\n
result<\/th>message<\/th>result_object<\/th>\u89f8\u767c\u689d\u4ef6<\/th><\/tr><\/thead>
\"000\"<\/code><\/td>null<\/code><\/td>{transactions: [...]}<\/code><\/td>\u6210\u529f\u67e5\u8a62 (\u542b\u6240\u6709\u8a02\u55ae\u72c0\u614b)<\/td><\/tr>
\"200\"<\/code><\/td>\"Bad request\"<\/code><\/td>null<\/code><\/td>BadParams (\u53c3\u6578\u932f\u8aa4)<\/td><\/tr>
\"201\"<\/code><\/td>\"Validation error\"<\/code><\/td>null<\/code><\/td>\u9a57\u8b49\u932f\u8aa4<\/td><\/tr>
\"999\"<\/code><\/td>\"Internal Error\"<\/code><\/td>null<\/code><\/td>\u8857\u53e3\u65b9\u7cfb\u7d71\u51fa\u73fe\u975e\u9810\u671f\u932f\u8aa4<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
transactions \u9663\u5217\u4e2d\u6bcf\u7b46\u8a02\u55ae\u7684 status\uff1a<\/strong><\/p>\n\n\n\n
    \n
  • 0<\/code> – \u4ea4\u6613\u6210\u529f (transaction success)<\/li>\n\n\n\n
  • 100<\/code> – \u4ed8\u6b3e\u5931\u6557 (payment fail)<\/li>\n\n\n\n
  • 101<\/code> – \u8a02\u55ae\u5c1a\u672a\u4ed8\u6b3e (order has not been paid)<\/li>\n\n\n\n
  • 102<\/code> – \u8a02\u55ae\u7de8\u865f\u4e0d\u5b58\u5728 (order number does not exist)<\/li>\n<\/ul>\n\n\n\n
    result_object \u7d50\u69cb\uff1a<\/strong><\/p>\n\n\n\n
    {\n  \"transactions\": [\n    {\n      \"platform_order_id\": \"87\",\n      \"status\": 0,\n      \"tradeNo\": \"J0026910118070413C4\",\n      \"trans_time\": \"2018-07-01 12:00:00\",\n      \"currency\": \"TWD\",\n      \"final_price\": 1000,\n      \"redeem_amount\": 300,\n      \"debit_amount\": 700,\n      \"redeem_detail\": {\n        \"jko_coin_amount\": 200,\n        \"official_coupon_amount\": 0,\n        \"store_coupon_amount\": 100\n      },\n      \"refund_history\": [\n        {\n          \"platform_order_id\": \"87\",\n          \"refund_order_id\": \"87001\",\n          \"refund_tradeNo\": \"K0026910118070413C4001\",\n          \"time\": \"2018-07-01 12:20:20\",\n          \"amount\": 100,\n          \"debit_amount\": 70,\n          \"redeem_amount\": 30,\n          \"redeem_detail\": {\n            \"jko_coin_amount\": 20,\n            \"official_coupon_amount\": 0,\n            \"store_coupon_amount\": 10\n          }\n        }\n      ]\n    },\n    {\n      \"platform_order_id\": \"88\",\n      \"status\": 101\n    }\n  ]\n}\n<\/code><\/pre>\n\n\n\n
    \n\n\n\n
    1.5 GET \/platform\/authpay\/detail<\/h3>\n\n\n\n
    \u529f\u80fd\uff1a<\/strong>\u67e5\u8a62\u6388\u6b0a\u72c0\u614b (Inquiry on Authorization Status)<\/p>\n\n\n\n
    \u6240\u6709\u53ef\u80fd\u7684 Response\uff1a<\/strong><\/p>\n\n\n\n
    result<\/th>message<\/th>result_object<\/th>\u89f8\u767c\u689d\u4ef6<\/th><\/tr><\/thead>
    \"000\"<\/code><\/td>null<\/code><\/td>{authpay: GrantedAuthPay}<\/td>\u6210\u529f\u67e5\u8a62\u6388\u6b0a\u72c0\u614b<\/td><\/tr>
    \"200\"<\/code><\/td>\"Bad request\"<\/code><\/td>null<\/code><\/td>BadParams (\u53c3\u6578\u932f\u8aa4)<\/td><\/tr>
    \"201\"<\/code><\/td>\"Validation error\"<\/code><\/td>null<\/code><\/td>\u9a57\u8b49\u932f\u8aa4<\/td><\/tr>
    \"301\"<\/code><\/td>\"Invalid auth_no\"<\/code><\/td>null<\/code><\/td>\u7121\u6548\u7684\u6388\u6b0a\u7de8\u865f<\/td><\/tr>
    \"999\"<\/code><\/td>\"Internal Error\"<\/code><\/td>null<\/code><\/td>\u8857\u53e3\u65b9\u7cfb\u7d71\u51fa\u73fe\u975e\u9810\u671f\u932f\u8aa4<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    result_object \u7d50\u69cb\uff1a<\/strong><\/p>\n\n\n\n
    {\n  \"authpay\": {\n    \"type\": \"limited\",\n    \"auth_no\": \"599669611989962752\",\n    \"status\": \"cancel\",\n    \"platform_authpay_id\": \"AUTHPAY_001\"\n  }\n}\n<\/code><\/pre>\n\n\n\n
    \n\n\n\n
    1.6 POST \/platform\/authpay\/cancel<\/h3>\n\n\n\n
    \u529f\u80fd\uff1a<\/strong>\u53d6\u6d88\u6388\u6b0a\u7d81\u5b9a (Cancellation on Authorization)<\/p>\n\n\n\n
    \u6240\u6709\u53ef\u80fd\u7684 Response\uff1a<\/strong><\/p>\n\n\n\n
    result<\/th>message<\/th>result_object<\/th>\u89f8\u767c\u689d\u4ef6<\/th><\/tr><\/thead>
    \"000\"<\/code><\/td>null<\/code><\/td>null<\/code><\/td>\u6210\u529f\u53d6\u6d88\u6388\u6b0a\u7d81\u5b9a<\/td><\/tr>
    \"200\"<\/code><\/td>\"Bad request\"<\/code><\/td>null<\/code><\/td>BadParams (\u53c3\u6578\u932f\u8aa4)<\/td><\/tr>
    \"201\"<\/code><\/td>\"Validation error\"<\/code><\/td>null<\/code><\/td>\u9a57\u8b49\u932f\u8aa4<\/td><\/tr>
    \"301\"<\/code><\/td>\"Invalid auth_no\"<\/code><\/td>null<\/code><\/td>\u7121\u6548\u7684\u6388\u6b0a\u7de8\u865f<\/td><\/tr>
    \"302\"<\/code><\/td>\"Canceled auth_no\"<\/code><\/td>null<\/code><\/td>\u6388\u6b0a\u7de8\u865f\u5df2\u53d6\u6d88\uff08\u91cd\u8907\u53d6\u6d88\uff09<\/td><\/tr>
    \"999\"<\/code><\/td>\"Internal Error\"<\/code><\/td>null<\/code><\/td>\u8857\u53e3\u65b9\u7cfb\u7d71\u51fa\u73fe\u975e\u9810\u671f\u932f\u8aa4<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    \u6210\u529f Response \u7bc4\u4f8b\uff1a<\/strong><\/p>\n\n\n\n
    {\n  \"result\": \"000\",\n  \"message\": null,\n  \"result_object\": null\n}<\/code><\/pre>\n","protected":false},"featured_media":0,"parent":756,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[],"class_list":["post-833","docs","type-docs","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=\/wp\/v2\/docs\/833","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=833"}],"version-history":[{"count":12,"href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=\/wp\/v2\/docs\/833\/revisions"}],"predecessor-version":[{"id":1701,"href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=\/wp\/v2\/docs\/833\/revisions\/1701"}],"up":[{"embeddable":true,"href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=\/wp\/v2\/docs\/756"}],"next":[{"title":"\u6388\u6b0a\u7d42\u6b62 Cancellation on Authorization","link":"https:\/\/open-doc.jkos.com\/?docs=%e6%8e%88%e6%ac%8a%e6%89%a3%e6%ac%be-authorized-payment\/api%e5%88%97%e8%a1%a8-api-lists\/%e6%8e%88%e6%ac%8a%e7%b5%82%e6%ad%a2-cancellation-on-authorization","href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=\/wp\/v2\/docs\/808"}],"wp:attachment":[{"href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=833"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_tag&post=833"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}