[{"data":1,"prerenderedAt":707},["ShallowReactive",2],{"navigation_docs_zh":3,"-zh-docs-taypay-1-v1-08-notification":140,"-zh-docs-taypay-1-v1-08-notification-surround":702},[4,15,58,90],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":6},"快速开始",false,"\u002Fzh\u002Fdocs\u002Fgetting-started","zh\u002Fdocs\u002F1.getting-started",[10],{"title":11,"path":12,"stem":13,"icon":14},"开始使用","\u002Fzh\u002Fdocs\u002Fgetting-started\u002Finstallation","zh\u002Fdocs\u002F1.getting-started\u002F1.installation","i-lucide-download",{"title":16,"icon":6,"path":17,"stem":18,"children":19},"Taypay v1","\u002Fzh\u002Fdocs\u002Ftaypay-1-v1","zh\u002Fdocs\u002Ftaypay-1-v1\u002Findex",[20,22,26,30,34,38,42,46,50,54],{"title":21,"path":17,"stem":18},"标准开放 API",{"title":23,"path":24,"stem":25},"认证参数","\u002Fzh\u002Fdocs\u002Ftaypay-1-v1\u002F01-authentication","zh\u002Fdocs\u002Ftaypay-1-v1\u002F01-authentication",{"title":27,"path":28,"stem":29},"签名规则","\u002Fzh\u002Fdocs\u002Ftaypay-1-v1\u002F02-signature","zh\u002Fdocs\u002Ftaypay-1-v1\u002F02-signature",{"title":31,"path":32,"stem":33},"接口说明","\u002Fzh\u002Fdocs\u002Ftaypay-1-v1\u002F03-order-apis","zh\u002Fdocs\u002Ftaypay-1-v1\u002F03-order-apis",{"title":35,"path":36,"stem":37},"创建订单接口","\u002Fzh\u002Fdocs\u002Ftaypay-1-v1\u002F04-api-order-create","zh\u002Fdocs\u002Ftaypay-1-v1\u002F04-api-order-create",{"title":39,"path":40,"stem":41},"查询订单接口","\u002Fzh\u002Fdocs\u002Ftaypay-1-v1\u002F05-api-order-query","zh\u002Fdocs\u002Ftaypay-1-v1\u002F05-api-order-query",{"title":43,"path":44,"stem":45},"关闭订单接口","\u002Fzh\u002Fdocs\u002Ftaypay-1-v1\u002F06-api-order-close","zh\u002Fdocs\u002Ftaypay-1-v1\u002F06-api-order-close",{"title":47,"path":48,"stem":49},"发起退款接口","\u002Fzh\u002Fdocs\u002Ftaypay-1-v1\u002F07-api-refund-create","zh\u002Fdocs\u002Ftaypay-1-v1\u002F07-api-refund-create",{"title":51,"path":52,"stem":53},"支付通知","\u002Fzh\u002Fdocs\u002Ftaypay-1-v1\u002F08-notification","zh\u002Fdocs\u002Ftaypay-1-v1\u002F08-notification",{"title":55,"path":56,"stem":57},"托管收银台与订单状态","\u002Fzh\u002Fdocs\u002Ftaypay-1-v1\u002F09-checkout-status","zh\u002Fdocs\u002Ftaypay-1-v1\u002F09-checkout-status",{"title":59,"icon":6,"path":60,"stem":61,"children":62},"Taypay Epay","\u002Fzh\u002Fdocs\u002Ftaypay-2-epay","zh\u002Fdocs\u002Ftaypay-2-epay\u002Findex",[63,65,68,71,74,78,82,86],{"title":64,"path":60,"stem":61},"易支付兼容 API",{"title":27,"path":66,"stem":67},"\u002Fzh\u002Fdocs\u002Ftaypay-2-epay\u002F01-signature","zh\u002Fdocs\u002Ftaypay-2-epay\u002F01-signature",{"title":31,"path":69,"stem":70},"\u002Fzh\u002Fdocs\u002Ftaypay-2-epay\u002F02-order-apis","zh\u002Fdocs\u002Ftaypay-2-epay\u002F02-order-apis",{"title":35,"path":72,"stem":73},"\u002Fzh\u002Fdocs\u002Ftaypay-2-epay\u002F03-api-mapi","zh\u002Fdocs\u002Ftaypay-2-epay\u002F03-api-mapi",{"title":75,"path":76,"stem":77},"创建订单接口(跳转)","\u002Fzh\u002Fdocs\u002Ftaypay-2-epay\u002F04-api-submit","zh\u002Fdocs\u002Ftaypay-2-epay\u002F04-api-submit",{"title":79,"path":80,"stem":81},"订单查询接口","\u002Fzh\u002Fdocs\u002Ftaypay-2-epay\u002F05-api-order-query","zh\u002Fdocs\u002Ftaypay-2-epay\u002F05-api-order-query",{"title":83,"path":84,"stem":85},"订单退款接口","\u002Fzh\u002Fdocs\u002Ftaypay-2-epay\u002F06-api-refund","zh\u002Fdocs\u002Ftaypay-2-epay\u002F06-api-refund",{"title":87,"path":88,"stem":89},"支付方式与字段映射","\u002Fzh\u002Fdocs\u002Ftaypay-2-epay\u002F07-mappings","zh\u002Fdocs\u002Ftaypay-2-epay\u002F07-mappings",{"title":91,"icon":6,"path":92,"stem":93,"children":94},"VToken","\u002Fzh\u002Fdocs\u002Fvtoken","zh\u002Fdocs\u002Fvtoken\u002Findex",[95,96,100,104,108,112,116,120,124,128,132,136],{"title":91,"path":92,"stem":93},{"title":97,"path":98,"stem":99},"接入 AstrBot","\u002Fzh\u002Fdocs\u002Fvtoken\u002Fastrbot","zh\u002Fdocs\u002Fvtoken\u002Fastrbot",{"title":101,"path":102,"stem":103},"接入 Claude Code","\u002Fzh\u002Fdocs\u002Fvtoken\u002Fclaude_code","zh\u002Fdocs\u002Fvtoken\u002Fclaude_code",{"title":105,"path":106,"stem":107},"接入 Crush","\u002Fzh\u002Fdocs\u002Fvtoken\u002Fcrush","zh\u002Fdocs\u002Fvtoken\u002Fcrush",{"title":109,"path":110,"stem":111},"接入 Hermes","\u002Fzh\u002Fdocs\u002Fvtoken\u002Fhermes","zh\u002Fdocs\u002Fvtoken\u002Fhermes",{"title":113,"path":114,"stem":115},"接入 Kilo Code","\u002Fzh\u002Fdocs\u002Fvtoken\u002Fkilo_code","zh\u002Fdocs\u002Fvtoken\u002Fkilo_code",{"title":117,"path":118,"stem":119},"接入 Langcli","\u002Fzh\u002Fdocs\u002Fvtoken\u002Flangcli","zh\u002Fdocs\u002Fvtoken\u002Flangcli",{"title":121,"path":122,"stem":123},"接入 nanobot","\u002Fzh\u002Fdocs\u002Fvtoken\u002Fnanobot","zh\u002Fdocs\u002Fvtoken\u002Fnanobot",{"title":125,"path":126,"stem":127},"接入 OpenClaw","\u002Fzh\u002Fdocs\u002Fvtoken\u002Fopenclaw","zh\u002Fdocs\u002Fvtoken\u002Fopenclaw",{"title":129,"path":130,"stem":131},"接入 OpenCode","\u002Fzh\u002Fdocs\u002Fvtoken\u002Fopencode","zh\u002Fdocs\u002Fvtoken\u002Fopencode",{"title":133,"path":134,"stem":135},"接入 Reasonix","\u002Fzh\u002Fdocs\u002Fvtoken\u002Freasonix","zh\u002Fdocs\u002Fvtoken\u002Freasonix",{"title":137,"path":138,"stem":139},"接入 WorkBuddy \u002F CodeBuddy","\u002Fzh\u002Fdocs\u002Fvtoken\u002Fworkbuddy","zh\u002Fdocs\u002Fvtoken\u002Fworkbuddy",{"id":141,"title":51,"body":142,"description":695,"extension":696,"links":697,"meta":698,"navigation":699,"path":52,"seo":700,"stem":53,"__hash__":701},"docs_zh\u002Fzh\u002Fdocs\u002Ftaypay-1-v1\u002F08-notification.md",{"type":143,"value":144,"toc":691},"minimark",[145,148,161,165,356,359,390,393,403,409,412,687],[146,147,51],"h1",{"id":51},[149,150,151,152,156,157,160],"p",{},"支付完成后平台会向应用通知地址发送事件。商户必须先校验签名, 再根据 ",[153,154,155],"code",{},"merchant_order_no"," 和 ",[153,158,159],{},"platform_order_no"," 做幂等更新。",[162,163,164],"h2",{"id":164},"通知参数",[166,167,168,187],"table",{},[169,170,171],"thead",{},[172,173,174,178,181,184],"tr",{},[175,176,177],"th",{},"字段",[175,179,180],{},"类型",[175,182,183],{},"必填",[175,185,186],{},"说明",[188,189,190,205,221,233,244,255,267,279,292,304,317,329,344],"tbody",{},[172,191,192,196,199,202],{},[193,194,195],"td",{},"event_id",[193,197,198],{},"string",[193,200,201],{},"是",[193,203,204],{},"事件唯一 ID。",[172,206,207,210,212,214],{},[193,208,209],{},"event_type",[193,211,198],{},[193,213,201],{},[193,215,216,217,220],{},"事件类型, 如 ",[153,218,219],{},"payment.succeeded","。",[172,222,223,226,228,230],{},[193,224,225],{},"app_id",[193,227,198],{},[193,229,201],{},[193,231,232],{},"商户应用 ID。",[172,234,235,237,239,241],{},[193,236,155],{},[193,238,198],{},[193,240,201],{},[193,242,243],{},"商户订单号。",[172,245,246,248,250,252],{},[193,247,159],{},[193,249,198],{},[193,251,201],{},[193,253,254],{},"平台订单号。",[172,256,257,260,262,264],{},[193,258,259],{},"amount",[193,261,198],{},[193,263,201],{},[193,265,266],{},"支付金额。",[172,268,269,272,274,276],{},[193,270,271],{},"channel",[193,273,198],{},[193,275,201],{},[193,277,278],{},"支付通道。",[172,280,281,284,287,289],{},[193,282,283],{},"status",[193,285,286],{},"integer",[193,288,201],{},[193,290,291],{},"支付状态码。",[172,293,294,297,299,301],{},[193,295,296],{},"payment_status",[193,298,198],{},[193,300,201],{},[193,302,303],{},"支付状态文本。",[172,305,306,309,311,314],{},[193,307,308],{},"paid_time",[193,310,286],{},[193,312,313],{},"否",[193,315,316],{},"支付完成时间戳。",[172,318,319,322,324,326],{},[193,320,321],{},"timestamp",[193,323,286],{},[193,325,201],{},[193,327,328],{},"秒级时间戳。",[172,330,331,334,336,338],{},[193,332,333],{},"sign_type",[193,335,198],{},[193,337,201],{},[193,339,340,341,220],{},"固定为 ",[153,342,343],{},"HMAC-SHA256",[172,345,346,349,351,353],{},[193,347,348],{},"sign",[193,350,198],{},[193,352,201],{},[193,354,355],{},"签名值。",[162,357,358],{"id":358},"响应参数",[166,360,361,371],{},[169,362,363],{},[172,364,365,367,369],{},[175,366,177],{},[175,368,180],{},[175,370,186],{},[188,372,373],{},[172,374,375,378,380],{},[193,376,377],{},"body",[193,379,198],{},[193,381,382,383,386,387,389],{},"处理完成后必须返回文本 ",[153,384,385],{},"success",", 非 ",[153,388,385],{}," 会视为处理失败。",[149,391,392],{},"处理成功后返回纯文本:",[394,395,401],"pre",{"className":396,"code":398,"language":399,"meta":400},[397],"language-text","success\n","text","",[153,402,398],{"__ignoreMap":400},[149,404,405,406,408],{},"非 ",[153,407,385],{}," 或超时会被视为通知失败并进入重试流程。",[149,410,411],{},"通知示例:",[394,413,417],{"className":414,"code":415,"language":416,"meta":400,"style":400},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"event_id\": \"evt_202605220001\",\n  \"event_type\": \"payment.succeeded\",\n  \"app_id\": \"your_app_id\",\n  \"merchant_order_no\": \"M202605220001\",\n  \"platform_order_no\": \"EP202605220001\",\n  \"amount\": \"99.00\",\n  \"channel\": \"epay_alipay\",\n  \"status\": 1,\n  \"payment_status\": \"paid\",\n  \"paid_time\": 1779465700,\n  \"timestamp\": 1779465701,\n  \"sign_type\": \"HMAC-SHA256\",\n  \"sign\": \"generate_by_app_secret\"\n}\n","json",[153,418,419,428,455,474,494,514,534,554,574,591,611,627,643,662,681],{"__ignoreMap":400},[420,421,424],"span",{"class":422,"line":423},"line",1,[420,425,427],{"class":426},"sMK4o","{\n",[420,429,431,434,437,440,443,446,450,452],{"class":422,"line":430},2,[420,432,433],{"class":426},"  \"",[420,435,195],{"class":436},"spNyl",[420,438,439],{"class":426},"\"",[420,441,442],{"class":426},":",[420,444,445],{"class":426}," \"",[420,447,449],{"class":448},"sfazB","evt_202605220001",[420,451,439],{"class":426},[420,453,454],{"class":426},",\n",[420,456,458,460,462,464,466,468,470,472],{"class":422,"line":457},3,[420,459,433],{"class":426},[420,461,209],{"class":436},[420,463,439],{"class":426},[420,465,442],{"class":426},[420,467,445],{"class":426},[420,469,219],{"class":448},[420,471,439],{"class":426},[420,473,454],{"class":426},[420,475,477,479,481,483,485,487,490,492],{"class":422,"line":476},4,[420,478,433],{"class":426},[420,480,225],{"class":436},[420,482,439],{"class":426},[420,484,442],{"class":426},[420,486,445],{"class":426},[420,488,489],{"class":448},"your_app_id",[420,491,439],{"class":426},[420,493,454],{"class":426},[420,495,497,499,501,503,505,507,510,512],{"class":422,"line":496},5,[420,498,433],{"class":426},[420,500,155],{"class":436},[420,502,439],{"class":426},[420,504,442],{"class":426},[420,506,445],{"class":426},[420,508,509],{"class":448},"M202605220001",[420,511,439],{"class":426},[420,513,454],{"class":426},[420,515,517,519,521,523,525,527,530,532],{"class":422,"line":516},6,[420,518,433],{"class":426},[420,520,159],{"class":436},[420,522,439],{"class":426},[420,524,442],{"class":426},[420,526,445],{"class":426},[420,528,529],{"class":448},"EP202605220001",[420,531,439],{"class":426},[420,533,454],{"class":426},[420,535,537,539,541,543,545,547,550,552],{"class":422,"line":536},7,[420,538,433],{"class":426},[420,540,259],{"class":436},[420,542,439],{"class":426},[420,544,442],{"class":426},[420,546,445],{"class":426},[420,548,549],{"class":448},"99.00",[420,551,439],{"class":426},[420,553,454],{"class":426},[420,555,557,559,561,563,565,567,570,572],{"class":422,"line":556},8,[420,558,433],{"class":426},[420,560,271],{"class":436},[420,562,439],{"class":426},[420,564,442],{"class":426},[420,566,445],{"class":426},[420,568,569],{"class":448},"epay_alipay",[420,571,439],{"class":426},[420,573,454],{"class":426},[420,575,577,579,581,583,585,589],{"class":422,"line":576},9,[420,578,433],{"class":426},[420,580,283],{"class":436},[420,582,439],{"class":426},[420,584,442],{"class":426},[420,586,588],{"class":587},"sbssI"," 1",[420,590,454],{"class":426},[420,592,594,596,598,600,602,604,607,609],{"class":422,"line":593},10,[420,595,433],{"class":426},[420,597,296],{"class":436},[420,599,439],{"class":426},[420,601,442],{"class":426},[420,603,445],{"class":426},[420,605,606],{"class":448},"paid",[420,608,439],{"class":426},[420,610,454],{"class":426},[420,612,614,616,618,620,622,625],{"class":422,"line":613},11,[420,615,433],{"class":426},[420,617,308],{"class":436},[420,619,439],{"class":426},[420,621,442],{"class":426},[420,623,624],{"class":587}," 1779465700",[420,626,454],{"class":426},[420,628,630,632,634,636,638,641],{"class":422,"line":629},12,[420,631,433],{"class":426},[420,633,321],{"class":436},[420,635,439],{"class":426},[420,637,442],{"class":426},[420,639,640],{"class":587}," 1779465701",[420,642,454],{"class":426},[420,644,646,648,650,652,654,656,658,660],{"class":422,"line":645},13,[420,647,433],{"class":426},[420,649,333],{"class":436},[420,651,439],{"class":426},[420,653,442],{"class":426},[420,655,445],{"class":426},[420,657,343],{"class":448},[420,659,439],{"class":426},[420,661,454],{"class":426},[420,663,665,667,669,671,673,675,678],{"class":422,"line":664},14,[420,666,433],{"class":426},[420,668,348],{"class":436},[420,670,439],{"class":426},[420,672,442],{"class":426},[420,674,445],{"class":426},[420,676,677],{"class":448},"generate_by_app_secret",[420,679,680],{"class":426},"\"\n",[420,682,684],{"class":422,"line":683},15,[420,685,686],{"class":426},"}\n",[688,689,690],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":400,"searchDepth":430,"depth":430,"links":692},[693,694],{"id":164,"depth":430,"text":164},{"id":358,"depth":430,"text":358},"Taypay v1 支付通知回调格式和处理要求。","md",null,{},true,{"title":51,"description":695},"qsGsv9CcsVWvnYGNNgsLGRG7yUCu4q6U3IlIEGCfvh0",[703,705],{"title":47,"path":48,"stem":49,"description":704,"children":-1},"Taypay v1 发起退款接口说明与示例。",{"title":55,"path":56,"stem":57,"description":706,"children":-1},"Taypay v1 托管收银台跳转方式和订单状态说明。",1781853834365]