[{"data":1,"prerenderedAt":540},["ShallowReactive",2],{"navigation_docs":3,"-docs-integration-flow-order-and-wallet-saga":268,"-docs-integration-flow-order-and-wallet-saga-surround":535},[4,22,35,56,80,135,170,198,222,243],{"title":5,"path":6,"stem":7,"children":8,"page":21},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started",[9,13,17],{"title":10,"path":11,"stem":12},"Overview","\u002Fdocs\u002Fgetting-started\u002Foverview","docs\u002F1.getting-started\u002F1.overview",{"title":14,"path":15,"stem":16},"Integration checklist","\u002Fdocs\u002Fgetting-started\u002Fintegration-checklist","docs\u002F1.getting-started\u002F2.integration-checklist",{"title":18,"path":19,"stem":20},"Environments and base URLs","\u002Fdocs\u002Fgetting-started\u002Fenvironments-and-base-urls","docs\u002F1.getting-started\u002F3.environments-and-base-urls",false,{"title":23,"path":24,"stem":25,"children":26,"page":21},"Troubleshooting","\u002Fdocs\u002Ftroubleshooting","docs\u002F10.troubleshooting",[27,31],{"title":28,"path":29,"stem":30},"Common errors","\u002Fdocs\u002Ftroubleshooting\u002Fcommon-errors","docs\u002F10.troubleshooting\u002F1.common-errors",{"title":32,"path":33,"stem":34},"Support escalation","\u002Fdocs\u002Ftroubleshooting\u002Fsupport-escalation","docs\u002F10.troubleshooting\u002F2.support-escalation",{"title":36,"path":37,"stem":38,"children":39,"page":21},"Integration Flow","\u002Fdocs\u002Fintegration-flow","docs\u002F2.integration-flow",[40,44,48,52],{"title":41,"path":42,"stem":43},"Architecture","\u002Fdocs\u002Fintegration-flow\u002Farchitecture","docs\u002F2.integration-flow\u002F1.architecture",{"title":45,"path":46,"stem":47},"Launch session model","\u002Fdocs\u002Fintegration-flow\u002Flaunch-session-model","docs\u002F2.integration-flow\u002F2.launch-session-model",{"title":49,"path":50,"stem":51},"Order and wallet saga","\u002Fdocs\u002Fintegration-flow\u002Forder-and-wallet-saga","docs\u002F2.integration-flow\u002F3.order-and-wallet-saga",{"title":53,"path":54,"stem":55},"FX fees and rounding","\u002Fdocs\u002Fintegration-flow\u002Ffx-fees-and-rounding","docs\u002F2.integration-flow\u002F4.fx-fees-and-rounding",{"title":57,"path":58,"stem":59,"children":60,"page":21},"Dashboard","\u002Fdocs\u002Fdashboard","docs\u002F3.dashboard",[61,64,68,72,76],{"title":10,"path":62,"stem":63},"\u002Fdocs\u002Fdashboard\u002Foverview","docs\u002F3.dashboard\u002F1.overview",{"title":65,"path":66,"stem":67},"API keys","\u002Fdocs\u002Fdashboard\u002Fapi-keys","docs\u002F3.dashboard\u002F2.api-keys",{"title":69,"path":70,"stem":71},"Wallet adapter settings","\u002Fdocs\u002Fdashboard\u002Fwallet-adapter-settings","docs\u002F3.dashboard\u002F3.wallet-adapter-settings",{"title":73,"path":74,"stem":75},"Webhook endpoints","\u002Fdocs\u002Fdashboard\u002Fwebhook-endpoints","docs\u002F3.dashboard\u002F4.webhook-endpoints",{"title":77,"path":78,"stem":79},"Market visibility","\u002Fdocs\u002Fdashboard\u002Fmarket-visibility","docs\u002F3.dashboard\u002F5.market-visibility",{"title":81,"path":82,"stem":83,"children":84,"page":21},"Operator Api","\u002Fdocs\u002Foperator-api","docs\u002F4.operator-api",[85,89,92,96,100,104,107,111,115,119,123,127,131],{"title":86,"path":87,"stem":88},"Authentication","\u002Fdocs\u002Foperator-api\u002Fauthentication","docs\u002F4.operator-api\u002F1.authentication",{"title":73,"path":90,"stem":91},"\u002Fdocs\u002Foperator-api\u002Fwebhook-endpoints","docs\u002F4.operator-api\u002F10.webhook-endpoints",{"title":93,"path":94,"stem":95},"Webhook deliveries","\u002Fdocs\u002Foperator-api\u002Fwebhook-deliveries","docs\u002F4.operator-api\u002F11.webhook-deliveries",{"title":97,"path":98,"stem":99},"Simulator","\u002Fdocs\u002Foperator-api\u002Fsimulator","docs\u002F4.operator-api\u002F12.simulator",{"title":101,"path":102,"stem":103},"Error codes","\u002Fdocs\u002Foperator-api\u002Ferror-codes","docs\u002F4.operator-api\u002F13.error-codes",{"title":65,"path":105,"stem":106},"\u002Fdocs\u002Foperator-api\u002Fapi-keys","docs\u002F4.operator-api\u002F2.api-keys",{"title":108,"path":109,"stem":110},"Session","\u002Fdocs\u002Foperator-api\u002Fsession","docs\u002F4.operator-api\u002F3.session",{"title":112,"path":113,"stem":114},"Launch","\u002Fdocs\u002Foperator-api\u002Flaunch","docs\u002F4.operator-api\u002F4.launch",{"title":116,"path":117,"stem":118},"Users","\u002Fdocs\u002Foperator-api\u002Fusers","docs\u002F4.operator-api\u002F5.users",{"title":120,"path":121,"stem":122},"Markets","\u002Fdocs\u002Foperator-api\u002Fmarkets","docs\u002F4.operator-api\u002F6.markets",{"title":124,"path":125,"stem":126},"Trades","\u002Fdocs\u002Foperator-api\u002Ftrades","docs\u002F4.operator-api\u002F7.trades",{"title":128,"path":129,"stem":130},"Redemptions","\u002Fdocs\u002Foperator-api\u002Fredemptions","docs\u002F4.operator-api\u002F8.redemptions",{"title":132,"path":133,"stem":134},"Balance operations","\u002Fdocs\u002Foperator-api\u002Fbalance-operations","docs\u002F4.operator-api\u002F9.balance-operations",{"title":136,"path":137,"stem":138,"children":139,"page":21},"Wallet Adapter","\u002Fdocs\u002Fwallet-adapter","docs\u002F5.wallet-adapter",[140,143,146,150,154,158,162,166],{"title":10,"path":141,"stem":142},"\u002Fdocs\u002Fwallet-adapter\u002Foverview","docs\u002F5.wallet-adapter\u002F1.overview",{"title":86,"path":144,"stem":145},"\u002Fdocs\u002Fwallet-adapter\u002Fauthentication","docs\u002F5.wallet-adapter\u002F2.authentication",{"title":147,"path":148,"stem":149},"Balance","\u002Fdocs\u002Fwallet-adapter\u002Fbalance","docs\u002F5.wallet-adapter\u002F3.balance",{"title":151,"path":152,"stem":153},"Debit","\u002Fdocs\u002Fwallet-adapter\u002Fdebit","docs\u002F5.wallet-adapter\u002F4.debit",{"title":155,"path":156,"stem":157},"Credit","\u002Fdocs\u002Fwallet-adapter\u002Fcredit","docs\u002F5.wallet-adapter\u002F5.credit",{"title":159,"path":160,"stem":161},"Debit reversal","\u002Fdocs\u002Fwallet-adapter\u002Fdebit-reversal","docs\u002F5.wallet-adapter\u002F6.debit-reversal",{"title":163,"path":164,"stem":165},"Operation lookup","\u002Fdocs\u002Fwallet-adapter\u002Foperation-lookup","docs\u002F5.wallet-adapter\u002F7.operation-lookup",{"title":167,"path":168,"stem":169},"Idempotency","\u002Fdocs\u002Fwallet-adapter\u002Fidempotency","docs\u002F5.wallet-adapter\u002F8.idempotency",{"title":171,"path":172,"stem":173,"children":174,"page":21},"Webhooks","\u002Fdocs\u002Fwebhooks","docs\u002F6.webhooks",[175,178,182,186,190,194],{"title":10,"path":176,"stem":177},"\u002Fdocs\u002Fwebhooks\u002Foverview","docs\u002F6.webhooks\u002F1.overview",{"title":179,"path":180,"stem":181},"Signatures","\u002Fdocs\u002Fwebhooks\u002Fsignatures","docs\u002F6.webhooks\u002F2.signatures",{"title":183,"path":184,"stem":185},"Event envelope","\u002Fdocs\u002Fwebhooks\u002Fevent-envelope","docs\u002F6.webhooks\u002F3.event-envelope",{"title":187,"path":188,"stem":189},"Event types","\u002Fdocs\u002Fwebhooks\u002Fevent-types","docs\u002F6.webhooks\u002F4.event-types",{"title":191,"path":192,"stem":193},"Retry and replay","\u002Fdocs\u002Fwebhooks\u002Fretry-and-replay","docs\u002F6.webhooks\u002F5.retry-and-replay",{"title":195,"path":196,"stem":197},"Receiver examples","\u002Fdocs\u002Fwebhooks\u002Freceiver-examples","docs\u002F6.webhooks\u002F6.receiver-examples",{"title":199,"path":200,"stem":201,"children":202,"page":21},"Testing And Staging","\u002Fdocs\u002Ftesting-and-staging","docs\u002F7.testing-and-staging",[203,207,210,214,218],{"title":204,"path":205,"stem":206},"Staging overview","\u002Fdocs\u002Ftesting-and-staging\u002Fstaging-overview","docs\u002F7.testing-and-staging\u002F1.staging-overview",{"title":97,"path":208,"stem":209},"\u002Fdocs\u002Ftesting-and-staging\u002Fsimulator","docs\u002F7.testing-and-staging\u002F2.simulator",{"title":211,"path":212,"stem":213},"Wallet failure drills","\u002Fdocs\u002Ftesting-and-staging\u002Fwallet-failure-drills","docs\u002F7.testing-and-staging\u002F3.wallet-failure-drills",{"title":215,"path":216,"stem":217},"Webhook drills","\u002Fdocs\u002Ftesting-and-staging\u002Fwebhook-drills","docs\u002F7.testing-and-staging\u002F4.webhook-drills",{"title":219,"path":220,"stem":221},"Production cutover rehearsal","\u002Fdocs\u002Ftesting-and-staging\u002Fproduction-cutover-rehearsal","docs\u002F7.testing-and-staging\u002F5.production-cutover-rehearsal",{"title":223,"path":224,"stem":225,"children":226,"page":21},"Production Readiness","\u002Fdocs\u002Fproduction-readiness","docs\u002F8.production-readiness",[227,231,235,239],{"title":228,"path":229,"stem":230},"Checklist","\u002Fdocs\u002Fproduction-readiness\u002Fchecklist","docs\u002F8.production-readiness\u002F1.checklist",{"title":232,"path":233,"stem":234},"Operational runbook","\u002Fdocs\u002Fproduction-readiness\u002Foperational-runbook","docs\u002F8.production-readiness\u002F2.operational-runbook",{"title":236,"path":237,"stem":238},"Security","\u002Fdocs\u002Fproduction-readiness\u002Fsecurity","docs\u002F8.production-readiness\u002F3.security",{"title":240,"path":241,"stem":242},"Rollback","\u002Fdocs\u002Fproduction-readiness\u002Frollback","docs\u002F8.production-readiness\u002F4.rollback",{"title":244,"path":245,"stem":246,"children":247,"page":21},"Reference","\u002Fdocs\u002Freference","docs\u002F9.reference",[248,252,256,260,264],{"title":249,"path":250,"stem":251},"Statuses","\u002Fdocs\u002Freference\u002Fstatuses","docs\u002F9.reference\u002F1.statuses",{"title":253,"path":254,"stem":255},"Scopes","\u002Fdocs\u002Freference\u002Fscopes","docs\u002F9.reference\u002F2.scopes",{"title":257,"path":258,"stem":259},"Units and money","\u002Fdocs\u002Freference\u002Funits-and-money","docs\u002F9.reference\u002F3.units-and-money",{"title":261,"path":262,"stem":263},"Changelog","\u002Fdocs\u002Freference\u002Fchangelog","docs\u002F9.reference\u002F4.changelog",{"title":265,"path":266,"stem":267},"Virtual AMM","\u002Fdocs\u002Freference\u002Fvirtual-amm","docs\u002F9.reference\u002F5.virtual-amm",{"id":269,"title":49,"body":270,"description":528,"extension":529,"links":530,"meta":531,"navigation":532,"path":50,"seo":533,"stem":51,"__hash__":534},"docs\u002Fdocs\u002F2.integration-flow\u002F3.order-and-wallet-saga.md",{"type":271,"value":272,"toc":512},"minimark",[273,277,281,286,314,318,335,339,393,397,402,415,419,431,435,448,452,457,460,474,478,481,491,495],[274,275,49],"h1",{"id":276},"order-and-wallet-saga",[278,279,280],"p",{},"Money flow and trade flow are coordinated saga, not one DB transaction.",[282,283,285],"h2",{"id":284},"buy-side-flow","Buy-side flow",[287,288,289,293,296,299,302,305,308,311],"ol",{},[290,291,292],"li",{},"user requests quote",[290,294,295],{},"OpenPoly computes quote with current FX and fees",[290,297,298],{},"user submits order",[290,300,301],{},"OpenPoly creates order record",[290,303,304],{},"OpenPoly debits operator wallet",[290,306,307],{},"if debit succeeds -> OpenPoly executes AMM trade",[290,309,310],{},"OpenPoly commits final order state",[290,312,313],{},"OpenPoly emits webhook event",[282,315,317],{"id":316},"sell-or-redemption-flow","Sell or redemption flow",[287,319,320,323,326,329,332],{},[290,321,322],{},"OpenPoly computes credits-equivalent proceeds",[290,324,325],{},"OpenPoly computes external payout amount",[290,327,328],{},"OpenPoly settles internal state",[290,330,331],{},"OpenPoly credits operator wallet",[290,333,334],{},"OpenPoly emits success or failure webhook event",[282,336,338],{"id":337},"common-order-statuses","Common order statuses",[340,341,342,348,353,358,363,368,373,378,383,388],"ul",{},[290,343,344],{},[345,346,347],"code",{},"queued",[290,349,350],{},[345,351,352],{},"processing",[290,354,355],{},[345,356,357],{},"operator_debit_pending",[290,359,360],{},[345,361,362],{},"operator_debited",[290,364,365],{},[345,366,367],{},"operator_credit_pending",[290,369,370],{},[345,371,372],{},"processed",[290,374,375],{},[345,376,377],{},"failed",[290,379,380],{},[345,381,382],{},"compensation_pending",[290,384,385],{},[345,386,387],{},"compensated",[290,389,390],{},[345,391,392],{},"manual_review",[282,394,396],{"id":395},"failure-handling","Failure handling",[398,399,401],"h3",{"id":400},"debit-failed","Debit failed",[340,403,404,409,412],{},[290,405,406,407],{},"order -> ",[345,408,377],{},[290,410,411],{},"no AMM trade",[290,413,414],{},"failure webhook emitted",[398,416,418],{"id":417},"debit-unknown","Debit unknown",[340,420,421,425,428],{},[290,422,406,423],{},[345,424,392],{},[290,426,427],{},"no AMM trade until resolved",[290,429,430],{},"operator lookup and human follow-up required",[398,432,434],{"id":433},"credit-failed-or-unknown","Credit failed or unknown",[340,436,437,442,445],{},[290,438,439,440],{},"payout-side record can move to ",[345,441,392],{},[290,443,444],{},"do not blindly re-credit with new idempotency key",[290,446,447],{},"confirm remote state through lookup first",[282,449,451],{"id":450},"manual-review-rule","Manual review rule",[278,453,454,456],{},[345,455,392],{}," means automatic path stopped because final wallet state or business completion is not safe to assume.",[278,458,459],{},"Typical triggers:",[340,461,462,468,471],{},[290,463,464,465],{},"wallet result ",[345,466,467],{},"unknown",[290,469,470],{},"compensation needed",[290,472,473],{},"payout-side credit failed after internal state advanced",[282,475,477],{"id":476},"compensation","Compensation",[278,479,480],{},"If debit succeeded but downstream completion failed, OpenPoly may require reversal or compensation flow. That is why order lifecycle includes:",[340,482,483,487],{},[290,484,485],{},[345,486,382],{},[290,488,489],{},[345,490,387],{},[282,492,494],{"id":493},"operator-guidance","Operator guidance",[340,496,497,503,506],{},[290,498,499,500],{},"track every mutation by ",[345,501,502],{},"idempotency_key",[290,504,505],{},"use lookup endpoint before any retry after timeout",[290,507,508,509,511],{},"treat ",[345,510,392],{}," as operational incident, not user-facing success",{"title":513,"searchDepth":514,"depth":514,"links":515},"",2,[516,517,518,519,525,526,527],{"id":284,"depth":514,"text":285},{"id":316,"depth":514,"text":317},{"id":337,"depth":514,"text":338},{"id":395,"depth":514,"text":396,"children":520},[521,523,524],{"id":400,"depth":522,"text":401},3,{"id":417,"depth":522,"text":418},{"id":433,"depth":522,"text":434},{"id":450,"depth":514,"text":451},{"id":476,"depth":514,"text":477},{"id":493,"depth":514,"text":494},"Buy, sell, and redemption state transitions across OpenPoly and operator systems.","md",null,{},true,{"title":49,"description":528},"Jf2pnutjYtkoqZxoq4RJYuN5B502z1SeJJ8mFmvCPCI",[536,538],{"title":45,"path":46,"stem":47,"description":537,"children":-1},"Launch token redemption and session establishment.",{"title":53,"path":54,"stem":55,"description":539,"children":-1},"FX snapshots, fee application, unit conversions, and flooring rules.",1781957290954]