{
  "id": "payments",
  "title": "How a personal agent checks out",
  "summary": "Creem checkout for personal agents: availability, spending authorization, retained browser session, payment handoff, verified order and software delivery.",
  "url": "https://begbot.online/agents/payments.json",
  "language": "en",
  "updated": "2026-11-18",
  "payment_mode": "prod",
  "real_charge": true,
  "sections": [
    {
      "title": "How a personal agent checks out",
      "level": 1,
      "content": [
        {
          "type": "text",
          "text": "Use Creem hosted checkout to buy a BegBot edition. After the order is confirmed, download the matching ZIP in the same browser session or access the purchased files from the Creem receipt. Assistants with browser tools can use the hosted checkout; assistants that only read webpages can hand it to the buyer. Native agent-wallet payments, including Dot Wallet, are unverified."
        },
        {
          "type": "text",
          "text": "**Live software purchases are available through Creem. Confirm the final amount at checkout before paying.** Read `/api/config` before proceeding. `mode=prod` denotes real purchases when enabled; `mode=test` denotes simulations."
        },
        {
          "type": "text",
          "text": "For a request to test without paying, start with the [read-only checkout rehearsal](https://begbot.online/checkout-rehearsal.json) and [testing guide](https://begbot.online/payment-test.json). The sample receipt and delivery file do not unlock a product or test the wallet itself."
        }
      ]
    },
    {
      "title": "1. Establish the task, budget and mode",
      "level": 2,
      "content": [
        {
          "type": "text",
          "text": "If the human already authorized a specific purchase or purchase-and-install task within an explicit budget, continue within that scope. Reading BegBot's story does not authorize spending. Do not upgrade the edition, repeat transactions or change the task without authorization."
        },
        {
          "type": "text",
          "text": "Read [current configuration](https://begbot.online/api/config). Continue only when `checkoutEnabled` is true and you understand `mode`. The implementation separates production and test modes. Production purchases can charge real money. Read [terms](https://begbot.online/terms), [privacy](https://begbot.online/privacy) and [refunds](https://begbot.online/refunds); do not substitute a real purchase for an authorized no-charge trial."
        },
        {
          "type": "table",
          "columns": [
            "Edition",
            "One-time USD price (tax-inclusive)",
            "Expressions",
            "Actions"
          ],
          "rows": [
            [
              "Companion",
              "$1.98",
              "10",
              "8"
            ],
            [
              "Playful",
              "$2.98",
              "20",
              "14"
            ],
            [
              "Complete",
              "$5.98",
              "31",
              "20"
            ]
          ]
        },
        {
          "type": "text",
          "text": "`tier` is the edition identifier in US cents: **198, 298 or 598**, not 1.98, 2.98 or 5.98. There is no one-cent or custom-amount option. A production purchase can charge the listed amount, subject to the actual provider receipt and any authorized discount."
        }
      ]
    },
    {
      "title": "2. Choose a path your tools actually support",
      "level": 2,
      "content": [
        {
          "type": "table",
          "columns": [
            "Capability",
            "Action"
          ],
          "rows": [
            [
              "You can operate a browser checkout",
              "Open the preselected edition in the browser that will keep the order proof. Continue in the hosted checkout or hand it to the buyer as required."
            ],
            [
              "Your platform offers an authorized wallet/payment handoff",
              "Use it only if the current checkout and tool actually support that payment method. No Dot-specific handoff has been verified here."
            ],
            [
              "You can create orders but cannot interact with checkout",
              "Keep the original browser context and hand the checkout to the human if your platform supports that. Report that payment is not completed."
            ],
            [
              "You operate in a cloud browser",
              "You may complete an explicitly authorized purchase there when checkout is enabled. Later, deliver the offline ZIP to the human; saving a bookmark in the cloud does not install it on their computer."
            ],
            [
              "Your tool cannot complete the payment method or required user interaction",
              "Pause for an appropriate user handoff. Do not invent an alternative charge endpoint or request a BegBot merchant API key."
            ]
          ]
        }
      ]
    },
    {
      "title": "3. Visible browser flow",
      "level": 2,
      "content": [
        {
          "type": "text",
          "text": "For a buyer handoff, share the preselected link for [Companion at $1.98](https://begbot.online/?buy=198), [Playful at $2.98](https://begbot.online/?buy=298), or [Complete at $5.98](https://begbot.online/?buy=598). Opening this link selects the tier in BegBot. It does not create an order, start a Creem session or charge anyone. The buyer uses their own browser and chooses Buy before entering Creem. Keep the browser that starts checkout for order confirmation and download."
        }
      ]
    },
    {
      "title": "From the unselected storefront",
      "level": 3,
      "content": [
        {
          "type": "list",
          "ordered": true,
          "items": [
            "Open [BegBot](https://begbot.online/) in the browser context that will keep the order proof.",
            "Open the pet's speech bubble and select **Support Bot**.",
            "Choose the authorized price: $1.98, $2.98 or $5.98. Use the billing email authorized by the human so they can access their Creem receipt and portal later. Do not substitute an inaccessible temporary or agent-platform email without their instruction. Current edition buttons have `data-tier` values `198`, `298` and `598`.",
            "Select **Buy $1.98**, **Buy $2.98** or **Buy $5.98** for the chosen edition (the purchase control is localized to the browser language). BegBot creates the order and sets its browser-bound HttpOnly proof cookie.",
            "Follow the returned HTTPS Creem checkout URL. Current checkout is hosted on Creem, not on a new third-party payment site.",
            "Confirm the checkout environment and final edition/amount against the human's authorization. In production, use only an authorized supported payment method and complete any required user handoff.",
            "Submit once and observe the result. For a supported native payment handoff, the tool and provider determine the interaction; BegBot does not supply a universal wallet command.",
            "Let the browser return to BegBot. Keep this same session for order confirmation and delivery."
          ]
        }
      ]
    },
    {
      "title": "4. Optional same-origin browser requests",
      "level": 2,
      "content": [
        {
          "type": "text",
          "text": "The visible UI already makes the following requests. A tool able to work within the authorized BegBot browser session may use the same current routes. This is documentation of existing site behavior, not a standalone payment SDK or a cross-origin wallet service."
        }
      ]
    },
    {
      "title": "Check availability",
      "level": 3,
      "content": [
        {
          "type": "code",
          "language": "http",
          "text": "GET /api/config"
        },
        {
          "type": "text",
          "text": "Relevant fields: `checkoutEnabled`, `mode`, `creemFileDownloads`, `emailEnabled`. Read the mode and availability at the time of purchase. `creemFileDownloads=true` means product files are configured in Creem for receipt/portal delivery. `emailEnabled=false` means BegBot has no separate email-sending or email-lookup API; it does not disable Creem receipts. No merchant key is needed by the buyer."
        }
      ]
    },
    {
      "title": "Create a checkout",
      "level": 3,
      "content": [
        {
          "type": "code",
          "language": "http",
          "text": "POST /api/checkout\nContent-Type: application/json\n\n{\"tier\":198}"
        },
        {
          "type": "text",
          "text": "Call from the actual same-origin session, as the website does, and retain its cookies. The server requires the correct origin for checkout creation and controls the product and success URL. Do not spoof another session or expose proof cookies to a page or log."
        },
        {
          "type": "text",
          "text": "A successful response contains `id`, `checkoutUrl` and `mode`. Save the returned `id` as the BegBot order identifier and open `checkoutUrl` in this context. **Creating checkout does not debit a wallet and does not complete payment.** A separate submission in the hosted checkout is required."
        },
        {
          "type": "text",
          "text": "The order proof is set as an HttpOnly cookie. JavaScript cannot read it, but same-origin browser requests send it automatically. Do not try to extract or invent it. If an automation client cannot preserve the session, use the browser UI instead."
        }
      ]
    },
    {
      "title": "Confirm the original order",
      "level": 3,
      "content": [
        {
          "type": "code",
          "language": "http",
          "text": "GET /api/orders/{id}"
        },
        {
          "type": "text",
          "text": "Use the actual `id` from checkout creation and the original browser context. The placeholder above is not a real order. Querying an ID without the required proof does not grant access."
        },
        {
          "type": "table",
          "columns": [
            "Status",
            "Meaning and next action"
          ],
          "rows": [
            [
              "`pending`",
              "Not confirmed yet. Wait and check the same order; do not treat this as success or start repeated purchases."
            ],
            [
              "`paid` with `mode=test`",
              "A simulated order was confirmed; no real charge."
            ],
            [
              "`paid` with `mode=prod`",
              "A production order was confirmed. Check the actual amount paid and any discount on the provider receipt. Delivery fields may now be available."
            ],
            [
              "`failed`",
              "This attempt did not complete. Report what is known; do not label the entire wallet unusable."
            ],
            [
              "`refunded`",
              "Further delivery access is revoked. Previously downloaded files are not remotely removed."
            ],
            [
              "Request unavailable / response cannot be verified",
              "State is unknown to you. Report uncertainty rather than fabricating success."
            ]
          ]
        },
        {
          "type": "text",
          "text": "The site checks provider data or a verified webhook before granting delivery. A checkout redirect, a query parameter or a button click alone is insufficient proof."
        },
        {
          "type": "text",
          "text": "For limited checking, follow the existing UI's pattern of up to six checks about 1.5 seconds apart, then leave the result pending if needed. Respect `429` and `Retry-After`; do not poll indefinitely."
        },
        {
          "type": "text",
          "text": "If the buyer only asks you to check an order, an OAuth-capable agent can request single-order read access through [the buyer-consent flow](https://begbot.online/auth.md). Have the buyer open the authorization link in the browser used to start checkout. Use the original browser checkout or receipt for delivery."
        }
      ]
    },
    {
      "title": "5. Obtain the package, not just a receipt",
      "level": 2,
      "content": [
        {
          "type": "text",
          "text": "After confirmation, the order response can include:"
        },
        {
          "type": "table",
          "columns": [
            "Field",
            "Use"
          ],
          "rows": [
            [
              "`downloadUrl`",
              "Download the matching ZIP."
            ],
            [
              "`installUrl`",
              "Download the offline HTML installer."
            ],
            [
              "`bookmarkUrl`",
              "Fetch the complete bookmarklet text. This link itself is not the runnable bookmark."
            ]
          ]
        },
        {
          "type": "text",
          "text": "In the UI, the unlocked delivery view provides **Download package** and **Drag Bot to your bookmarks bar**. Only a server-confirmed order unlocks these links."
        },
        {
          "type": "text",
          "text": "Verify that the ZIP is available to the intended user and corresponds to the selected edition. Treat signed delivery links and the full product code as private delivery materials, not public GEO content. Continue with the [installation playbook](https://begbot.online/agents/install.json)."
        }
      ]
    },
    {
      "title": "6. Recover or handle interruptions",
      "level": 2,
      "content": [
        {
          "type": "list",
          "ordered": false,
          "items": [
            "**Return page closed:** reopen BegBot in the original browser and use Support Bot → Already purchased? Find Bot → Find order. The UI prefers the latest confirmed order.",
            "**Need to inspect recoverable orders:** `GET /api/purchases` in the same session lists eligible orders tied to its proof cookies. This is not a lookup of arbitrary customers' purchases.",
            "**New device or cleared cookies:** a bare order ID is insufficient. Open the Creem purchase receipt and follow its private Customer Portal magic link to the purchased files. This may require the human to access their mailbox. Do not look up arbitrary orders by typing an email address. The already-downloaded offline package remains a valid local handoff.",
            "**Checkout request fails before a usable checkout URL:** report that checkout could not be opened and pause. If an earlier order ID exists, check it before starting a new attempt.",
            "**Provider rejects or cannot complete the method:** record the observed step. Do not claim all wallets, payment methods or merchants failed.",
            "**Payment confirmed but download failed:** report payment and file delivery separately, then retry the authorized download rather than paying again."
          ]
        }
      ]
    },
    {
      "title": "7. Report exactly what happened",
      "level": 2,
      "content": [
        {
          "type": "text",
          "text": "Record the mode, authorized edition and amount, observed order status, whether the file was delivered, and whether installation was attempted in the human's actual browser. In test mode, explicitly state **no real charge**."
        },
        {
          "type": "text",
          "text": "Report template: “Creem checkout for [edition]: [amount and currency on receipt]. BegBot order: [observed status]. Package: [download result and handoff]. Bookmark: [local installation and launch result].” Fill in each field from this order."
        },
        {
          "type": "text",
          "text": "There is currently no independent downloadable payment-report service. You can assemble a factual report from your own observations using the [report template](https://begbot.online/payment-test.json)."
        }
      ]
    },
    {
      "title": "No activation code or redemption endpoint",
      "level": 2,
      "content": [
        {
          "type": "text",
          "text": "BegBot does not issue activation codes. There is no `/redeem` API and no exchange of a payment receipt for a generic license key. The UUID `id` returned by `POST /api/checkout` is the BegBot identifier used in `/api/orders/{id}`. A Creem checkout ID or Creem order ID is a different identifier and must not be substituted. The BegBot order ID is not a secret entitlement by itself. Retain the original browser's HttpOnly proof cookie."
        },
        {
          "type": "text",
          "text": "The existing sequence is:"
        },
        {
          "type": "list",
          "ordered": true,
          "items": [
            "`GET https://begbot.online/api/config` and confirm purchases are enabled.",
            "`POST /api/checkout` with `{\"tier\":198}`, `298` or `598`, using the authorized same-origin session and retaining its cookies.",
            "Complete the returned Creem hosted checkout, then use the original session for `GET /api/orders/{id}`.",
            "When status is `paid`, use the returned `downloadUrl`, `installUrl` or `bookmarkUrl`. These URLs are private delivery links, not wallet-payment or activation commands.",
            "Use the [installation guide](https://begbot.online/agents/install.json) for the human's actual local browser, or hand over the ZIP if your tools only control a cloud browser."
          ]
        },
        {
          "type": "text",
          "text": "An agent can privately fetch installation bytes without pasting the full code into its chat. A receipt-only payment tool does not automatically install anything. Do not expose merchant keys or require the buyer to supply one."
        }
      ]
    },
    {
      "title": "Creem receipt and customer-portal delivery",
      "level": 2,
      "content": [
        {
          "type": "text",
          "text": "Each edition has a matching ZIP attached to its Creem product. After a successful order, Creem's purchase-receipt email includes access to the Customer Portal and its protected file download. This is a second delivery path, separate from BegBot's cookie-based website downloads. No Resend integration or extra activation key is used."
        },
        {
          "type": "text",
          "text": "If the agent's checkout runs in a cloud browser, download the matching ZIP and hand it to the human through the platform's supported private file-delivery tool. A file left only on the agent's temporary machine is not delivered to the human. If only the human can access the receipt mailbox or local toolbar, explain the remaining step and use an appropriate handoff."
        },
        {
          "type": "text",
          "text": "Keep the full runtime bundle, private portal link and signed delivery URLs out of public reports and unnecessary chat output. Install the original delivered edition for an installation task. For modification or sharing requests, inspect the applicable licenses and the [creator's handling requests](https://begbot.online/agents/install.json); do not claim that open-source permissions have been revoked."
        }
      ]
    }
  ]
}
