{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Resolving Action Required Payments","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":"resolving-action-required-payments","__idx":0},"children":["Resolving Action Required Payments"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When an incoming bank transfer cannot be automatically matched to an existing order or payment link, the payment enters an \"Action Required\" state. This guide explains how to identify the type of action required and resolve it."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"types-of-action-required-payments","__idx":2},"children":["Types of Action Required Payments"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"actionable-you-can-resolve-these","__idx":3},"children":["Actionable (You Can Resolve These)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These payments show a \"Find Matching Payin\" button in the top-right corner of the payment details screen."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"1-unmatched-payment-payin-not-found","__idx":4},"children":["1. Unmatched Payment (Payin Not Found)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The incoming bank transfer could not be automatically matched to any existing order or payment link. You will see a yellow banner: \"Unmatched payment. This incoming bank transfer could not be automatically matched to an existing order or payment link.\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/unmatched-payment.f2f983bf1055f27286a59337294a1b1047c03515fd044ef8326de4ba035834c1.b1ca6591.png","alt":"Unmatched payment — Action required screen with Find Matching Payin button"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"2-amount-mismatch","__idx":5},"children":["2. Amount Mismatch"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The received amount does not match the original order amount. You will see a yellow banner: \"Amount mismatch detected. The received amount does not match the original order amount.\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/amount-mismatch.cac121478c096b28f548de54672a60a922b6ab1499302a02b0285f93a687ebc6.b1ca6591.png","alt":"Amount mismatch — Action required screen"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"non-actionable-contact-support","__idx":6},"children":["Non-Actionable (Contact Support)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For all other action required reasons (e.g., additional verification required), you will see a message directing you to contact support@glomopay.com. The \"Find Matching Payin\" button will not be visible for these cases."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/non-actionable-contact-support.25fbcb653ba56eab9daae8a12da5afaa0291ed875e69b3530cbc2300c4d360bc.b1ca6591.png","alt":"Non-actionable — Contact support message"},"children":[]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-to-resolve-actionable-payments","__idx":7},"children":["How to Resolve Actionable Payments"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1-open-the-payment-details","__idx":8},"children":["Step 1: Open the Payment Details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Navigate to the payment that is in \"Action Required\" state. You will see the payment summary, amount, sender details, and the reason for the hold."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2-click-find-matching-payin","__idx":9},"children":["Step 2: Click \"Find Matching Payin\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click the \"Find Matching Payin\" button in the top-right corner. A dialog will open showing:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Left panel"]}," — Incoming payment details: amount, sender name, sender account number, received date, and payment ID."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Right panel"]}," — A list of eligible payment links/orders that match the payment amount and currency."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/match-payment-to-payin-dialog.6241e5046e704ca31fd12862a423f67e4f25627abe37d304a377777e6fe02c65.b1ca6591.png","alt":"Match payment to payin dialog showing eligible payins"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-3-filter-results-if-needed","__idx":10},"children":["Step 3: Filter Results (If Needed)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If there are many eligible payins, use the filter dropdown and search bar at the top of the dialog to narrow results by:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customer ID"]}," — Filter by exact customer ID"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Invoice Number"]}," — Filter by invoice number"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reference Number"]}," — Filter by reference number"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select the filter type from the dropdown, enter the value, and click Search."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/filter-eligible-payins.19da0a708a7949122dbea39e6dcd28be0f9ace80023ebbd84e49f67d952c4d6b.b1ca6591.png","alt":"Filtering eligible payins by invoice number"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-4-select-a-payin-and-review","__idx":11},"children":["Step 4: Select a Payin and Review"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Choose the correct payment link or order from the list. Each payin card displays the following fields:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payin ID"]}," — The unique identifier for the payment link or order (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["plink_69cb95b0DffDK"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Amount & Currency"]}," — The expected payment amount (e.g., 18.00 USD)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customer Name"]}," — The name of the customer associated with the payin."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Email"]}," — The customer's email address."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Invoice Number"]}," — The invoice number linked to the payin (e.g., RG12FF590). Displayed if available."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reference Number"]}," — The reference number associated with the payin (e.g., R0001). Displayed if available."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Type Badge"]}," — Indicates whether the entry is a Payment link or an Order."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," Invoice Number and Reference Number are only shown on the card when they have been provided for that payin. Not all payins will display these fields."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click \"Review Match\" to proceed. A review screen will appear showing the payment details and the selected payin side by side. Verify that the details are correct, then click \"Confirm Match\" to complete the matching."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/review-match-screen.3c1ee3d60b9f9b93c8837423f5a928aab44ec68c52203cdd17005c2e3e312dc7.b1ca6591.png","alt":"Review match screen — Payment and payin details side by side"},"children":[]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-if-no-eligible-payins-are-found","__idx":12},"children":["What If No Eligible Payins Are Found?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the dialog shows \"No eligible payment links or orders found\", it means there is no active payment link or order with a matching amount for this payment."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/no-eligible-payins-found.1a0c86a9a48201297b2e28d04ca28ebb6e0e4906534a3f9736238f00b009de8d.b1ca6591.png","alt":"No eligible payment links or orders found"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["To resolve this:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a new payment link or order with the same amount and currency as the stuck payment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Return to the action required payment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click \"Find Matching Payin\" again — the newly created payin will now appear in the eligible list."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select it, review, and confirm the match."]}]}]},"headings":[{"value":"Resolving Action Required Payments","id":"resolving-action-required-payments","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Types of Action Required Payments","id":"types-of-action-required-payments","depth":2},{"value":"Actionable (You Can Resolve These)","id":"actionable-you-can-resolve-these","depth":3},{"value":"1. Unmatched Payment (Payin Not Found)","id":"1-unmatched-payment-payin-not-found","depth":4},{"value":"2. Amount Mismatch","id":"2-amount-mismatch","depth":4},{"value":"Non-Actionable (Contact Support)","id":"non-actionable-contact-support","depth":3},{"value":"How to Resolve Actionable Payments","id":"how-to-resolve-actionable-payments","depth":2},{"value":"Step 1: Open the Payment Details","id":"step-1-open-the-payment-details","depth":3},{"value":"Step 2: Click \"Find Matching Payin\"","id":"step-2-click-find-matching-payin","depth":3},{"value":"Step 3: Filter Results (If Needed)","id":"step-3-filter-results-if-needed","depth":3},{"value":"Step 4: Select a Payin and Review","id":"step-4-select-a-payin-and-review","depth":3},{"value":"What If No Eligible Payins Are Found?","id":"what-if-no-eligible-payins-are-found","depth":2}],"frontmatter":{"title":"Resolving Action Required Payments","seo":{"title":"Resolving Action Required Payments"}},"lastModified":"2026-09-22T05:15:29.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/payin/action-required","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}