[{"data":1,"prerenderedAt":874},["ShallowReactive",2],{"navigation-en":3,"en:\u002Fwithdrawals\u002Fretrieve":193,"en:\u002Fwithdrawals\u002Fretrieve:surround":869},[4,20,51,77,95,110,133,158,172],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":6},"Getting Started",false,"\u002Fgetting-started","1.getting-started",[10,15],{"title":11,"path":12,"stem":13,"icon":14},"Portal Preparation","\u002Fgetting-started\u002Fportal-setup","1.getting-started\u002F1.portal-setup","i-lucide-rocket",{"title":16,"path":17,"stem":18,"icon":19},"Quickstart","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F2.quickstart","i-lucide-zap",{"title":21,"icon":22,"path":23,"stem":24,"children":25,"page":6},"Core Concepts","i-lucide-key-round","\u002Fconcepts","2.concepts",[26,31,36,41,46],{"title":27,"path":28,"stem":29,"icon":30},"Authentication","\u002Fconcepts\u002Fauthentication","2.concepts\u002F1.authentication","i-lucide-fingerprint",{"title":32,"path":33,"stem":34,"icon":35},"IP Allowlist","\u002Fconcepts\u002Fip-allowlist","2.concepts\u002F2.ip-allowlist","i-lucide-shield-check",{"title":37,"path":38,"stem":39,"icon":40},"Money Format","\u002Fconcepts\u002Fmoney","2.concepts\u002F3.money","i-lucide-banknote",{"title":42,"path":43,"stem":44,"icon":45},"Idempotency","\u002Fconcepts\u002Fidempotency","2.concepts\u002F4.idempotency","i-lucide-repeat",{"title":47,"path":48,"stem":49,"icon":50},"Error envelope & codes","\u002Fconcepts\u002Ferrors","2.concepts\u002F5.errors","i-lucide-octagon-alert",{"title":52,"icon":53,"path":54,"stem":55,"children":56,"page":6},"Deposits","i-lucide-arrow-down-to-line","\u002Fdeposits","3.deposits",[57,62,67,72],{"title":58,"path":59,"stem":60,"icon":61},"Deposit Overview & State Machine","\u002Fdeposits\u002Foverview","3.deposits\u002F1.overview","i-lucide-info",{"title":63,"path":64,"stem":65,"icon":66},"Create a Deposit","\u002Fdeposits\u002Fcreate","3.deposits\u002F2.create","i-lucide-plus",{"title":68,"path":69,"stem":70,"icon":71},"Get a Deposit","\u002Fdeposits\u002Fretrieve","3.deposits\u002F3.retrieve","i-lucide-search",{"title":73,"path":74,"stem":75,"icon":76},"Cancel a Deposit","\u002Fdeposits\u002Fcancel","3.deposits\u002F4.cancel","i-lucide-x",{"title":78,"icon":79,"path":80,"stem":81,"children":82,"page":6},"Withdrawals","i-lucide-arrow-up-from-line","\u002Fwithdrawals","4.withdrawals",[83,87,91],{"title":84,"path":85,"stem":86,"icon":61},"Withdrawal Overview","\u002Fwithdrawals\u002Foverview","4.withdrawals\u002F1.overview",{"title":88,"path":89,"stem":90,"icon":66},"Create a Withdrawal","\u002Fwithdrawals\u002Fcreate","4.withdrawals\u002F2.create",{"title":92,"path":93,"stem":94,"icon":71},"Get & List Withdrawals","\u002Fwithdrawals\u002Fretrieve","4.withdrawals\u002F3.retrieve",{"title":96,"icon":97,"path":98,"stem":99,"children":100,"page":6},"Balance & Banks","i-lucide-wallet","\u002Fbalance","5.balance",[101,105],{"title":102,"path":103,"stem":104,"icon":97},"Get Balance","\u002Fbalance\u002Fget-balance","5.balance\u002F1.get-balance",{"title":106,"path":107,"stem":108,"icon":109},"Bank List","\u002Fbalance\u002Fbanks","5.balance\u002F2.banks","i-lucide-landmark",{"title":111,"icon":112,"path":113,"stem":114,"children":115,"page":6},"Webhooks","i-lucide-webhook","\u002Fwebhooks","6.webhooks",[116,120,125,129],{"title":117,"path":118,"stem":119,"icon":61},"Webhook Overview","\u002Fwebhooks\u002Foverview","6.webhooks\u002F1.overview",{"title":121,"path":122,"stem":123,"icon":124},"Event Catalog & Payloads","\u002Fwebhooks\u002Fevents","6.webhooks\u002F2.events","i-lucide-list",{"title":126,"path":127,"stem":128,"icon":35},"Signature Verification","\u002Fwebhooks\u002Fsignature-verification","6.webhooks\u002F3.signature-verification",{"title":130,"path":131,"stem":132,"icon":45},"Endpoint Requirements, Retries & SSRF","\u002Fwebhooks\u002Fdelivery-and-retries","6.webhooks\u002F4.delivery-and-retries",{"title":134,"icon":135,"path":136,"stem":137,"children":138,"page":6},"Sandbox","i-lucide-flask-conical","\u002Fsandbox","7.sandbox",[139,143,148,153],{"title":140,"path":141,"stem":142,"icon":61},"Test Mode Overview","\u002Fsandbox\u002Foverview","7.sandbox\u002F1.overview",{"title":144,"path":145,"stem":146,"icon":147},"Simulate Transfer","\u002Fsandbox\u002Fsimulate-transfer","7.sandbox\u002F2.simulate-transfer","i-lucide-banknote-arrow-down",{"title":149,"path":150,"stem":151,"icon":152},"Top-up & Reset","\u002Fsandbox\u002Ftop-up-and-reset","7.sandbox\u002F3.top-up-and-reset","i-lucide-rotate-ccw",{"title":154,"path":155,"stem":156,"icon":157},"End-to-End Test Flow","\u002Fsandbox\u002Fe2e-test-flow","7.sandbox\u002F4.e2e-test-flow","i-lucide-list-checks",{"title":159,"icon":14,"path":160,"stem":161,"children":162,"page":6},"Go-live","\u002Fgo-live","8.go-live",[163,167],{"title":164,"path":165,"stem":166,"icon":157},"Go-live Checklist","\u002Fgo-live\u002Fchecklist","8.go-live\u002F1.checklist",{"title":168,"path":169,"stem":170,"icon":171},"Contact & Support","\u002Fgo-live\u002Fsupport","8.go-live\u002F2.support","i-lucide-life-buoy",{"title":173,"icon":174,"path":175,"stem":176,"children":177,"page":6},"Reference","i-lucide-book-marked","\u002Freference","9.reference",[178,183,188],{"title":179,"path":180,"stem":181,"icon":182},"Endpoint Catalog","\u002Freference\u002Fendpoints","9.reference\u002F1.endpoints","i-lucide-table",{"title":184,"path":185,"stem":186,"icon":187},"Code Samples (Node.js & PHP)","\u002Freference\u002Fcode-samples","9.reference\u002F2.code-samples","i-lucide-code",{"title":189,"path":190,"stem":191,"icon":192},"Status Values & Glossary","\u002Freference\u002Fglossary-states","9.reference\u002F3.glossary-states","i-lucide-book-a",{"id":194,"title":92,"badge":195,"body":196,"description":862,"extension":863,"links":864,"meta":865,"method":864,"navigation":866,"path":93,"seo":867,"stem":94,"__hash__":868},"docs_en\u002F4.withdrawals\u002F3.retrieve.md","GET",{"type":197,"value":198,"toc":849},"minimark",[199,210,213,220,236,241,274,278,285,451,752,769,775,778,781,799,801,805,838,845],[200,201,202,206,207],"p",{},[203,204,205],"code",{},"GET \u002Fv1\u002Fwithdrawals\u002F:id"," · ",[203,208,209],{},"GET \u002Fv1\u002Fwithdrawals",[200,211,212],{},"Read a single withdrawal request or list your own. Both are bodyless, HMAC-signed (S2S), and scoped to the calling merchant only.",[214,215,217,218],"h2",{"id":216},"get-one-get-v1withdrawalsid","Get one — ",[203,219,205],{},[200,221,222,223,227,228,231,232,235],{},"Returns a withdrawal request ",[224,225,226],"strong",{},"only for your own merchant",". If ",[203,229,230],{},"id"," is not yours \u002F not found \u002F has an invalid format → ",[203,233,234],{},"404"," (existence is not revealed).",[237,238,240],"h3",{"id":239},"example-request","Example request",[242,243,244],"code-group",{},[245,246,252],"pre",{"className":247,"code":248,"filename":249,"language":250,"meta":251,"style":251},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl \"https:\u002F\u002Fapi.unkpay.co\u002Fv1\u002Fwithdrawals\u002F3b9c1e54-2a77-4f0d-bb1e-8a6d4c2e91aa\"\n","cURL","bash","",[203,253,254],{"__ignoreMap":251},[255,256,259,263,267,271],"span",{"class":257,"line":258},"line",1,[255,260,262],{"class":261},"sBMFI","curl",[255,264,266],{"class":265},"sMK4o"," \"",[255,268,270],{"class":269},"sfazB","https:\u002F\u002Fapi.unkpay.co\u002Fv1\u002Fwithdrawals\u002F3b9c1e54-2a77-4f0d-bb1e-8a6d4c2e91aa",[255,272,273],{"class":265},"\"\n",[275,276],"placeholder-note",{"value":277},"add the S2S authentication headers (API key + HMAC signature)",[237,279,281,282],{"id":280},"response-body-200-ok","Response body — ",[203,283,284],{},"200 OK",[286,287,288,304],"table",{},[289,290,291],"thead",{},[292,293,294,298,301],"tr",{},[295,296,297],"th",{},"Field",[295,299,300],{},"Type",[295,302,303],{},"Description",[305,306,307,320,333,345,357,372,384,400,414,426,438],"tbody",{},[292,308,309,314,317],{},[310,311,312],"td",{},[203,313,230],{},[310,315,316],{},"string (uuid)",[310,318,319],{},"Withdrawal id.",[292,321,322,327,330],{},[310,323,324],{},[203,325,326],{},"amount",[310,328,329],{},"string (baht)",[310,331,332],{},"Amount the destination receives.",[292,334,335,340,342],{},[310,336,337],{},[203,338,339],{},"fee",[310,341,329],{},[310,343,344],{},"Fee.",[292,346,347,352,354],{},[310,348,349],{},[203,350,351],{},"net_payout",[310,353,329],{},[310,355,356],{},"Net amount paid to the destination.",[292,358,359,364,367],{},[310,360,361],{},[203,362,363],{},"currency",[310,365,366],{},"string",[310,368,369],{},[203,370,371],{},"\"THB\"",[292,373,374,379,381],{},[310,375,376],{},[203,377,378],{},"receiver_bank_provider",[310,380,366],{},[310,382,383],{},"Destination bank code.",[292,385,386,391,394],{},[310,387,388],{},[203,389,390],{},"destination",[310,392,393],{},"object",[310,395,396,399],{},[203,397,398],{},"{ \"bank\", \"account_no\", \"name\" }"," full plaintext.",[292,401,402,407,409],{},[310,403,404],{},[203,405,406],{},"kind",[310,408,366],{},[310,410,411],{},[203,412,413],{},"\"customer\"",[292,415,416,421,423],{},[310,417,418],{},[203,419,420],{},"reference_user_id",[310,422,366],{},[310,424,425],{},"Destination customer reference id (only if sent at create).",[292,427,428,433,435],{},[310,429,430],{},[203,431,432],{},"status",[310,434,366],{},[310,436,437],{},"Current status — `PENDING",[292,439,440,445,448],{},[310,441,442],{},[203,443,444],{},"created_at",[310,446,447],{},"string (timestamp)",[310,449,450],{},"Time the request was created.",[245,452,456],{"className":453,"code":454,"language":455,"meta":251,"style":251},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"id\": \"3b9c1e54-2a77-4f0d-bb1e-8a6d4c2e91aa\",\n  \"amount\": \"500.00\",\n  \"fee\": \"9.00\",\n  \"net_payout\": \"500.00\",\n  \"currency\": \"THB\",\n  \"receiver_bank_provider\": \"SCB\",\n  \"destination\": {\n    \"bank\": \"SCB\",\n    \"account_no\": \"1234567890\",\n    \"name\": \"สมชาย ใจดี\"\n  },\n  \"kind\": \"customer\",\n  \"reference_user_id\": \"cust-7\",\n  \"status\": \"PENDING\",\n  \"created_at\": \"2026-06-19T10:38:00Z\"\n}\n","json",[203,457,458,463,488,508,528,547,567,587,601,622,643,662,668,688,708,728,746],{"__ignoreMap":251},[255,459,460],{"class":257,"line":258},[255,461,462],{"class":265},"{\n",[255,464,466,469,472,475,478,480,483,485],{"class":257,"line":465},2,[255,467,468],{"class":265},"  \"",[255,470,230],{"class":471},"spNyl",[255,473,474],{"class":265},"\"",[255,476,477],{"class":265},":",[255,479,266],{"class":265},[255,481,482],{"class":269},"3b9c1e54-2a77-4f0d-bb1e-8a6d4c2e91aa",[255,484,474],{"class":265},[255,486,487],{"class":265},",\n",[255,489,491,493,495,497,499,501,504,506],{"class":257,"line":490},3,[255,492,468],{"class":265},[255,494,326],{"class":471},[255,496,474],{"class":265},[255,498,477],{"class":265},[255,500,266],{"class":265},[255,502,503],{"class":269},"500.00",[255,505,474],{"class":265},[255,507,487],{"class":265},[255,509,511,513,515,517,519,521,524,526],{"class":257,"line":510},4,[255,512,468],{"class":265},[255,514,339],{"class":471},[255,516,474],{"class":265},[255,518,477],{"class":265},[255,520,266],{"class":265},[255,522,523],{"class":269},"9.00",[255,525,474],{"class":265},[255,527,487],{"class":265},[255,529,531,533,535,537,539,541,543,545],{"class":257,"line":530},5,[255,532,468],{"class":265},[255,534,351],{"class":471},[255,536,474],{"class":265},[255,538,477],{"class":265},[255,540,266],{"class":265},[255,542,503],{"class":269},[255,544,474],{"class":265},[255,546,487],{"class":265},[255,548,550,552,554,556,558,560,563,565],{"class":257,"line":549},6,[255,551,468],{"class":265},[255,553,363],{"class":471},[255,555,474],{"class":265},[255,557,477],{"class":265},[255,559,266],{"class":265},[255,561,562],{"class":269},"THB",[255,564,474],{"class":265},[255,566,487],{"class":265},[255,568,570,572,574,576,578,580,583,585],{"class":257,"line":569},7,[255,571,468],{"class":265},[255,573,378],{"class":471},[255,575,474],{"class":265},[255,577,477],{"class":265},[255,579,266],{"class":265},[255,581,582],{"class":269},"SCB",[255,584,474],{"class":265},[255,586,487],{"class":265},[255,588,590,592,594,596,598],{"class":257,"line":589},8,[255,591,468],{"class":265},[255,593,390],{"class":471},[255,595,474],{"class":265},[255,597,477],{"class":265},[255,599,600],{"class":265}," {\n",[255,602,604,607,610,612,614,616,618,620],{"class":257,"line":603},9,[255,605,606],{"class":265},"    \"",[255,608,609],{"class":261},"bank",[255,611,474],{"class":265},[255,613,477],{"class":265},[255,615,266],{"class":265},[255,617,582],{"class":269},[255,619,474],{"class":265},[255,621,487],{"class":265},[255,623,625,627,630,632,634,636,639,641],{"class":257,"line":624},10,[255,626,606],{"class":265},[255,628,629],{"class":261},"account_no",[255,631,474],{"class":265},[255,633,477],{"class":265},[255,635,266],{"class":265},[255,637,638],{"class":269},"1234567890",[255,640,474],{"class":265},[255,642,487],{"class":265},[255,644,646,648,651,653,655,657,660],{"class":257,"line":645},11,[255,647,606],{"class":265},[255,649,650],{"class":261},"name",[255,652,474],{"class":265},[255,654,477],{"class":265},[255,656,266],{"class":265},[255,658,659],{"class":269},"สมชาย ใจดี",[255,661,273],{"class":265},[255,663,665],{"class":257,"line":664},12,[255,666,667],{"class":265},"  },\n",[255,669,671,673,675,677,679,681,684,686],{"class":257,"line":670},13,[255,672,468],{"class":265},[255,674,406],{"class":471},[255,676,474],{"class":265},[255,678,477],{"class":265},[255,680,266],{"class":265},[255,682,683],{"class":269},"customer",[255,685,474],{"class":265},[255,687,487],{"class":265},[255,689,691,693,695,697,699,701,704,706],{"class":257,"line":690},14,[255,692,468],{"class":265},[255,694,420],{"class":471},[255,696,474],{"class":265},[255,698,477],{"class":265},[255,700,266],{"class":265},[255,702,703],{"class":269},"cust-7",[255,705,474],{"class":265},[255,707,487],{"class":265},[255,709,711,713,715,717,719,721,724,726],{"class":257,"line":710},15,[255,712,468],{"class":265},[255,714,432],{"class":471},[255,716,474],{"class":265},[255,718,477],{"class":265},[255,720,266],{"class":265},[255,722,723],{"class":269},"PENDING",[255,725,474],{"class":265},[255,727,487],{"class":265},[255,729,731,733,735,737,739,741,744],{"class":257,"line":730},16,[255,732,468],{"class":265},[255,734,444],{"class":471},[255,736,474],{"class":265},[255,738,477],{"class":265},[255,740,266],{"class":265},[255,742,743],{"class":269},"2026-06-19T10:38:00Z",[255,745,273],{"class":265},[255,747,749],{"class":257,"line":748},17,[255,750,751],{"class":265},"}\n",[753,754,755],"note",{},[200,756,757,759,760,763,764,768],{},[203,758,420],{}," appears only if it was sent in ",[203,761,762],{},"additional.reference_user_id"," at create time. Status is the source of truth for the current state, but the terminal outcome must still be confirmed via the ",[765,766,767],"a",{"href":85},"terminal webhook",".",[214,770,772,773],{"id":771},"list-your-own-get-v1withdrawals","List your own — ",[203,774,209],{},[200,776,777],{},"Returns the list of withdrawal requests for the calling merchant only (caller-scoped). The response is an array of withdrawal objects with the same fields as the single-get above.",[237,779,240],{"id":780},"example-request-1",[242,782,783],{},[245,784,786],{"className":247,"code":785,"filename":249,"language":250,"meta":251,"style":251},"curl \"https:\u002F\u002Fapi.unkpay.co\u002Fv1\u002Fwithdrawals\"\n",[203,787,788],{"__ignoreMap":251},[255,789,790,792,794,797],{"class":257,"line":258},[255,791,262],{"class":261},[255,793,266],{"class":265},[255,795,796],{"class":269},"https:\u002F\u002Fapi.unkpay.co\u002Fv1\u002Fwithdrawals",[255,798,273],{"class":265},[275,800],{"value":277},[214,802,804],{"id":803},"errors","Errors",[286,806,807,819],{},[289,808,809],{},[292,810,811,814,816],{},[295,812,813],{},"HTTP",[295,815,203],{},[295,817,818],{},"Cause",[305,820,821],{},[292,822,823,827,832],{},[310,824,825],{},[203,826,234],{},[310,828,829],{},[203,830,831],{},"NOT_FOUND",[310,833,834,835,837],{},"(single get) ",[203,836,230],{}," is not yours \u002F not found \u002F has an invalid id format",[200,839,840,841,844],{},"See the ",[765,842,843],{"href":48},"Error Envelope & Codes"," for the cross-cutting error format.",[846,847,848],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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 .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}",{"title":251,"searchDepth":258,"depth":465,"links":850},[851,857,861],{"id":216,"depth":465,"text":852,"children":853},"Get one — GET \u002Fv1\u002Fwithdrawals\u002F:id",[854,855],{"id":239,"depth":490,"text":240},{"id":280,"depth":490,"text":856},"Response body — 200 OK",{"id":771,"depth":465,"text":858,"children":859},"List your own — GET \u002Fv1\u002Fwithdrawals",[860],{"id":780,"depth":490,"text":240},{"id":803,"depth":465,"text":804},"GET \u002Fv1\u002Fwithdrawals\u002F:id to get one (caller-scoped) and GET \u002Fv1\u002Fwithdrawals to list your own withdrawals","md",null,{},{"icon":71},{"title":92,"description":862},"_AWosrEwnNkwAK1nQM0OEDnOYvafQ6cGNA7YTdZoZWs",[870,872],{"title":88,"path":89,"stem":90,"description":871,"icon":66,"children":-1},"POST \u002Fv1\u002Fwithdrawals — create a payout request; gross (amount + fee) is debited immediately and the request starts in PENDING awaiting manual approval",{"title":102,"path":103,"stem":104,"description":873,"icon":97,"children":-1},"Check your merchant wallet balance (available + pending) before creating a withdrawal",1781891152621]