{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["steps","typography"]},"type":"markdown"},"seo":{"title":"Fixed Frquency Subscriptions","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":2,"id":"fixed-frquency-subscriptions","__idx":0},"children":["Fixed Frquency Subscriptions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fixed-Frequency Subscriptions are designed for businesses that charge customers on a predictable, recurring schedule - such as monthly, quarterly, or yearly. With fixed-frequency subscriptions, Glomo automatically initiates payments based on the configured billing cycle, removing the need for manual intervention while ensuring reliable and timely collections. This model is ideal for businesses offering SaaS products, memberships, subscriptions, or installment-based services with consistent billing intervals."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-fixed-frequency-subscriptions-work","__idx":1},"children":["How Fixed-Frequency Subscriptions Work"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Merchant creates a subscription with a defined billing frequency and schedule."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Customer completes the first payment or authorization on Glomo checkout."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Glomo securely stores the customer’s payment method."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Glomo automatically charges the customer on each scheduled billing date."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Subscription continues until completed, paused, halted, or cancelled."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"steps-to-create-a-subscription","__idx":2},"children":["Steps to Create a Subscription"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can create a subscription directly from the Glomopay dashboard. Here’s how:"]},{"$$mdtype":"Tag","name":"Steps","attributes":{"steps":["Go to the Dashboard. Navigate to the **Subscriptions** section.","Click “**Create Subscription**”","Select **customer**","Define **Amount**, **Billing Frequency**, **Billing Interval**, **Start Date**, **Number of Billing Cycles**(if applicable).","Create the subscription and share the **payment link** with the customer."]},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"via-api","__idx":3},"children":["Via API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"curl -i -X POST \\\n  https://api.glomopay.com/api/v1/subscriptions \\\n  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"customer_id\": \"cust_5JU9yv0lGSUP\",\n    \"product_name\": \"ShieldGuard Insurance\",\n    \"product_description\": \"Flexible, monthly insurance for belongings, travel, and digital assets; easy to manage\",\n    \"plan_name\": \"ShieldGuard Lite\",\n    \"plan_description\": \"Simple, monthly insurance plan that covers your basic belongings and key digital assets\",\n    \"amount\": 1000,\n    \"currency\": \"USD\",\n    \"interval_type\": \"month\",\n    \"interval_count\": 1,\n    \"billing_cycles\": 12,\n    \"start_date\": \"2025-01-01\",\n    \"expires_at\": \"2025-01-07\",\n    \"notify_customer\": true,\n    \"notes\": {\n      \"key1\": \"value1\",\n      \"key2\": \"value2\"\n    },\n    \"reference_number\": \"R0001\",\n    \"starts_with_first_payment\": true\n  }'\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pre-authorization-with-future-start-date","__idx":4},"children":["Pre-Authorization with Future Start Date"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fixed-Frequency Subscriptions support pre-authorization, allowing customers to approve future recurring payments ahead of time."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-it-works","__idx":5},"children":["How It Works"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Merchant sets a future start date during subscription creation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Customer completes checkout immediately."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Glomo stores the authorized payment method securely."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The first charge occurs automatically on the configured start date."]}]},{"$$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":"State"},"children":["State"]},{"$$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":"Typography","attributes":{"fontColor":"#4958AC"},"children":[" Created "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Subscription is created by the merchant. No payment has been made yet."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Typography","attributes":{"fontColor":"#4958AC"},"children":[" Authorized "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The user has successfully set up the subscription. Recurring payments will start on the scheduled date."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Typography","attributes":{"fontColor":"#4958AC"},"children":[" Active "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Subscription is active after the first successful payment, or resumed after a pause. Recurring billing continues."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Typography","attributes":{"fontColor":"#B75906"},"children":[" Paused "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Subscription is paused by the merchant. No further payments will be charged 
until resumed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Typography","attributes":{"fontColor":"#008A5A"},"children":[" Completed "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The subscription has run its full billing cycle and is now complete."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Typography","attributes":{"fontColor":"#BC1919"},"children":[" Expired "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The customer didn’t complete payment before the link expired. The subscription is no longer valid."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Typography","attributes":{"fontColor":"#BC1919"},"children":[" Halted "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A scheduled payment failed (after retries). Subscription is paused pending manual reactivation."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Typography","attributes":{"fontColor":"#BC1919"},"children":[" Cancelled "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Subscription is cancelled by the merchant. No further billing will occur."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-to-use","__idx":6},"children":["When to Use"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this feature when:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You’ve collected the first payment and want the next charge to align with the policy start or renewal date."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A customer has requested a short deferral of their next billing date."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You want to maintain consistent billing intervals while preserving the subscription lifecycle."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Avoid using this feature to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Change subscription frequency (e.g., monthly → quarterly)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Modify the billing amount."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retry a failed payment use the retry mechanism instead."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"dashboard-flow","__idx":7},"children":["Dashboard Flow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can create a subscription directly from the Glomopay dashboard. Here's how:"]},{"$$mdtype":"Tag","name":"Steps","attributes":{"steps":["Navigate to **Subscriptions** → Subscription Details.","Click **“Update Next Payment Date”** (visible only for active subscriptions)","A confirmation modal appears:\n  - Displays the **current date**.\n  - Allows selection of a **new future date** (within 28-day window)","**Confirm** the update."]},"children":[]}]},"headings":[{"value":"Fixed Frquency Subscriptions","id":"fixed-frquency-subscriptions","depth":2},{"value":"How Fixed-Frequency Subscriptions Work","id":"how-fixed-frequency-subscriptions-work","depth":3},{"value":"Steps to Create a Subscription","id":"steps-to-create-a-subscription","depth":2},{"value":"Via API","id":"via-api","depth":3},{"value":"Pre-Authorization with Future Start Date","id":"pre-authorization-with-future-start-date","depth":2},{"value":"How It Works","id":"how-it-works","depth":3},{"value":"When to Use","id":"when-to-use","depth":2},{"value":"Dashboard Flow","id":"dashboard-flow","depth":2}],"frontmatter":{"title":"Fixed frequency subscriptions","steps":["Go to the Dashboard. Navigate to the **Subscriptions** section.","Click “**Create Subscription**”","Select **customer**","Define **Amount**, **Billing Frequency**, **Billing Interval**, **Start Date**, **Number of Billing Cycles**(if applicable).","Create the subscription and share the **payment link** with the customer."],"steps_to_update_next_payment_date_subscription":["Navigate to **Subscriptions** → Subscription Details.","Click **“Update Next Payment Date”** (visible only for active subscriptions)","A confirmation modal appears:\n  - Displays the **current date**.\n  - Allows selection of a **new future date** (within 28-day window)","**Confirm** the update."],"seo":{"title":"Fixed Frquency Subscriptions"}},"lastModified":"2026-09-22T05:15:29.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/payin/subscriptions/fixed-frequency-subscriptions","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}