{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Withdraw an LRS remittance back to the investor","siteUrl":"https://docs.glomo.one","llmstxt":{"title":"Glomo 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 has one section per integration\n  (what you're building), each with the API calls in order and the guide that builds it, plus\n  how to get 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- Every page below, in full, is one document at /llms-full.txt. Fetch that\n  instead of the pages one by one. It leaves out the API reference;\n  /openapi.yaml is that.\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, the MCP server for AI\n  agents, and the client SDKs.\n"},"sections":[{"title":"Get started","description":"The front door. The ordered API calls for each integration and the guide 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. Includes the flow that sends a payout over the API.","includeFiles":["**/payout/**"]},{"title":"Multi-currency accounts","description":"Holding money: balances, balance conversion, adding balance, and withdrawing balance.","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":"Nivo (Capital markets)","description":"Nivo, Glomo's capital markets suite (Nivo for AMCs, Nivo for Distributors, and overseas investing for brokers and wealth platforms). Mutual fund investments run as payment sessions: the fund, distributor, scheme, plan, ARN and folio roles; the distributor's relationship with a fund and what it fixes; and the flow that opens a session as a distributor.","includeFiles":["**/capital-markets/**"]},{"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":"Settlement holidays","description":"The settlement holiday calendar for 2026 - the Indian and US bank and FX holidays on which payin, payout and settlement to the merchant's bank account may be delayed.","includeFiles":["**/settlement-holidays/**"]},{"title":"API reference","description":"Endpoint reference generated from the Glomo 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, connecting an AI agent to the Glomo MCP server, 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":"withdraw-an-lrs-remittance-back-to-the-investor","__idx":0},"children":["Withdraw an LRS remittance back to the investor"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This flow is used for fund withdrawals. When an end user requests to withdraw their overseas investments, you, as the Indian broker, initiate the withdrawal by providing the user's bank account details, which are treated as the beneficiary account. The withdrawal flow involves five steps:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create a Beneficiary"]}," — register the user's bank account details as the beneficiary account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create a Document"]}," — upload the user's consent to withdraw the money."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Get a Payout Quote"]}," (optional) — show the investor an estimate of the INR they will receive."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create a Payout"]}," — initiate the transfer to the beneficiary, referencing the beneficiary and the uploaded documents."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payout Success"]}," — once the bank has processed the payout, its status changes to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["success"]}," and the finalized ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destination_amount"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mid_market_rate"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxes"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["utr"]}," are made available."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-beneficiary-v2","__idx":1},"children":["Create a Beneficiary (V2)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Creates a beneficiary with structured nested objects for beneficiary details, address, and bank account information."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create the LRS withdrawal beneficiary with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["category"]}," set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"payout\""]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bank_account.currency"]}," set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"INR\""]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Pass the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IFSC code"]}," in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["local_routing_number"]}," field. You do ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," need to pass a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["swift_code"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensure you include the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tax_identification_number"]}," (PAN) of the beneficiary inside the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["notes"]}," object. This is an example of a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["notes"]}," field your account may require. See the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["notes"]}," description in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/openapi/beneficiary_v2/createbeneficiaryv2"},"children":["Create a beneficiary"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Store the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," received in the response — it is passed as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["beneficiary_id"]}," in the Create a Payout API request."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"api-endpoint","__idx":2},"children":["API Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","header":{"controls":{"copy":{}}},"source":"POST https://api.glomopay.com/api/v2/beneficiaries\n","lang":"curl"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request","__idx":3},"children":["Request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","header":{"controls":{"copy":{}}},"source":"curl -i -X POST \\\n  https://api.glomopay.com/api/v2/beneficiaries \\\n  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"category\": \"payout\",\n    \"beneficiary\": {\n      \"name\": \"John Doe\",\n      \"type\": \"individual\",\n      \"address\": {\n        \"address_line1\": \"202 Swarna Residency\",\n        \"city\": \"Bengaluru\",\n        \"state\": \"Karnataka\",\n        \"country_code\": \"IND\",\n        \"postal_code\": \"560048\"\n      }\n    },\n    \"bank_account\": {\n      \"account_number\": \"XXXXXXXXXX0291\",\n      \"name\": \"HDFC Bank\",\n      \"local_routing_number\": \"HDFC0000123\",\n      \"currency\": \"INR\",\n      \"address\": {\n        \"address_line1\": \"HDFC Bank House, Senapati Bapat Marg\",\n        \"city\": \"Mumbai\",\n        \"state\": \"Maharashtra\",\n        \"country_code\": \"IND\",\n        \"postal_code\": \"400013\"\n      }\n    },\n    \"notes\": {\n      \"tax_identification_number\": \"EFEXXXX68F\"\n    }\n  }'\n","lang":"curl"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response","__idx":4},"children":["Response"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"bene_5JU9yv0lGSUP\",\n  \"name\": \"John Doe\",\n  \"type\": \"individual\",\n  \"category\": \"payout\",\n  \"status\": \"pending\",\n  \"email\": null,\n  \"phone\": null,\n  \"nickname\": null,\n  \"upi_account\": null,\n  \"created_at\": \"2025-01-15T10:00:00Z\",\n  \"updated_at\": \"2025-01-15T10:00:00Z\",\n  \"address\": {\n    \"address_line1\": \"202 Swarna Residency\",\n    \"city\": \"Bengaluru\",\n    \"state\": \"Karnataka\",\n    \"country_code\": \"IND\",\n    \"postal_code\": \"560048\"\n  },\n  \"bank_account\": {\n    \"account_number\": \"XXXXXXXXXX0291\",\n    \"name\": \"HDFC Bank\",\n    \"local_routing_number\": \"HDFC0000123\",\n    \"currency\": \"INR\",\n    \"address\": {\n      \"address_line1\": \"HDFC Bank House, Senapati Bapat Marg\",\n      \"city\": \"Mumbai\",\n      \"state\": \"Maharashtra\",\n      \"country_code\": \"IND\",\n      \"postal_code\": \"400013\"\n    }\n  },\n  \"notes\": {\n    \"tax_identification_number\": \"EFEXXXX68F\"\n  }\n}\n","lang":"curl"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-document","__idx":5},"children":["Create a Document"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Upload the user's consent to withdraw the money by calling this API. The consent is a withdrawal request letter on your company letterhead confirming the investor's withdrawal request — download the sample template here: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/assets/sample_withdrawal_request_letter.d62c9f456b925526973bb01915fdcd4d5ac377d45732314d48ac92b7ef8c134b.23b8e413.pdf"},"children":["Sample Withdrawal Request Letter"]}]},". The file is sent as binary in a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["multipart/form-data"]}," request."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," Store the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," received in the response — it is passed in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["documents"]}," array of the Create a Payout API request."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"api-endpoint-1","__idx":6},"children":["API Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","header":{"controls":{"copy":{}}},"source":"POST https://api.glomopay.com/api/v1/document\n","lang":"curl"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-1","__idx":7},"children":["Request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","header":{"controls":{"copy":{}}},"source":"curl -i -X POST \\\n  https://api.glomopay.com/api/v1/document \\\n  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \\\n  -F 'document_name=Letterhead' \\\n  -F 'file=@/path/to/Sample_Withdrawal_Request_Letter.pdf'\n","lang":"curl"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-1","__idx":8},"children":["Response"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","header":{"controls":{"copy":{}}},"source":"{\n    \"id\": \"doc_nYUqLpuYQ0M8\",\n    \"document_name\": \"Letterhead\",\n    \"file_name\": \"Letterhead_BC8tFdE.pdf\",\n    \"preview_url\": \"https://glomopay-service-staging-documents.s3.ap-south-1.amazonaws.com/12345_Letterhead\",\n    \"status\": \"uploaded\",\n    \"created_at\": \"2021-06-01T12:00:00Z\",\n    \"updated_at\": \"2021-06-01T12:00:00Z\"\n}\n","lang":"curl"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"get-a-payout-quote","__idx":9},"children":["Get a Payout Quote"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This step is optional. Use it to show the user about how much INR they will receive before you create the payout."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The quote is an estimate only. It does not lock the rate. The bank sets the actual amount when it processes the batch."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["You cannot attach this quote to a payout."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"api-endpoint-2","__idx":10},"children":["API Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","header":{"controls":{"copy":{}}},"source":"POST https://api.glomopay.com/api/v1/lrs/quotes\n","lang":"curl"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-2","__idx":11},"children":["Request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","header":{"controls":{"copy":{}}},"source":"curl -i -X POST \\\n  https://api.glomopay.com/api/v1/lrs/quotes \\\n  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"resource\": \"payout\",\n    \"source_amount\": 1000000,\n    \"source_currency\": \"USD\",\n    \"target_currency\": \"INR\"\n  }'\n","lang":"curl"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-2","__idx":12},"children":["Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["201"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"quote_6ab51084HiJPg\",\n  \"from\": {\n    \"amount\": 1000000,\n    \"currency\": \"USD\"\n  },\n  \"to\": {\n    \"amount\": 93142106,\n    \"currency\": \"INR\"\n  },\n  \"fx_rate\": \"94.13\",\n  \"total_tax\": 46594,\n  \"expires_at\": \"2026-09-24T12:29:00.819Z\",\n  \"created_at\": \"2026-09-24T11:59:00.822Z\"\n}\n","lang":"curl"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["to.amount"]}," is the estimated INR after fees, conversion and tax, in paisa."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total_tax"]}," is the estimated GST, in paisa."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fx_rate"]}," is the bank's USD to INR buy rate when the quote was made."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," This quote is an estimate."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"errors","__idx":13},"children":["Errors"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Validation failed: Bank code is not supported for payout quotes"]},". You sent ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bank_code"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Validation failed: payout quotes are only supported from USD to INR"]},". The currency pair is not USD to INR."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["422"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["No active exchange rate found"]},". No rate is available right now."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-payout","__idx":14},"children":["Create a Payout"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Initiate the withdrawal by creating a payout to the beneficiary, referencing the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["beneficiary_id"]}," and the uploaded document ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},"."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For the LRS withdrawal flow, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["source_currency"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"USD\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destination_currency"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"INR\""]},", and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_rail"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"neft\""]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["All amounts are expressed in the smallest unit of the currency (e.g., cents for USD, paisa for INR). For example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["100000"]}," represents $1,000.00 in USD."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_id"]}," is a client-provided unique identifier for the payout. A payout with a duplicate ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_id"]}," is rejected with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["409"]}," error."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"api-endpoint-3","__idx":15},"children":["API Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","header":{"controls":{"copy":{}}},"source":"POST https://api.glomopay.com/api/v1/payouts\n","lang":"curl"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-3","__idx":16},"children":["Request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","header":{"controls":{"copy":{}}},"source":"curl -i -X POST \\\n  https://api.glomopay.com/api/v1/payouts \\\n  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"purpose_code\": \"P0001\",\n    \"beneficiary_id\": \"bene_a1b2c3d4e5\",\n    \"source_currency\": \"USD\",\n    \"destination_currency\": \"INR\",\n    \"source_amount\": 10000,\n    \"payment_rail\": \"neft\",\n    \"invoice_number\": \"INV-2026-001\",\n    \"request_id\": \"req-7f3a9c20\",\n    \"documents\": [\"doc_11aa22bb33\"],\n    \"notes\": {\n      \"internal_ref\": \"batch-42\"\n    }\n  }'\n","lang":"curl"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-3","__idx":17},"children":["Response"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","header":{"controls":{"copy":{}}},"source":"{\n    \"id\": \"payout_6a7c51772CX2A\",\n    \"beneficiary_id\": \"bene_6a7061db3UDRq\",\n    \"destination_amount\": null,\n    \"destination_currency\": \"INR\",\n    \"source_currency\": \"USD\",\n    \"source_amount\": 10000,\n    \"purpose_code\": \"P0001\",\n    \"status\": \"in_progress\",\n    \"fees\": {\n        \"txn_fee\": {\n            \"currency\": \"USD\",\n            \"amount\": 0\n        },\n        \"fx_fee\": {\n            \"currency\": \"USD\",\n            \"amount\": 0\n        }\n    },\n    \"mid_market_rate\": {\n        \"currency\": null,\n        \"rate\": null\n    },\n    \"documents\": [],\n    \"utr\": null,\n    \"created_at\": \"2026-08-11T05:27:16Z\",\n    \"updated_at\": \"2026-08-11T05:27:17Z\",\n    \"receipt_ids\": [],\n    \"fee_collection_mode\": \"deferred\",\n    \"request_id\": \"2026-08-11T05:27:10.995Z\",\n    \"payment_rail\": \"neft\",\n    \"invoice_number\": null,\n    \"notes\": null,\n    \"error_code\": null,\n    \"error_description\": null,\n    \"customer_error_description\": null,\n    \"quote_id\": null,\n    \"taxes\": [],\n    \"estimated_credit_date\": \"2026-08-13\"\n}\n","lang":"curl"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"payout-success","__idx":18},"children":["Payout Success"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the bank has processed the payout, its status changes to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["success"]},"."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," The values of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destination_amount"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mid_market_rate"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxes"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["utr"]}," are only finalized once the payout status is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["success"]},". Once the payout succeeds, these values are delivered via the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payout"]}," webhook, and can also be fetched by polling ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/openapi/payout/getpayoutbyid"},"children":["Retrieve a Payout"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-4","__idx":19},"children":["Response"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"payout_6a7c51772CX2A\",\n  \"beneficiary_id\": \"bene_6a7061db3UDRq\",\n  \"destination_amount\": 946700,\n  \"destination_currency\": \"INR\",\n  \"source_currency\": \"USD\",\n  \"source_amount\": 10000,\n  \"purpose_code\": \"P0001\",\n  \"status\": \"success\",\n  \"fees\": {\n    \"txn_fee\": {\n      \"currency\": \"USD\",\n      \"amount\": 0\n    },\n    \"fx_fee\": {\n      \"currency\": \"USD\",\n      \"amount\": 0\n    }\n  },\n  \"mid_market_rate\": {\n    \"currency\": \"INR\",\n    \"rate\": 96.67\n  },\n  \"documents\": [],\n  \"utr\": \"AXISN1234567890\",\n  \"created_at\": \"2026-08-12T10:56:55Z\",\n  \"updated_at\": \"2026-08-12T10:56:56Z\",\n  \"receipt_ids\": [],\n  \"fee_collection_mode\": \"immediate\",\n  \"request_id\": \"Glomo6\",\n  \"payment_rail\": \"neft\",\n  \"invoice_number\": null,\n  \"notes\": null,\n  \"error_code\": null,\n  \"error_description\": null,\n  \"customer_error_description\": null,\n  \"quote_id\": null,\n  \"taxes\": [\n    {\n      \"name\": \"GST\",\n      \"amount\": 20000,\n      \"currency\": \"INR\",\n      \"bps\": 1800\n    }\n  ],\n  \"estimated_credit_date\": \"2026-08-17\"\n}\n","lang":"curl"},"children":[]}]},"headings":[{"value":"Withdraw an LRS remittance back to the investor","id":"withdraw-an-lrs-remittance-back-to-the-investor","depth":1},{"value":"Create a Beneficiary (V2)","id":"create-a-beneficiary-v2","depth":2},{"value":"API Endpoint","id":"api-endpoint","depth":3},{"value":"Request","id":"request","depth":3},{"value":"Response","id":"response","depth":3},{"value":"Create a Document","id":"create-a-document","depth":2},{"value":"API Endpoint","id":"api-endpoint-1","depth":3},{"value":"Request","id":"request-1","depth":3},{"value":"Response","id":"response-1","depth":3},{"value":"Get a Payout Quote","id":"get-a-payout-quote","depth":2},{"value":"API Endpoint","id":"api-endpoint-2","depth":3},{"value":"Request","id":"request-2","depth":3},{"value":"Response","id":"response-2","depth":3},{"value":"Errors","id":"errors","depth":3},{"value":"Create a Payout","id":"create-a-payout","depth":2},{"value":"API Endpoint","id":"api-endpoint-3","depth":3},{"value":"Request","id":"request-3","depth":3},{"value":"Response","id":"response-3","depth":3},{"value":"Payout Success","id":"payout-success","depth":2},{"value":"Response","id":"response-4","depth":3}],"frontmatter":{"title":"Withdraw an LRS remittance back to the investor","description":"Return overseas investment proceeds to a resident Indian investor - create a beneficiary, upload consent, get a quote (optional), create the payout, and reconcile on success.","seo":{"title":"Withdraw an LRS remittance back to the investor"}},"lastModified":"2026-10-08T11:22:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/payin/resident-india-remittance-under-lrs/set-up/withdrawal-flow-guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}