[{"data":1,"prerenderedAt":938},["ShallowReactive",2],{"navigation-en":3,"en:\u002Fbalance\u002Fbanks":193,"en:\u002Fbalance\u002Fbanks:surround":933},[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":106,"badge":195,"body":196,"description":926,"extension":927,"links":928,"meta":929,"method":928,"navigation":930,"path":107,"seo":931,"stem":108,"__hash__":932},"docs_en\u002F5.balance\u002F2.banks.md","GET",{"type":197,"value":198,"toc":919},"minimark",[199,206,222,241,246,278,282,303,415,419,469,485,489,525,529,906,911,915],[200,201,202],"p",{},[203,204,205],"code",{},"GET \u002Fv1\u002Fbanks",[200,207,208,209,212,213,216,217,221],{},"Returns the master list of Thai banks. Each entry's ",[203,210,211],{},"bank_code"," is the value you send in ",[203,214,215],{},"receiver_bank_provider"," when ",[218,219,220],"a",{"href":89},"creating a withdrawal",".",[223,224,225],"note",{},[200,226,227,228,232,233,236,237,240],{},"This is the ",[229,230,231],"strong",{},"only"," endpoint under ",[203,234,235],{},"\u002Fv1"," that ",[229,238,239],{},"does not require authentication"," (no API key \u002F HMAC), because it is static reference data (the Thai bank master) that doesn't depend on any merchant.",[242,243,245],"h2",{"id":244},"endpoint","Endpoint",[247,248,249,258,264],"ul",{},[250,251,252,255,256],"li",{},[229,253,254],{},"Method \u002F Path:"," ",[203,257,205],{},[250,259,260,263],{},[229,261,262],{},"Auth:"," none (public)",[250,265,266,269,270,273,274,277],{},[229,267,268],{},"Cache:"," the response carries the header ",[203,271,272],{},"Cache-Control: public, max-age=3600"," — the data is static, so cache it on your side (at least 1 hour per ",[203,275,276],{},"max-age",") instead of refetching on every request.",[242,279,281],{"id":280},"response-shape","Response shape",[200,283,284,285,288,289,294,295,298,299,302],{},"The response is a JSON ",[229,286,287],{},"object (map)"," where ",[229,290,291,292],{},"the key of each entry is its ",[203,293,211],{}," (e.g. ",[203,296,297],{},"\"SCB\"",", ",[203,300,301],{},"\"KBANK\"",") — not an array. Each entry has these fields:",[304,305,306,322],"table",{},[307,308,309],"thead",{},[310,311,312,316,319],"tr",{},[313,314,315],"th",{},"Field",[313,317,318],{},"Type",[313,320,321],{},"Description",[323,324,325,351,370,385,400],"tbody",{},[310,326,327,332,335],{},[328,329,330],"td",{},[203,331,211],{},[328,333,334],{},"string",[328,336,337,340,341,343,344,347,348,350],{},[229,338,339],{},"The bank's alias code (canonical enum)",", e.g. ",[203,342,297],{}," — ",[229,345,346],{},"use this value to identify the bank on a withdrawal"," (send it as ",[203,349,215],{},").",[310,352,353,358,360],{},[328,354,355],{},[203,356,357],{},"bank_number",[328,359,334],{},[328,361,362,363,343,366,369],{},"The 3-digit BOT bank code, e.g. ",[203,364,365],{},"\"014\"",[229,367,368],{},"display \u002F reference only",". Do not use it to identify the bank on a withdrawal.",[310,371,372,377,379],{},[328,373,374],{},[203,375,376],{},"name_th",[328,378,334],{},[328,380,381,382,221],{},"Short Thai name, e.g. ",[203,383,384],{},"\"ไทยพาณิชย์\"",[310,386,387,392,394],{},[328,388,389],{},[203,390,391],{},"fullname_th",[328,393,334],{},[328,395,396,397,221],{},"Full Thai name, e.g. ",[203,398,399],{},"\"ธนาคารไทยพาณิชย์\"",[310,401,402,407,409],{},[328,403,404],{},[203,405,406],{},"name_en",[328,408,334],{},[328,410,411,412,221],{},"English name, e.g. ",[203,413,414],{},"\"The Siam Commercial Bank\"",[242,416,418],{"id":417},"bank_code-vs-bank_number","bank_code vs bank_number",[247,420,421,449],{},[250,422,423,427,428,431,432,434,435,437,438,441,442,445,446,448],{},[229,424,425],{},[203,426,211],{}," is the value that actually \"identifies the bank\" in the system. When creating a withdrawal (",[203,429,430],{},"POST \u002Fv1\u002Fwithdrawals",", field ",[203,433,215],{},") you must send a ",[203,436,211],{}," only. The system validates it against the master — an unknown value returns error ",[203,439,440],{},"INVALID_BANK"," (HTTP 422). The comparison is case-insensitive (",[203,443,444],{},"\"scb\""," or ",[203,447,297],{}," both work; the system normalizes to uppercase).",[250,450,451,455,456,459,460,463,464,466,467,221],{},[229,452,453],{},[203,454,357],{}," (the 3-digit BOT code) is ",[229,457,458],{},"display \u002F reference"," only. The system ",[229,461,462],{},"does not use"," it to match or identify a bank. Never send ",[203,465,357],{}," to ",[203,468,215],{},[470,471,472],"caution",{},[200,473,474,475,478,479,482,483,221],{},"Rails like PromptPay \u002F TrueMoney are ",[229,476,477],{},"payment rails",", not banks in this list — they do not appear in ",[203,480,481],{},"\u002Fv1\u002Fbanks"," and cannot be used as a ",[203,484,211],{},[242,486,488],{"id":487},"example-request","Example request",[490,491,497],"pre",{"className":492,"code":493,"filename":494,"language":495,"meta":496,"style":496},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl -X GET 'https:\u002F\u002Fapi.unkpay.co\u002Fv1\u002Fbanks'\n","cURL","bash","",[203,498,499],{"__ignoreMap":496},[500,501,504,508,512,515,519,522],"span",{"class":502,"line":503},"line",1,[500,505,507],{"class":506},"sBMFI","curl",[500,509,511],{"class":510},"sfazB"," -X",[500,513,514],{"class":510}," GET",[500,516,518],{"class":517},"sMK4o"," '",[500,520,521],{"class":510},"https:\u002F\u002Fapi.unkpay.co\u002Fv1\u002Fbanks",[500,523,524],{"class":517},"'\n",[242,526,528],{"id":527},"example-response-200-ok","Example response (200 OK)",[490,530,534],{"className":531,"code":532,"language":533,"meta":496,"style":496},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"SCB\": {\n    \"name_th\": \"ไทยพาณิชย์\",\n    \"fullname_th\": \"ธนาคารไทยพาณิชย์\",\n    \"name_en\": \"The Siam Commercial Bank\",\n    \"bank_code\": \"SCB\",\n    \"bank_number\": \"014\"\n  },\n  \"KBANK\": {\n    \"name_th\": \"กสิกรไทย\",\n    \"fullname_th\": \"ธนาคารกสิกรไทย\",\n    \"name_en\": \"Kasikorn Bank\",\n    \"bank_code\": \"KBANK\",\n    \"bank_number\": \"004\"\n  },\n  \"BBL\": {\n    \"name_th\": \"กรุงเทพ\",\n    \"fullname_th\": \"ธนาคารกรุงเทพ\",\n    \"name_en\": \"Bangkok Bank\",\n    \"bank_code\": \"BBL\",\n    \"bank_number\": \"002\"\n  }\n}\n","json",[203,535,536,541,560,583,603,623,642,661,667,681,701,721,741,760,778,783,797,817,837,857,876,894,900],{"__ignoreMap":496},[500,537,538],{"class":502,"line":503},[500,539,540],{"class":517},"{\n",[500,542,544,547,551,554,557],{"class":502,"line":543},2,[500,545,546],{"class":517},"  \"",[500,548,550],{"class":549},"spNyl","SCB",[500,552,553],{"class":517},"\"",[500,555,556],{"class":517},":",[500,558,559],{"class":517}," {\n",[500,561,563,566,568,570,572,575,578,580],{"class":502,"line":562},3,[500,564,565],{"class":517},"    \"",[500,567,376],{"class":506},[500,569,553],{"class":517},[500,571,556],{"class":517},[500,573,574],{"class":517}," \"",[500,576,577],{"class":510},"ไทยพาณิชย์",[500,579,553],{"class":517},[500,581,582],{"class":517},",\n",[500,584,586,588,590,592,594,596,599,601],{"class":502,"line":585},4,[500,587,565],{"class":517},[500,589,391],{"class":506},[500,591,553],{"class":517},[500,593,556],{"class":517},[500,595,574],{"class":517},[500,597,598],{"class":510},"ธนาคารไทยพาณิชย์",[500,600,553],{"class":517},[500,602,582],{"class":517},[500,604,606,608,610,612,614,616,619,621],{"class":502,"line":605},5,[500,607,565],{"class":517},[500,609,406],{"class":506},[500,611,553],{"class":517},[500,613,556],{"class":517},[500,615,574],{"class":517},[500,617,618],{"class":510},"The Siam Commercial Bank",[500,620,553],{"class":517},[500,622,582],{"class":517},[500,624,626,628,630,632,634,636,638,640],{"class":502,"line":625},6,[500,627,565],{"class":517},[500,629,211],{"class":506},[500,631,553],{"class":517},[500,633,556],{"class":517},[500,635,574],{"class":517},[500,637,550],{"class":510},[500,639,553],{"class":517},[500,641,582],{"class":517},[500,643,645,647,649,651,653,655,658],{"class":502,"line":644},7,[500,646,565],{"class":517},[500,648,357],{"class":506},[500,650,553],{"class":517},[500,652,556],{"class":517},[500,654,574],{"class":517},[500,656,657],{"class":510},"014",[500,659,660],{"class":517},"\"\n",[500,662,664],{"class":502,"line":663},8,[500,665,666],{"class":517},"  },\n",[500,668,670,672,675,677,679],{"class":502,"line":669},9,[500,671,546],{"class":517},[500,673,674],{"class":549},"KBANK",[500,676,553],{"class":517},[500,678,556],{"class":517},[500,680,559],{"class":517},[500,682,684,686,688,690,692,694,697,699],{"class":502,"line":683},10,[500,685,565],{"class":517},[500,687,376],{"class":506},[500,689,553],{"class":517},[500,691,556],{"class":517},[500,693,574],{"class":517},[500,695,696],{"class":510},"กสิกรไทย",[500,698,553],{"class":517},[500,700,582],{"class":517},[500,702,704,706,708,710,712,714,717,719],{"class":502,"line":703},11,[500,705,565],{"class":517},[500,707,391],{"class":506},[500,709,553],{"class":517},[500,711,556],{"class":517},[500,713,574],{"class":517},[500,715,716],{"class":510},"ธนาคารกสิกรไทย",[500,718,553],{"class":517},[500,720,582],{"class":517},[500,722,724,726,728,730,732,734,737,739],{"class":502,"line":723},12,[500,725,565],{"class":517},[500,727,406],{"class":506},[500,729,553],{"class":517},[500,731,556],{"class":517},[500,733,574],{"class":517},[500,735,736],{"class":510},"Kasikorn Bank",[500,738,553],{"class":517},[500,740,582],{"class":517},[500,742,744,746,748,750,752,754,756,758],{"class":502,"line":743},13,[500,745,565],{"class":517},[500,747,211],{"class":506},[500,749,553],{"class":517},[500,751,556],{"class":517},[500,753,574],{"class":517},[500,755,674],{"class":510},[500,757,553],{"class":517},[500,759,582],{"class":517},[500,761,763,765,767,769,771,773,776],{"class":502,"line":762},14,[500,764,565],{"class":517},[500,766,357],{"class":506},[500,768,553],{"class":517},[500,770,556],{"class":517},[500,772,574],{"class":517},[500,774,775],{"class":510},"004",[500,777,660],{"class":517},[500,779,781],{"class":502,"line":780},15,[500,782,666],{"class":517},[500,784,786,788,791,793,795],{"class":502,"line":785},16,[500,787,546],{"class":517},[500,789,790],{"class":549},"BBL",[500,792,553],{"class":517},[500,794,556],{"class":517},[500,796,559],{"class":517},[500,798,800,802,804,806,808,810,813,815],{"class":502,"line":799},17,[500,801,565],{"class":517},[500,803,376],{"class":506},[500,805,553],{"class":517},[500,807,556],{"class":517},[500,809,574],{"class":517},[500,811,812],{"class":510},"กรุงเทพ",[500,814,553],{"class":517},[500,816,582],{"class":517},[500,818,820,822,824,826,828,830,833,835],{"class":502,"line":819},18,[500,821,565],{"class":517},[500,823,391],{"class":506},[500,825,553],{"class":517},[500,827,556],{"class":517},[500,829,574],{"class":517},[500,831,832],{"class":510},"ธนาคารกรุงเทพ",[500,834,553],{"class":517},[500,836,582],{"class":517},[500,838,840,842,844,846,848,850,853,855],{"class":502,"line":839},19,[500,841,565],{"class":517},[500,843,406],{"class":506},[500,845,553],{"class":517},[500,847,556],{"class":517},[500,849,574],{"class":517},[500,851,852],{"class":510},"Bangkok Bank",[500,854,553],{"class":517},[500,856,582],{"class":517},[500,858,860,862,864,866,868,870,872,874],{"class":502,"line":859},20,[500,861,565],{"class":517},[500,863,211],{"class":506},[500,865,553],{"class":517},[500,867,556],{"class":517},[500,869,574],{"class":517},[500,871,790],{"class":510},[500,873,553],{"class":517},[500,875,582],{"class":517},[500,877,879,881,883,885,887,889,892],{"class":502,"line":878},21,[500,880,565],{"class":517},[500,882,357],{"class":506},[500,884,553],{"class":517},[500,886,556],{"class":517},[500,888,574],{"class":517},[500,890,891],{"class":510},"002",[500,893,660],{"class":517},[500,895,897],{"class":502,"line":896},22,[500,898,899],{"class":517},"  }\n",[500,901,903],{"class":502,"line":902},23,[500,904,905],{"class":517},"}\n",[223,907,908],{},[200,909,910],{},"The example above is truncated. The real master currently has many banks (e.g. BBL, KBANK, KTB, TTB, SCB, BAY, GSB, KKP, etc.). Fetch from this endpoint and cache it — don't hardcode the list on your side.",[912,913],"placeholder-image",{"subject":914},"Example of the merchant-side bank-selection dropdown populated from GET \u002Fv1\u002Fbanks (showing name_th + bank_number, sending bank_code to the backend)",[916,917,918],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}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":496,"searchDepth":503,"depth":543,"links":920},[921,922,923,924,925],{"id":244,"depth":543,"text":245},{"id":280,"depth":543,"text":281},{"id":417,"depth":543,"text":418},{"id":487,"depth":543,"text":488},{"id":527,"depth":543,"text":528},"Fetch the public bank master keyed by bank_code, used to set receiver_bank_provider on withdrawals","md",null,{},{"icon":109},{"title":106,"description":926},"8qs2UGiLIAtdsXphWQ2NUgdpWZZO32h7sgJ6S6XhBEY",[934,936],{"title":102,"path":103,"stem":104,"description":935,"icon":97,"children":-1},"Check your merchant wallet balance (available + pending) before creating a withdrawal",{"title":117,"path":118,"stem":119,"description":937,"icon":61,"children":-1},"How UnknownPay notifies your server of terminal deposit and withdrawal states, and how to configure a webhook in the Portal",1781891155269]