[{"data":1,"prerenderedAt":806},["ShallowReactive",2],{"navigation_docs_zh":3,"-zh-docs-taypay-1-v1-07-api-refund-create":140,"-zh-docs-taypay-1-v1-07-api-refund-create-surround":801},[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":47,"body":142,"description":794,"extension":795,"links":796,"meta":797,"navigation":798,"path":48,"seo":799,"stem":49,"__hash__":800},"docs_zh\u002Fzh\u002Fdocs\u002Ftaypay-1-v1\u002F07-api-refund-create.md",{"type":143,"value":144,"toc":790},"minimark",[145,148,172,176,180,322,325,525,528,624,627,786],[146,147,47],"h1",{"id":47},[149,150,155],"pre",{"className":151,"code":152,"language":153,"meta":154,"style":154},"language-http shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","POST \u002Fapi\u002Fpayment\u002Fopen\u002Fv1\u002Frefund\u002Fcreate\nContent-Type: application\u002Fjson\n","http","",[156,157,158,166],"code",{"__ignoreMap":154},[159,160,163],"span",{"class":161,"line":162},"line",1,[159,164,165],{},"POST \u002Fapi\u002Fpayment\u002Fopen\u002Fv1\u002Frefund\u002Fcreate\n",[159,167,169],{"class":161,"line":168},2,[159,170,171],{},"Content-Type: application\u002Fjson\n",[173,174,175],"p",{},"当前版本只支持全额退款。",[177,178,179],"h2",{"id":179},"请求参数",[181,182,183,202],"table",{},[184,185,186],"thead",{},[187,188,189,193,196,199],"tr",{},[190,191,192],"th",{},"字段",[190,194,195],{},"类型",[190,197,198],{},"必填",[190,200,201],{},"说明",[203,204,205,220,232,244,256,269,282,294,310],"tbody",{},[187,206,207,211,214,217],{},[208,209,210],"td",{},"app_id",[208,212,213],{},"string",[208,215,216],{},"是",[208,218,219],{},"商户应用 ID。",[187,221,222,225,227,229],{},[208,223,224],{},"merchant_order_no",[208,226,213],{},[208,228,216],{},[208,230,231],{},"商户订单号。",[187,233,234,237,239,241],{},[208,235,236],{},"refund_no",[208,238,213],{},[208,240,216],{},[208,242,243],{},"商户退款单号。",[187,245,246,249,251,253],{},[208,247,248],{},"amount",[208,250,213],{},[208,252,216],{},[208,254,255],{},"退款金额, 当前版本要求全额退款。",[187,257,258,261,263,266],{},[208,259,260],{},"reason",[208,262,213],{},[208,264,265],{},"否",[208,267,268],{},"退款原因。",[187,270,271,274,277,279],{},[208,272,273],{},"timestamp",[208,275,276],{},"integer",[208,278,216],{},[208,280,281],{},"秒级时间戳。",[187,283,284,287,289,291],{},[208,285,286],{},"nonce",[208,288,213],{},[208,290,216],{},[208,292,293],{},"请求随机串。",[187,295,296,299,301,303],{},[208,297,298],{},"sign_type",[208,300,213],{},[208,302,216],{},[208,304,305,306,309],{},"固定为 ",[156,307,308],{},"HMAC-SHA256","。",[187,311,312,315,317,319],{},[208,313,314],{},"sign",[208,316,213],{},[208,318,216],{},[208,320,321],{},"签名值。",[173,323,324],{},"请求示例:",[149,326,330],{"className":327,"code":328,"language":329,"meta":154,"style":154},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"app_id\": \"your_app_id\",\n  \"merchant_order_no\": \"M202605220001\",\n  \"refund_no\": \"R202605220001\",\n  \"amount\": \"99.00\",\n  \"reason\": \"用户申请退款\",\n  \"timestamp\": 1779465690,\n  \"nonce\": \"random_refund_nonce\",\n  \"sign_type\": \"HMAC-SHA256\",\n  \"sign\": \"generate_by_app_secret\"\n}\n","json",[156,331,332,338,364,384,404,424,444,461,481,500,519],{"__ignoreMap":154},[159,333,334],{"class":161,"line":162},[159,335,337],{"class":336},"sMK4o","{\n",[159,339,340,343,346,349,352,355,359,361],{"class":161,"line":168},[159,341,342],{"class":336},"  \"",[159,344,210],{"class":345},"spNyl",[159,347,348],{"class":336},"\"",[159,350,351],{"class":336},":",[159,353,354],{"class":336}," \"",[159,356,358],{"class":357},"sfazB","your_app_id",[159,360,348],{"class":336},[159,362,363],{"class":336},",\n",[159,365,367,369,371,373,375,377,380,382],{"class":161,"line":366},3,[159,368,342],{"class":336},[159,370,224],{"class":345},[159,372,348],{"class":336},[159,374,351],{"class":336},[159,376,354],{"class":336},[159,378,379],{"class":357},"M202605220001",[159,381,348],{"class":336},[159,383,363],{"class":336},[159,385,387,389,391,393,395,397,400,402],{"class":161,"line":386},4,[159,388,342],{"class":336},[159,390,236],{"class":345},[159,392,348],{"class":336},[159,394,351],{"class":336},[159,396,354],{"class":336},[159,398,399],{"class":357},"R202605220001",[159,401,348],{"class":336},[159,403,363],{"class":336},[159,405,407,409,411,413,415,417,420,422],{"class":161,"line":406},5,[159,408,342],{"class":336},[159,410,248],{"class":345},[159,412,348],{"class":336},[159,414,351],{"class":336},[159,416,354],{"class":336},[159,418,419],{"class":357},"99.00",[159,421,348],{"class":336},[159,423,363],{"class":336},[159,425,427,429,431,433,435,437,440,442],{"class":161,"line":426},6,[159,428,342],{"class":336},[159,430,260],{"class":345},[159,432,348],{"class":336},[159,434,351],{"class":336},[159,436,354],{"class":336},[159,438,439],{"class":357},"用户申请退款",[159,441,348],{"class":336},[159,443,363],{"class":336},[159,445,447,449,451,453,455,459],{"class":161,"line":446},7,[159,448,342],{"class":336},[159,450,273],{"class":345},[159,452,348],{"class":336},[159,454,351],{"class":336},[159,456,458],{"class":457},"sbssI"," 1779465690",[159,460,363],{"class":336},[159,462,464,466,468,470,472,474,477,479],{"class":161,"line":463},8,[159,465,342],{"class":336},[159,467,286],{"class":345},[159,469,348],{"class":336},[159,471,351],{"class":336},[159,473,354],{"class":336},[159,475,476],{"class":357},"random_refund_nonce",[159,478,348],{"class":336},[159,480,363],{"class":336},[159,482,484,486,488,490,492,494,496,498],{"class":161,"line":483},9,[159,485,342],{"class":336},[159,487,298],{"class":345},[159,489,348],{"class":336},[159,491,351],{"class":336},[159,493,354],{"class":336},[159,495,308],{"class":357},[159,497,348],{"class":336},[159,499,363],{"class":336},[159,501,503,505,507,509,511,513,516],{"class":161,"line":502},10,[159,504,342],{"class":336},[159,506,314],{"class":345},[159,508,348],{"class":336},[159,510,351],{"class":336},[159,512,354],{"class":336},[159,514,515],{"class":357},"generate_by_app_secret",[159,517,518],{"class":336},"\"\n",[159,520,522],{"class":161,"line":521},11,[159,523,524],{"class":336},"}\n",[177,526,527],{"id":527},"响应参数",[181,529,530,540],{},[184,531,532],{},[187,533,534,536,538],{},[190,535,192],{},[190,537,195],{},[190,539,201],{},[203,541,542,555,565,576,585,595,604,614],{},[187,543,544,546,548],{},[208,545,156],{},[208,547,276],{},[208,549,550,551,554],{},"业务响应码, ",[156,552,553],{},"0"," 表示成功。",[187,556,557,560,562],{},[208,558,559],{},"message",[208,561,213],{},[208,563,564],{},"响应说明。",[187,566,567,570,573],{},[208,568,569],{},"data",[208,571,572],{},"object",[208,574,575],{},"退款结果。",[187,577,578,581,583],{},[208,579,580],{},"data.refund_no",[208,582,213],{},[208,584,243],{},[187,586,587,590,592],{},[208,588,589],{},"data.platform_order_no",[208,591,213],{},[208,593,594],{},"平台订单号。",[187,596,597,600,602],{},[208,598,599],{},"data.merchant_order_no",[208,601,213],{},[208,603,231],{},[187,605,606,609,611],{},[208,607,608],{},"data.amount",[208,610,213],{},[208,612,613],{},"退款金额。",[187,615,616,619,621],{},[208,617,618],{},"data.status",[208,620,213],{},[208,622,623],{},"退款状态。",[173,625,626],{},"响应示例:",[149,628,630],{"className":327,"code":629,"language":329,"meta":154,"style":154},"{\n  \"code\": 0,\n  \"message\": \"success\",\n  \"data\": {\n    \"refund_no\": \"R202605220001\",\n    \"platform_order_no\": \"EP202605220001\",\n    \"merchant_order_no\": \"M202605220001\",\n    \"amount\": \"99.00\",\n    \"status\": \"processing\"\n  }\n}\n",[156,631,632,636,651,670,683,703,723,741,759,777,782],{"__ignoreMap":154},[159,633,634],{"class":161,"line":162},[159,635,337],{"class":336},[159,637,638,640,642,644,646,649],{"class":161,"line":168},[159,639,342],{"class":336},[159,641,156],{"class":345},[159,643,348],{"class":336},[159,645,351],{"class":336},[159,647,648],{"class":457}," 0",[159,650,363],{"class":336},[159,652,653,655,657,659,661,663,666,668],{"class":161,"line":366},[159,654,342],{"class":336},[159,656,559],{"class":345},[159,658,348],{"class":336},[159,660,351],{"class":336},[159,662,354],{"class":336},[159,664,665],{"class":357},"success",[159,667,348],{"class":336},[159,669,363],{"class":336},[159,671,672,674,676,678,680],{"class":161,"line":386},[159,673,342],{"class":336},[159,675,569],{"class":345},[159,677,348],{"class":336},[159,679,351],{"class":336},[159,681,682],{"class":336}," {\n",[159,684,685,688,691,693,695,697,699,701],{"class":161,"line":406},[159,686,687],{"class":336},"    \"",[159,689,236],{"class":690},"sBMFI",[159,692,348],{"class":336},[159,694,351],{"class":336},[159,696,354],{"class":336},[159,698,399],{"class":357},[159,700,348],{"class":336},[159,702,363],{"class":336},[159,704,705,707,710,712,714,716,719,721],{"class":161,"line":426},[159,706,687],{"class":336},[159,708,709],{"class":690},"platform_order_no",[159,711,348],{"class":336},[159,713,351],{"class":336},[159,715,354],{"class":336},[159,717,718],{"class":357},"EP202605220001",[159,720,348],{"class":336},[159,722,363],{"class":336},[159,724,725,727,729,731,733,735,737,739],{"class":161,"line":446},[159,726,687],{"class":336},[159,728,224],{"class":690},[159,730,348],{"class":336},[159,732,351],{"class":336},[159,734,354],{"class":336},[159,736,379],{"class":357},[159,738,348],{"class":336},[159,740,363],{"class":336},[159,742,743,745,747,749,751,753,755,757],{"class":161,"line":463},[159,744,687],{"class":336},[159,746,248],{"class":690},[159,748,348],{"class":336},[159,750,351],{"class":336},[159,752,354],{"class":336},[159,754,419],{"class":357},[159,756,348],{"class":336},[159,758,363],{"class":336},[159,760,761,763,766,768,770,772,775],{"class":161,"line":483},[159,762,687],{"class":336},[159,764,765],{"class":690},"status",[159,767,348],{"class":336},[159,769,351],{"class":336},[159,771,354],{"class":336},[159,773,774],{"class":357},"processing",[159,776,518],{"class":336},[159,778,779],{"class":161,"line":502},[159,780,781],{"class":336},"  }\n",[159,783,784],{"class":161,"line":521},[159,785,524],{"class":336},[787,788,789],"style",{},"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);}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 pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":154,"searchDepth":168,"depth":168,"links":791},[792,793],{"id":179,"depth":168,"text":179},{"id":527,"depth":168,"text":527},"Taypay v1 发起退款接口说明与示例。","md",null,{},true,{"title":47,"description":794},"hFubw6HQmucdYMMGJDto67MELI7OAb6DEkFosX5SVdw",[802,804],{"title":43,"path":44,"stem":45,"description":803,"children":-1},"Taypay v1 关闭订单接口说明与示例。",{"title":51,"path":52,"stem":53,"description":805,"children":-1},"Taypay v1 支付通知回调格式和处理要求。",1781853834365]