{"id":1267,"date":"2025-03-25T10:00:20","date_gmt":"2025-03-25T02:00:20","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\/%e6%8e%88%e6%ac%8a%e7%b6%81%e5%ae%9a%e7%b5%90%e6%9e%9c%e9%80%9a%e7%9f%a5-authorization-callback"},"modified":"2026-02-06T16:35:37","modified_gmt":"2026-02-06T08:35:37","slug":"%e6%8e%88%e6%ac%8a%e7%b6%81%e5%ae%9a%e7%b5%90%e6%9e%9c%e9%80%9a%e7%9f%a5-authorization-callback","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\/%e6%8e%88%e6%ac%8a%e7%b6%81%e5%ae%9a%e7%b5%90%e6%9e%9c%e9%80%9a%e7%9f%a5-authorization-callback","title":{"rendered":"\u6388\u6b0a\u7d81\u5b9a\u7d50\u679c\u901a\u77e5 Authorization CallBack"},"content":{"rendered":"\n

\u6388\u6b0a\u7d81\u5b9a\u7d50\u679c\u901a\u77e5 CallBack \u5be6\u4f5c\u898f\u683c<\/h2>\n\n\n\n
\n

Method\uff1aPOST<\/strong><\/p>\n\n\n\n

\u8aaa\u660e\uff1a<\/strong>
\u6b64\u70ba\u5e73\u53f0\u9700\u5be6\u4f5c\u7684API\u63d0\u4f9b\u7d66\u8857\u53e3callback\uff1b
\u7576\u7528\u6236\u6388\u6b0a\u6d41\u7a0b\u7d50\u675f\u4e14\u6210\u529f\u6642\uff0c\u8857\u53e3\u670d\u52d9\u7aef\u6703 callback \u6b64\u5e73\u53f0request\u63d0\u4f9b\u7684 result_url \u901a\u77e5\u6388\u6b0a\u7d50\u679c\u3002
\u8857\u53e3\u8a8d\u5b9aHTTP Status Code 200<\/em> \u70ba\u6210\u529f\uff0cHTTP Status Code 500<\/em> \u8a8d\u5b9a\u5931\u6557\u4e14\u9808Retry<\/p>\n\n\n\n

\u9023\u7dda\u898f\u5247\uff1a<\/strong>
Connection timeout\uff1a5 \u79d2
Read timeout\uff1a10 \u79d2<\/p>\n\n\n\n

Retry\u898f\u5247\uff1a<\/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<\/blockquote>\n\n\n\n

\u8acb\u6c42\u53c3\u6578 (Request Parameter)<\/h3>\n\n\n\n
\u53c3\u6578\u540d\u7a31<\/strong>
Parameter<\/strong><\/strong><\/th>		\u8cc7\u6599\u578b\u614b<\/strong>
Data Type<\/strong><\/strong><\/th>		\u6700\u5927\u9577\u5ea6<\/strong>
Maximum<\/strong><\/strong><\/th>		\u5fc5\u8981<\/strong>\u7684
Required<\/th>		\u8aaa\u660e<\/th>Description<\/th><\/tr><\/thead>
authpay<\/td>Object<\/td><\/td>Y<\/td>\u6388\u6b0a\u8cc7\u6599<\/td>Granted authpay information<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

authpay<\/h4>\n\n\n\n
\u53c3\u6578\u540d\u7a31<\/strong>
Parameter<\/strong><\/strong><\/th>		\u8cc7\u6599\u578b\u614b<\/strong>
Data Type<\/strong><\/strong><\/th>		\u6700\u5927\u9577\u5ea6<\/strong>
Maximum<\/strong><\/strong><\/th>		\u5fc5\u8981<\/strong>\u7684
Required<\/th>		\u8aaa\u660e<\/th>Description<\/th><\/tr><\/thead>
GrantedAuthPay<\/td>Object<\/td><\/td>Y<\/td>\u6388\u6b0a\u8cc7\u6599<\/td>Granted authpay information<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

GrantedAuthPay<\/h4>\n\n\n\n
\u53c3\u6578\u540d\u7a31<\/strong>
Parameter<\/th>		\u8cc7\u6599\u578b\u614b<\/strong>
Data Type<\/th>		\u6700\u5927\u9577\u5ea6<\/strong>
Maximum<\/th>		\u5fc5\u8981<\/strong>\u7684
Required<\/th>		\u8aaa\u660e<\/strong><\/th>Description<\/th><\/tr><\/thead>
type<\/td>String<\/td>30<\/td>Y<\/td>\u6388\u6b0a\u985e\u578b
regular: \u5b9a\u671f\u5b9a\u984d\u6388\u6b0a\u6263\u6b3e<\/td>		Authorization type
regular: recurring payment (fixed amount)<\/td><\/tr>
status<\/td>String<\/td>30<\/td>Y<\/td>\u6388\u6b0a\u72c0\u614b
ungranted: \u672a\u6388\u6b0a
granted: \u5df2\u6388\u6b0a
cancel: \u5df2\u53d6\u6d88<\/td>		Authorization status
ungranted: not yet authorized
granted: authorized
cancel: authorization canceled<\/td><\/tr>
auth_no<\/td>String<\/td>30<\/td>Y<\/td>\u8857\u53e3\u7aef\u6388\u6b0a\u7de8\u865f<\/td>JKOPay authorization number<\/td><\/tr>
platform_authpay_id<\/td>String<\/td>60<\/td>Y<\/td>\u5e73\u53f0\u6388\u6263\u7de8\u865f\uff08\u7559\u5b58\u7528\uff09<\/td>Merchant platform authorization number\uff08for record-keeping\uff09<\/td><\/tr>
jkos_account<\/td>String<\/td>100<\/td>Y<\/td>\u8857\u53e3\u5e33\u865f<\/td>JKOPay user\u2019s account<\/td><\/tr>
billing_currency<\/td>String<\/td><\/td>N<\/td>\u539f\u59cb\u6263\u6b3e\u5e63\u5225\uff0c\u9810\u8a2dTWD<\/td>Original currency, default= TWD<\/td><\/tr>
billing_amount<\/td>Decimal<\/td>18,0<\/td>N<\/td>\u539f\u59cb\u6263\u6b3e\u91d1\u984d<\/td>Original amount<\/td><\/tr>
billing_cycle<\/td>billing_cycle[]<\/td><\/td>\u5b9a\u671f\u5b9a\u984d: Y
\u4e0d\u5b9a\u671f\u4e0d\u5b9a\u984d: N<\/td>		\u6263\u6b3e\u9031\u671f\u8207\u6263\u6b3e\u6b21\u6578\uff08\u5b9a\u671f\u5b9a\u984d\u9069\u7528\uff09<\/td>Deduction cycle and times (For type is regular)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

billing_cycle<\/h4>\n\n\n\n

\u6ce8\uff1a\u6642\u5340\u7d71\u4e00\u70ba UTC+8\uff08Note: UTC+8 timezone\uff09<\/p>\n\n\n\n

\u53c3\u6578\u540d\u7a31<\/strong>
Parameter<\/th>		\u8cc7\u6599\u578b\u614b<\/strong>
Data Type<\/th>		\u6700\u5927\u9577\u5ea6<\/strong>
Maximum<\/th>		\u5fc5\u8981<\/strong>\u7684
Required<\/th>		\u8aaa\u660e<\/strong><\/th>Description<\/th><\/tr><\/thead>
billing_cycle.period<\/td>String<\/td><\/td>Y<\/td>\u6263\u6b3e\u9031\u671f\uff0c\u6642\u5340\u9650\u5236\u70baUTC+8\uff0c\u9650\u5e36\u5165\u4ee5\u4e0b\u5b57\u4e32(e.g.week)
week:\u9031\uff08Sun\uff5eMon\uff09
month:\u6708
quarter:\u5b63
year:\u5e74<\/td>		Deduction cycle period, timezone is UTC+8, and input the following string only (e.g.week)
week:\uff08From Sun to Mon\uff09
month
quarter
year<\/td><\/tr>
billing_cycle.times<\/td>Int<\/td><\/td>N<\/td>\u6bcf\u9031\u671f\u5167\uff0c\u6263\u6b3e\u6b21\u6578\u3002
\uff08\u9650\u5e36\u5165\u6574\u6578\uff0c\u5982\u672a\u5e36\u6b64\u53c3\u6578\uff0c\u7cfb\u7d71\u9810\u8a2d\u70ba1\u6b21\uff09
Week <= 7\u6b21
Month <= 7\u6b21
Quarter <= 7\u6b21
Year <= 12\u6b21<\/td>		The deduction time in regular period. (input Int only, default= 1\uff09
If the period is a week, then the times-limit <= 7
If the period is a month, then the times-limit <= 7
If period is a quarter, then the times-limit <= 7
If the period is a year, then the times-limit <= 12<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

\u7bc4\u4f8b (Example)\uff1a<\/h3>\n\n\n\n

\u5b9a\u671f\u5b9a\u984d callback Request\uff1a<\/h4>\n\n\n\n
{
    \"authpay\": {
      \"type\": \"regular\",
      \"auth_no\": \"591692855148417024\",
      \"status\": \"granted\",
      \"platform_authpay_id\": \"AUTHPAY_001\",
      \"jkos_account\": \"987654321\"
    }
}
<\/code><\/pre>\n\n\n\n
\u4e0d\u5b9a\u671f\u4e0d\u5b9a\u984d callback Request\uff1a<\/h4>\n\n\n\n
{
    \"authpay\": {
        \"type\": \"limited\",
        \"auth_no\": \"591692855123456789\",
        \"status\": \"granted\",
        \"platform_authpay_id\": \"AUTHPAY_002\",
        \"jkos_account\": \"987654321\"
    }
}

{
    \"authpay\": {
        \"type\": \"regular\",
        \"auth_no\": \"591692855148417024\",
        \"status\": \"granted\",
        \"platform_authpay_id\": \"AUTHPAY_001\",
        \"jkos_account\": \"987654321\"
    }
}<\/code><\/pre>\n\n\n\n
HTTP Response<\/h4>\n\n\n\n
HTTP 200
<\/code><\/pre>\n","protected":false},"featured_media":0,"parent":756,"menu_order":2,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[],"class_list":["post-1267","docs","type-docs","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=\/wp\/v2\/docs\/1267","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=1267"}],"version-history":[{"count":6,"href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=\/wp\/v2\/docs\/1267\/revisions"}],"predecessor-version":[{"id":1323,"href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=\/wp\/v2\/docs\/1267\/revisions\/1323"}],"up":[{"embeddable":true,"href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=\/wp\/v2\/docs\/756"}],"next":[{"title":"\u6388\u6b0a\u5275\u5efa Authorization Binding","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%b6%81%e5%ae%9a%e5%89%b5%e5%bb%ba-authorization-binding","href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=\/wp\/v2\/docs\/780"}],"prev":[{"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=1267"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/open-doc.jkos.com\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_tag&post=1267"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}