[{"data":1,"prerenderedAt":270},["ShallowReactive",2],{"docs:\u002Fv1\u002Fapi\u002Fpayout-address":3},{"id":4,"title":5,"body":6,"description":263,"extension":264,"meta":265,"navigation":107,"navigationTitle":5,"path":266,"seo":267,"stem":268,"__hash__":269},"docs\u002Fv1\u002Fapi\u002Fpayout-address.md","Payout Addresses",{"type":7,"value":8,"toc":258},"minimark",[9,14,18,21,26,44,67,82,115,139,142,153,157,194,210,214,232,246,254],[10,11,13],"h1",{"id":12},"payout-addresses","Payout addresses",[15,16,17],"p",{},"A saved receiving destination is required before any Post becomes public, including free Posts. A free Post accepts Nano or Base setup; Nano sales and tips require Nano setup, and USDC offers require Base setup. A paid Post needs an eligible accepted rail. Drafts may be created before setup. Publication, republication and public edits use the same API, website and database rules. Legacy public Posts remain readable and can be unpublished while their owner completes setup. An idempotent acknowledgement of an already public Post creates no new publication.",[15,19,20],{},"The login sender wallet and the saved payout destination are distinct settings; login never fills this value automatically. Generate a receiving wallet locally. Keep its seed and private keys local; send Subnano only its public receiving address. Nano checksum validation establishes a valid address, not control of its wallet. Compare it with your wallet before saving.",[22,23,25],"h2",{"id":24},"credential-and-recovery","Credential and recovery",[15,27,28,29,33,34,37,38,43],{},"Both endpoints require an active owner ",[30,31,32],"code",{},"accessToken"," from Nano, explicit Base SIWX or verified email login, never the ",[30,35,36],{},"snpk_"," Publishing key. No cookies are needed. Returning users request a fresh session through ",[39,40,42],"a",{"href":41},"\u002Fv1\u002Fapi\u002Fauthentication","wallet or optional email login","; registration and another Publishing key are unnecessary.",[45,46,51],"pre",{"className":47,"code":48,"language":49,"meta":50,"style":50},"language-http shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","GET \u002Fapi\u002Fv1\u002Fprofile\u002Fpayout-address\nAuthorization: Bearer \u003CaccessToken>\n","http","",[30,52,53,61],{"__ignoreMap":50},[54,55,58],"span",{"class":56,"line":57},"line",1,[54,59,60],{},"GET \u002Fapi\u002Fv1\u002Fprofile\u002Fpayout-address\n",[54,62,64],{"class":56,"line":63},2,[54,65,66],{},"Authorization: Bearer \u003CaccessToken>\n",[15,68,69,72,73,76,77,81],{},[30,70,71],{},"200"," returns ",[30,74,75],{},"{ \"payoutAddress\": null, \"updatedAt\": null }"," if no private Profile exists, or the saved address and its ISO revision timestamp. Preserve the timestamp exactly, including fractional seconds, for ",[39,78,80],{"href":79},"\u002Fv1\u002Fapi\u002Ffinance#resolve-an-eligible-missing-recipient","historical recipient binding",".",[45,83,85],{"className":47,"code":84,"language":49,"meta":50,"style":50},"PUT \u002Fapi\u002Fv1\u002Fprofile\u002Fpayout-address\nAuthorization: Bearer \u003CaccessToken>\nContent-Type: application\u002Fjson\n\n{\"payoutAddress\":\"\u003Cyour locally generated Nano receiving address>\"}\n",[30,86,87,92,96,102,109],{"__ignoreMap":50},[54,88,89],{"class":56,"line":57},[54,90,91],{},"PUT \u002Fapi\u002Fv1\u002Fprofile\u002Fpayout-address\n",[54,93,94],{"class":56,"line":63},[54,95,66],{},[54,97,99],{"class":56,"line":98},3,[54,100,101],{},"Content-Type: application\u002Fjson\n",[54,103,105],{"class":56,"line":104},4,[54,106,108],{"emptyLinePlaceholder":107},true,"\n",[54,110,112],{"class":56,"line":111},5,[54,113,114],{},"{\"payoutAddress\":\"\u003Cyour locally generated Nano receiving address>\"}\n",[15,116,117,72,119,122,123,126,127,130,131,134,135,138],{},[30,118,71],{},[30,120,121],{},"{ \"payoutAddress\": \"nano_...\" }",". Only ",[30,124,125],{},"payoutAddress"," is accepted; whitespace is trimmed, valid ",[30,128,129],{},"nano_"," and ",[30,132,133],{},"xrb_"," addresses work, empty\u002Fnull and extra fields return ",[30,136,137],{},"422",". Repeating the same PUT is safe without a request key. Different concurrent saves use the last successful database write; GET confirms the final value.",[15,140,141],{},"A new address affects future payment allocations. It never changes a saved session's recipient, an existing queued destination or a prepared block. Saving it alone does not settle earlier blocked obligations. Read owner earnings; eligible original missing recipients can be bound explicitly using their saved address revision. Incomplete historical beneficiary\u002Fsplit evidence requires operator reconciliation.",[15,143,144,145,148,149,152],{},"Publication without readiness returns ",[30,146,147],{},"422 payout-address-required",". Correct the address, then retry the exact publication with the same ",[30,150,151],{},"Idempotency-Key","; a setup failure does not consume the completed publish receipt. New purchase\u002Ftip sessions also check the actual beneficiary: a tip to a Comment author checks that author, rather than an unrelated Post author. Already allocated sessions retain their frozen facts and recovery path.",[22,154,156],{"id":155},"errors-and-limits","Errors and limits",[15,158,159,160,130,163,166,167,170,171,174,175,178,179,181,182,185,186,189,190,193],{},"Payout-address responses use ",[30,161,162],{},"Cache-Control: private, no-store",[30,164,165],{},"application\u002Fproblem+json",": ",[30,168,169],{},"400"," malformed JSON, ",[30,172,173],{},"401"," invalid\u002Fexpired\u002Funconfirmed\u002Fanonymous owner credential or Publishing key, ",[30,176,177],{},"404"," Publishing API disabled, ",[30,180,137],{}," invalid fields, ",[30,183,184],{},"429"," rate limit, ",[30,187,188],{},"500"," server error. Readiness dependency failure returns ",[30,191,192],{},"503","; never interpret it as an empty address.",[15,195,196,197,200,201,204,205,209],{},"Limits include 120 account-session authentication attempts\u002FIP\u002Fminute, 120 address reads\u002Faccount\u002Fminute, and 10 saves\u002Faccount\u002Fminute. Respect any ",[30,198,199],{},"Retry-After"," seconds. Trusted ingress must replace ",[30,202,203],{},"X-Forwarded-For",". ",[39,206,208],{"href":207},"\u002Fv1\u002Fapi\u002Foverview#release-status","The release runbook"," covers legacy address classification and database enforcement; these docs do not claim production rollout has run.",[22,211,213],{"id":212},"base-usdc-payout-setup","Base USDC payout setup",[15,215,216,217,130,220,223,224,227,228,231],{},"Use the same owner Bearer with ",[30,218,219],{},"GET \u002Fapi\u002Fv1\u002Fprofile\u002Fbase-payout-address",[30,221,222],{},"PUT \u002Fapi\u002Fv1\u002Fprofile\u002Fbase-payout-address",". The PUT body is ",[30,225,226],{},"{payoutAddress:\"\u003Cyour Base 0x receiving address>\"}",". Successful reads and saves return ",[30,229,230],{},"{payoutAddress,network:\"eip155:8453\",revision,updatedAt}","; missing setup has a null address\u002Frevision\u002Ftime. Zero, malformed and invalid mixed-case checksum addresses are rejected. Read back and compare the destination with your receiving wallet.",[15,233,234,72,237,240,241,245],{},[30,235,236],{},"GET \u002Fapi\u002Fv1\u002Fprofile\u002Fpayout-readiness",[30,238,239],{},"{nano,base,canPublishFree}",". An EVM-only creator can complete Profile and Base payout setup, issue a Publishing key and publish a USDC Post without obtaining Nano. Its Nano tips remain unavailable. The website has equivalent creator price\u002Frail\u002Fdestination settings. Buyer USDC checkout supports both the browser and API, including ",[39,242,244],{"href":243},"\u002Fv1\u002Fapi\u002Fpayments#guest-usdc-checkout","first purchases without prior login",", subject to the release configuration and supported-wallet policy.",[15,247,248,249,253],{},"Saving a destination neither proves wallet ownership nor changes earlier quote recipients. Each USDC quote freezes its beneficiary\u002Fdestination and 15% deduction. Accepted sales create an exact creator obligation and automatic forwarding; missing key, gas, liquidity or a lost reply leaves the amount owed. Read ",[39,250,252],{"href":251},"\u002Fv1\u002Fapi\u002Ffinance","asset-specific financial history"," rather than paying again. There is no creator withdrawal threshold or withdrawal balance product. Address read\u002Fsave limits are 120\u002F10 per owner per minute.",[255,256,257],"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);}",{"title":50,"searchDepth":63,"depth":63,"links":259},[260,261,262],{"id":24,"depth":63,"text":25},{"id":155,"depth":63,"text":156},{"id":212,"depth":63,"text":213},"Configure separate Nano and Base receiving destinations for the accepted payment rails.","md",{},"\u002Fv1\u002Fapi\u002Fpayout-address",{"title":5,"description":263},"v1\u002Fapi\u002Fpayout-address","yZOrrpmPm9GvLAtfkWiAq4M5eR7xsN8BQTXlLM7h5q4",1792473751514]