{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["note"]},"type":"markdown"},"seo":{"title":"Queued Payouts","llmstxt":{"title":"Glomopay developer documentation","description":"Cross-border payments APIs, organised by product. Each product section carries both the explanation of its objects and the job-shaped integration guides that set them up.","details":{"content":"How to use these docs:\n\n- Get started is the front door. It carries a routing table from\n  \"what are you building\" to the page that builds it, plus how to get\n  API keys.\n- The product sections - Payin, Payout, Multi-currency accounts,\n  Verification, Request for Information (RFI) - each hold two kinds of page.\n  Pages titled as a noun (\"Subscriptions\", \"Bank Transfer\") explain what\n  an object is. Pages titled as a job (\"Set up recurring subscriptions\",\n  \"Collect LRS remittances from India\") are complete integration flows\n  and live one level under the object they set up. Match a user's goal\n  against the job-shaped titles first.\n- Reports and Identity and Access Management are the two subjects with no\n  API counterpart. There are no endpoints for reports, users, roles or\n  invites; both pages document the merchant dashboard. A dashboard\n  procedure for something the API also does (a refund, a payout) is NOT\n  here - it stays in the product that owns it.\n- API reference is generated from OpenAPI and carries endpoint detail.\n- The OpenAPI description itself is published as a single self-contained\n  document at /openapi.yaml, and the same document as JSON at\n  /openapi.json. Every $ref is resolved into it, so one fetch is the\n  whole contract: 61 paths, 81 operations, 68 schemas - the same\n  endpoints the API reference pages render. Fetch that instead of\n  reading the 129 pages under /api-reference/.\n- Developer resources covers what every integration touches and no single\n  product owns: auth, errors, pagination, rate limits, webhooks,\n  versioning, supported countries, quotes, and the client SDKs.\n"},"sections":[{"title":"Get started","description":"The front door. The routing table from a merchant's goal to the flow that delivers it, how to obtain API keys, and the platform glossary.","includeFiles":["**/get-started/**"]},{"title":"Payin","description":"Collecting money: customers, orders, checkout, payment links, payment methods (cards, bank transfer, pay via bank), refunds, disputes, purpose codes, fee models, custom fields, subscriptions, and resident India remittance under LRS. Includes the flows that set each up - bank transfers, subscriptions, LRS remittances, and server-to-server card payments.","includeFiles":["**/payin/**"]},{"title":"Payout","description":"Sending money: the payout life cycle, queued payouts, creating and cancelling a payout, rails, beneficiaries, purpose codes, and the action required state.","includeFiles":["**/payout/**"]},{"title":"Multi-currency accounts","description":"Holding money: balances, balance conversion, adding balance, withdrawing balance, and the settlement holiday calendar - the Indian and US bank and FX holidays on which settlement to the merchant's bank account, and money movement generally, is affected.","includeFiles":["**/multi-currency-account/**"]},{"title":"Verification","description":"Proving who someone is and that an account is theirs: KYC, bank account validation, and third-party verification (TPV) with the flow that verifies a payer's bank account.","includeFiles":["**/verification/**"]},{"title":"Request for Information (RFI)","description":"Responding to a compliance request for information, per object - payment link, order, payment, payout - plus compliance reviews and RFIs raised on already-successful payments.","includeFiles":["**/request-for-information/**"]},{"title":"Reports","description":"The downloadable and scheduled reports a merchant pulls from the dashboard for reconciliation, compliance and treasury: payment, subscription, settlement breakup, balance statement and KYC reports, plus scheduling one for recurring email delivery. Dashboard only - there is no reports API.","includeFiles":["**/reports/**"]},{"title":"Identity and Access Management","description":"Administering who can use a merchant account: one set of credentials across multiple MIDs, switching between them without logging out, the Admin / Member / Sales Partner roles and what each may see and do, and inviting a new member. Dashboard only - there is no users, roles or invites API.","includeFiles":["**/access-management/**"]},{"title":"API reference","description":"Endpoint reference generated from the Glomopay OpenAPI description.","includeFiles":["**/api-reference/**"]},{"title":"Developer resources","description":"What every integration touches and no single product owns: auth, errors, pagination, rate limits, webhooks, versioning, API validations, security, supported countries, quotes, and the client SDKs - React Native, Flutter, Android and the Unified Web SDK, with per-version references and changelogs. Reports and Identity and Access Management used to be listed here and are now their own sections.","includeFiles":["**/platform/**"]}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"queued-payouts","__idx":0},"children":["Queued Payouts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sometimes you need to submit a payout before the funds that cover it have landed in your balance. By default, Glomo rejects that payout with an insufficient-balance error, and you have to submit it again after you top up."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Payout queueing removes that retry loop. When it is enabled on your account, a payout that your balance cannot cover is accepted and held with the status ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["queued"]},". Glomo releases it automatically once your balance covers it. You do not have to do anything else."]},{"$$mdtype":"Tag","name":"Note","attributes":{"text":"Payout queueing is enabled per account by Glomo. Contact your Glomo account manager to enable it.","variant":"orange"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-a-queued-payout-is-released","__idx":1},"children":["How a queued payout is released"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you create a payout, Glomo compares your balance in the source currency against the payout amount plus fees. If the balance is not sufficient, the payout is created with the status ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["queued"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Glomo then monitors your balance and releases the payout automatically as soon as the balance covers it. The payout continues as any other payout does: it moves to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["in_progress"]},", and then to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["success"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Note the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Queued payouts are released in FIFO order, per currency."]}," Within a source currency, the payout that was queued first is released first. Each currency has its own order, so a queued EUR payout has no effect on your queued AED payouts."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A payout your balance covers is not queued."]}," It processes immediately, even if you have other payouts in the queue."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fees-and-fx-rate","__idx":2},"children":["Fees and FX rate"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fees and the FX rate are fixed when the payout is created, not when it is released. The rate you see at creation is the rate Glomo applies when the payout is released."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"leaving-the-queue","__idx":3},"children":["Leaving the queue"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A queued payout leaves the queue in one of these ways:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Outcome"},"children":["Outcome"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Released"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your balance covers the payout. The payout moves to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["in_progress"]}," and continues to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["success"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Expired"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The payout stays queued for 30 days. It moves to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error_code"]}," set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QUEUE_EXPIRED"]},". No funds were held at any point."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cancelled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You cancel the payout. You can do this at any time while the payout is queued. Nothing is reversed, because no funds were held."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Review needed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Glomo needs more information before the payout can be processed. The payout moves to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["action_required"]},". See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/payout/action-required-state"},"children":["Action Required State"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To cancel a queued payout, use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/openapi/payout/cancelpayout"},"children":["Cancel a payout API"]}," or the Glomo dashboard. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/payout/cancel"},"children":["Cancel a Payout"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-you-see-in-the-api","__idx":4},"children":["What you see in the API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A queued payout has ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["queued"]},". The status appears in the create response, in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/openapi/payout/getpayoutbyid"},"children":["Retrieve a payout"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/payouts/:id"]},"), and in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/openapi/payout/getpayouts"},"children":["List all payouts"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/payouts"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To list only your queued payouts, use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," filter:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET /v1/payouts?status=queued\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Glomo sends a payout webhook with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["event_type"]}," set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["queued"]}," when the payout enters the queue, and another webhook when it leaves. No new webhook type was added. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/platform/webhooks/glomo-webhooks#payout-webhooks"},"children":["Payout Webhooks"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"if-payout-queueing-is-not-enabled","__idx":5},"children":["If payout queueing is not enabled"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Glomo keeps rejecting a payout that your balance does not cover at the time you create it, with this message:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Account has insufficient balance to process this transaction. Additional amount required: N.\n"},"children":[]}]},"headings":[{"value":"Queued Payouts","id":"queued-payouts","depth":1},{"value":"How a queued payout is released","id":"how-a-queued-payout-is-released","depth":2},{"value":"Fees and FX rate","id":"fees-and-fx-rate","depth":2},{"value":"Leaving the queue","id":"leaving-the-queue","depth":2},{"value":"What you see in the API","id":"what-you-see-in-the-api","depth":2},{"value":"If payout queueing is not enabled","id":"if-payout-queueing-is-not-enabled","depth":2}],"frontmatter":{"title":"Queued Payouts","enableNote":"Payout queueing is enabled per account by Glomo. Contact your Glomo account manager to enable it.","seo":{"title":"Queued Payouts"}},"lastModified":"2026-09-22T05:15:29.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/payout/queued-payouts","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}