{
  "schemaVersion": "1.0",
  "item": {
    "slug": "pay-bills",
    "name": "Pay Bills",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/h1rdr3v2/pay-bills",
    "canonicalUrl": "https://clawhub.ai/h1rdr3v2/pay-bills",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/pay-bills",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=pay-bills",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "session-token.js",
      "skill.md",
      "generate-order-id.js",
      "generate-device-id.js"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/pay-bills"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/pay-bills",
    "agentPageUrl": "https://openagent3.xyz/skills/pay-bills/agent",
    "manifestUrl": "https://openagent3.xyz/skills/pay-bills/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/pay-bills/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "SKILL.md — CreditWithBleon API",
        "body": "Buy data, airtime, and digital products for Nigerian phone numbers via wallet balance.\n\nBase URL: https://lodu.bleon.net/v1"
      },
      {
        "title": "Helper Scripts",
        "body": "These Node.js scripts live in the pay-bills-skill/ directory. Run them with node to generate IDs and manage auth state.\n\nScriptCommandPurposegenerate-order-id.jsnode pay-bills-skill/generate-order-id.jsOutputs a unique ORDER_<timestamp>_<random> string. Use this as trx_id for every order — never hardcode or reuse a trx_id.generate-device-id.jsnode pay-bills-skill/generate-device-id.js [userId]Outputs a device ID. With userId: openclaw_<userId>. Use as deviceId in auth requests.session-token.jssee belowManages the session token for auth."
      },
      {
        "title": "Session Token Commands",
        "body": "node pay-bills-skill/session-token.js check              → { \"loggedIn\": true/false, \"sessionToken\": \"...\" | null }\nnode pay-bills-skill/session-token.js save <token>       → saves the token to .session_token\nnode pay-bills-skill/session-token.js load               → prints the saved token (exit 1 if none)\nnode pay-bills-skill/session-token.js clear              → deletes the saved token (logout)"
      },
      {
        "title": "Workflow",
        "body": "Before any [auth] request: run node pay-bills-skill/session-token.js check to see if a session token exists.\n\nIf loggedIn: true → use the sessionToken value as Authorization: Bearer <sessionToken>.\nIf loggedIn: false → start the login flow (see Auth below).\n\n\nAfter a successful login (steps that return sessionToken): run node pay-bills-skill/session-token.js save <sessionToken> to persist it.\nBefore placing an order: run node pay-bills-skill/generate-order-id.js to get a fresh trx_id.\nFor auth requests: run node pay-bills-skill/generate-device-id.js (no userId before login). After login, run node pay-bills-skill/generate-device-id.js <userId> to bind the device to the user.\nOn logout or 401: run node pay-bills-skill/session-token.js clear and re-auth."
      },
      {
        "title": "Auth",
        "body": "All [auth] endpoints need Authorization: Bearer <sessionToken>. If 401 → run node pay-bills-skill/session-token.js clear and re-auth.\n\nLogin flow (no auth needed):\n\n1. POST /auth/start         { \"phoneNumber\":\"08031234567\", \"deviceId\":\"<run: node pay-bills-skill/generate-device-id.js>\" }\n                             → { success, data: { sessionId, nextStep } }\n\n   nextStep will be one of:\n   - \"verify_otp\"        → new user OR unrecognized device\n   - \"enter_pin\"         → known device, go straight to step 3\n\n2. POST /auth/verify-otp    { \"sessionId\":\"<from-step-1>\", \"code\":\"123456\" }  ← 6 digits from SMS\n                             → { success, data: { sessionId, nextStep } }\n\n   nextStep will be one of:\n   - \"set_pin\"           → new user, needs to create 4-digit PIN\n   - \"enter_pin\"         → existing user, new device\n   - \"complete_profile\"  → profile incomplete\n\n2b. POST /auth/set-pin      { \"sessionId\":\"...\", \"pin\":\"1234\" }  ← 4 digits (new users only)\n                             → { success, data: { sessionId, nextStep:\"complete_profile\" } }\n\n2c. POST /auth/complete-profile  { \"sessionId\":\"...\", \"fullName\":\"John Doe\", \"email\":\"j@x.com\" }\n                             → { success, data: { sessionId, nextStep:\"verify_email\" } }\n\n2d. POST /auth/verify-email  { \"sessionId\":\"...\", \"code\":\"123456\" }  ← 6 digits from email\n                             → { success, sessionToken, userId }  ✓ DONE\n                             → then run: node pay-bills-skill/session-token.js save <sessionToken>\n\n3. POST /auth/verify-pin    { \"sessionId\":\"<from-above>\", \"pin\":\"1234\" }  ← 4 digits\n                             → { success, sessionToken, userId }  ✓ DONE\n                             → then run: node pay-bills-skill/session-token.js save <sessionToken>\n\nReturning user (known device): steps 1 → 3 only.\nReturning user (new device): steps 1 → 2 → 3.\nNew user: steps 1 → 2 → 2b → 2c → 2d.\n\nOther auth endpoints:\n\nPOST /auth/resend-otp { sessionId } — 60s cooldown, max 5/hour\nPOST /auth/forgot-pin { phoneNumber, deviceId } → OTP flow → set new PIN\nPOST /auth/logout { sessionToken } → then run node pay-bills-skill/session-token.js clear\n\nRate limits: OTP: 5 sends/hour, 3 verify attempts/code. PIN: 5 attempts/15min, 5min lockout after."
      },
      {
        "title": "Buy Data",
        "body": "1. POST /utils/phone/normalize   { \"phone\": \"<raw>\" }           → { ok, data: \"08031234567\" }\n2. POST /utils/phone/predict     { \"phone\": \"08031234567\" }      → { ok, data: { phone, network } }\n3. GET  /product/networks                                        → [{ id, name, status }]\n4. GET  /product/networks/:networkId/data-plans                  → { categories, plans: { daily[], weekly[], monthly[] } }\n   Each plan: { id, name, amount, durationDays, category, status }  — only use status:\"active\"\n5. GET  /user/balance  [auth]                                    → { ok, balance, points }\n6. POST /orders  [auth]\n   { \"type\":\"data\", \"payment_method\":\"wallet\", \"trx_id\":\"<run: node pay-bills-skill/generate-order-id.js>\", \"use_points\":false,\n     \"data\": { \"phone\":\"08031234567\", \"data_id\": 42 } }\n   → { ok, message, transactionId }\n7. GET  /orders/:transactionId/status  [auth]                    → { status, reference, createdAt }"
      },
      {
        "title": "Buy Airtime",
        "body": "Same steps 1-3, skip step 4. Minimum ₦50.\n\nPOST /orders  [auth]\n{ \"type\":\"airtime\", \"payment_method\":\"wallet\", \"trx_id\":\"<run: node pay-bills-skill/generate-order-id.js>\", \"use_points\":false,\n  \"data\": { \"phone\":\"08031234567\", \"network_id\":1, \"amount\":500 } }"
      },
      {
        "title": "Order Statuses",
        "body": "StatusMeaningpending_paymentAwaiting online paymentorder_receivedProcessing — poll every 15-30scompletedDeliveredfailedFailed, user auto-refunded\n\nCall only if the user wants to know the status of an order they placed."
      },
      {
        "title": "Other Endpoints (all [auth])",
        "body": "GET  /user/balance                → { balance, points }\nGET  /user/profile                → { id, balance, fullName, email, phone }\nGET  /user/deposit-account        → { account: { AccountNumber, AccountName, BankName } | null }\nGET  /transactions?page=&limit=&type=&status=&fromDate=&toDate=  → { transactions[], total, page, totalPages }\nGET  /transactions/recent-phones  → { recentlyUsedPhones: [{ phone_number, network_id, network_name }] }\nPOST /payment/deposit [auth]      { amount (min 100) } → { paymentLink }"
      },
      {
        "title": "Notification Preferences (all [auth])",
        "body": "Users can view and update which notifications they receive.\n\nGET   /user/notification-preferences                → { ok, preferences }\nPATCH /user/notification-preferences                → { ok, preferences }"
      },
      {
        "title": "Preference Fields (all boolean, all optional on update)",
        "body": "FieldDescriptionDefaultemailEnabledMaster switch for email channeltruechatEnabledMaster switch for chat channeltrueorderConfirmationsOrder placed / confirmedtrueorderStatusUpdatesOrder completed / failedtruedepositConfirmationsDeposit successfultruepaymentFailuresPayment failed / underpaidtruerefundNotificationsRefund processedtruegiveawayUpdatesGiveaway created / activatedtruegiveawayClaimAlertsSomeone claimed your giveawaytruepointsAndCashbackCashback & points earnedtruepromotionalEmailsMarketing / promotional contenttruelowBalanceWarningBalance below thresholdtrue"
      },
      {
        "title": "Example",
        "body": "PATCH /user/notification-preferences\n{ \"promotionalEmails\": false, \"lowBalanceWarning\": false }\n→ { \"ok\": true, \"preferences\": { ...all fields... } }"
      },
      {
        "title": "Saved Contacts (all [auth])",
        "body": "Users can save phone numbers with names for quick reference. When a user says \"buy data for Mum\" or \"send airtime to John\", search their saved contacts first.\n\nGET    /contacts?page=&limit=&search=    → { contacts[], total, page, totalPages }\nPOST   /contacts                          { \"name\":\"Mum\", \"phoneNumber\":\"09012345678\" } → { ok, contact }\nPATCH  /contacts/:id                      { \"name\":\"Mother\" } or { \"phoneNumber\":\"...\" } or both → { ok, contact }\nDELETE /contacts/:id                      → { ok, message:\"Contact deleted\" }\nGET    /contacts/search?name=mum          → { ok, contacts: [{ id, name, phoneNumber }] }  (max 5 results)\n\nA phone number can only be saved once per user (409 Conflict on duplicate)\nsearch param on GET /contacts matches name or phone (partial)\nGET /contacts/search?name= is a quick lookup — use it to resolve a name to a phone number"
      },
      {
        "title": "Contact Behaviors",
        "body": "After a successful purchase: if the phone number isn't already saved, suggest saving it: \"Would you like to save 0803 123 4567 with a name so you can quickly buy for them next time?\"\nWhen user refers to a name: search contacts via GET /contacts/search?name=...\n\n1 match → use that phone number (confirm with user)\nMultiple matches → show options, ask which one\nNo match → ask user for the phone number\n\n\n\"Buy for Mum\" flow: search contacts → find phone → normalize → predict network → fetch plans → confirm → order"
      },
      {
        "title": "Product Discovery (no auth)",
        "body": "GET /product/networks\nGET /product/networks/:id/data-plans\nGET /product/data-plans/:dataId\nGET /product/education"
      },
      {
        "title": "Key Rules",
        "body": "Always normalize phone before anything — POST /utils/phone/normalize\nAlways predict network — POST /utils/phone/predict (don't guess from prefix)\nNever hardcode network IDs or plan IDs — fetch fresh every time\ntrx_id must be unique per attempt — run node pay-bills-skill/generate-order-id.js for each order, never reuse even on failure\nCheck balance before wallet orders — if insufficient, suggest deposit\nConfirm with user before submitting — show plan, price, phone, balance\nNetwork status must be up — don't order on down networks\nPlan status must be active — skip disabled plans\npayment_method wallet is preferred for agent purchases (instant, no redirect)\nUse GET /transactions/recent-phones for quick re-orders (\"buy same as last time\")\nUse GET /contacts/search?name= when user refers to someone by name (\"buy for Mum\")\nAfter a successful purchase, suggest saving the number if it's not already in contacts\nUser's own phone is in GET /user/profile → phone field"
      },
      {
        "title": "Enums",
        "body": "type: data, airtime\npayment_method: wallet, online\ntransaction type: deposit, purchase_data, purchase_airtime, giveaway_funding, giveaway_claim\nplan category: daily, weekly, monthly, yearly"
      }
    ],
    "body": "SKILL.md — CreditWithBleon API\n\nBuy data, airtime, and digital products for Nigerian phone numbers via wallet balance.\n\nBase URL: https://lodu.bleon.net/v1\n\nHelper Scripts\n\nThese Node.js scripts live in the pay-bills-skill/ directory. Run them with node to generate IDs and manage auth state.\n\nScript\tCommand\tPurpose\ngenerate-order-id.js\tnode pay-bills-skill/generate-order-id.js\tOutputs a unique ORDER_<timestamp>_<random> string. Use this as trx_id for every order — never hardcode or reuse a trx_id.\ngenerate-device-id.js\tnode pay-bills-skill/generate-device-id.js [userId]\tOutputs a device ID. With userId: openclaw_<userId>. Use as deviceId in auth requests.\nsession-token.js\tsee below\tManages the session token for auth.\nSession Token Commands\nnode pay-bills-skill/session-token.js check              → { \"loggedIn\": true/false, \"sessionToken\": \"...\" | null }\nnode pay-bills-skill/session-token.js save <token>       → saves the token to .session_token\nnode pay-bills-skill/session-token.js load               → prints the saved token (exit 1 if none)\nnode pay-bills-skill/session-token.js clear              → deletes the saved token (logout)\n\nWorkflow\nBefore any [auth] request: run node pay-bills-skill/session-token.js check to see if a session token exists.\nIf loggedIn: true → use the sessionToken value as Authorization: Bearer <sessionToken>.\nIf loggedIn: false → start the login flow (see Auth below).\nAfter a successful login (steps that return sessionToken): run node pay-bills-skill/session-token.js save <sessionToken> to persist it.\nBefore placing an order: run node pay-bills-skill/generate-order-id.js to get a fresh trx_id.\nFor auth requests: run node pay-bills-skill/generate-device-id.js (no userId before login). After login, run node pay-bills-skill/generate-device-id.js <userId> to bind the device to the user.\nOn logout or 401: run node pay-bills-skill/session-token.js clear and re-auth.\nAuth\n\nAll [auth] endpoints need Authorization: Bearer <sessionToken>. If 401 → run node pay-bills-skill/session-token.js clear and re-auth.\n\nLogin flow (no auth needed):\n\n1. POST /auth/start         { \"phoneNumber\":\"08031234567\", \"deviceId\":\"<run: node pay-bills-skill/generate-device-id.js>\" }\n                             → { success, data: { sessionId, nextStep } }\n\n   nextStep will be one of:\n   - \"verify_otp\"        → new user OR unrecognized device\n   - \"enter_pin\"         → known device, go straight to step 3\n\n2. POST /auth/verify-otp    { \"sessionId\":\"<from-step-1>\", \"code\":\"123456\" }  ← 6 digits from SMS\n                             → { success, data: { sessionId, nextStep } }\n\n   nextStep will be one of:\n   - \"set_pin\"           → new user, needs to create 4-digit PIN\n   - \"enter_pin\"         → existing user, new device\n   - \"complete_profile\"  → profile incomplete\n\n2b. POST /auth/set-pin      { \"sessionId\":\"...\", \"pin\":\"1234\" }  ← 4 digits (new users only)\n                             → { success, data: { sessionId, nextStep:\"complete_profile\" } }\n\n2c. POST /auth/complete-profile  { \"sessionId\":\"...\", \"fullName\":\"John Doe\", \"email\":\"j@x.com\" }\n                             → { success, data: { sessionId, nextStep:\"verify_email\" } }\n\n2d. POST /auth/verify-email  { \"sessionId\":\"...\", \"code\":\"123456\" }  ← 6 digits from email\n                             → { success, sessionToken, userId }  ✓ DONE\n                             → then run: node pay-bills-skill/session-token.js save <sessionToken>\n\n3. POST /auth/verify-pin    { \"sessionId\":\"<from-above>\", \"pin\":\"1234\" }  ← 4 digits\n                             → { success, sessionToken, userId }  ✓ DONE\n                             → then run: node pay-bills-skill/session-token.js save <sessionToken>\n\n\nReturning user (known device): steps 1 → 3 only. Returning user (new device): steps 1 → 2 → 3. New user: steps 1 → 2 → 2b → 2c → 2d.\n\nOther auth endpoints:\n\nPOST /auth/resend-otp { sessionId } — 60s cooldown, max 5/hour\nPOST /auth/forgot-pin { phoneNumber, deviceId } → OTP flow → set new PIN\nPOST /auth/logout { sessionToken } → then run node pay-bills-skill/session-token.js clear\n\nRate limits: OTP: 5 sends/hour, 3 verify attempts/code. PIN: 5 attempts/15min, 5min lockout after.\n\nBuy Data\n1. POST /utils/phone/normalize   { \"phone\": \"<raw>\" }           → { ok, data: \"08031234567\" }\n2. POST /utils/phone/predict     { \"phone\": \"08031234567\" }      → { ok, data: { phone, network } }\n3. GET  /product/networks                                        → [{ id, name, status }]\n4. GET  /product/networks/:networkId/data-plans                  → { categories, plans: { daily[], weekly[], monthly[] } }\n   Each plan: { id, name, amount, durationDays, category, status }  — only use status:\"active\"\n5. GET  /user/balance  [auth]                                    → { ok, balance, points }\n6. POST /orders  [auth]\n   { \"type\":\"data\", \"payment_method\":\"wallet\", \"trx_id\":\"<run: node pay-bills-skill/generate-order-id.js>\", \"use_points\":false,\n     \"data\": { \"phone\":\"08031234567\", \"data_id\": 42 } }\n   → { ok, message, transactionId }\n7. GET  /orders/:transactionId/status  [auth]                    → { status, reference, createdAt }\n\nBuy Airtime\n\nSame steps 1-3, skip step 4. Minimum ₦50.\n\nPOST /orders  [auth]\n{ \"type\":\"airtime\", \"payment_method\":\"wallet\", \"trx_id\":\"<run: node pay-bills-skill/generate-order-id.js>\", \"use_points\":false,\n  \"data\": { \"phone\":\"08031234567\", \"network_id\":1, \"amount\":500 } }\n\nOrder Statuses\nStatus\tMeaning\npending_payment\tAwaiting online payment\norder_received\tProcessing — poll every 15-30s\ncompleted\tDelivered\nfailed\tFailed, user auto-refunded\n\nCall only if the user wants to know the status of an order they placed.\n\nOther Endpoints (all [auth])\nGET  /user/balance                → { balance, points }\nGET  /user/profile                → { id, balance, fullName, email, phone }\nGET  /user/deposit-account        → { account: { AccountNumber, AccountName, BankName } | null }\nGET  /transactions?page=&limit=&type=&status=&fromDate=&toDate=  → { transactions[], total, page, totalPages }\nGET  /transactions/recent-phones  → { recentlyUsedPhones: [{ phone_number, network_id, network_name }] }\nPOST /payment/deposit [auth]      { amount (min 100) } → { paymentLink }\n\nNotification Preferences (all [auth])\n\nUsers can view and update which notifications they receive.\n\nGET   /user/notification-preferences                → { ok, preferences }\nPATCH /user/notification-preferences                → { ok, preferences }\n\nPreference Fields (all boolean, all optional on update)\nField\tDescription\tDefault\nemailEnabled\tMaster switch for email channel\ttrue\nchatEnabled\tMaster switch for chat channel\ttrue\norderConfirmations\tOrder placed / confirmed\ttrue\norderStatusUpdates\tOrder completed / failed\ttrue\ndepositConfirmations\tDeposit successful\ttrue\npaymentFailures\tPayment failed / underpaid\ttrue\nrefundNotifications\tRefund processed\ttrue\ngiveawayUpdates\tGiveaway created / activated\ttrue\ngiveawayClaimAlerts\tSomeone claimed your giveaway\ttrue\npointsAndCashback\tCashback & points earned\ttrue\npromotionalEmails\tMarketing / promotional content\ttrue\nlowBalanceWarning\tBalance below threshold\ttrue\nExample\nPATCH /user/notification-preferences\n{ \"promotionalEmails\": false, \"lowBalanceWarning\": false }\n→ { \"ok\": true, \"preferences\": { ...all fields... } }\n\nSaved Contacts (all [auth])\n\nUsers can save phone numbers with names for quick reference. When a user says \"buy data for Mum\" or \"send airtime to John\", search their saved contacts first.\n\nGET    /contacts?page=&limit=&search=    → { contacts[], total, page, totalPages }\nPOST   /contacts                          { \"name\":\"Mum\", \"phoneNumber\":\"09012345678\" } → { ok, contact }\nPATCH  /contacts/:id                      { \"name\":\"Mother\" } or { \"phoneNumber\":\"...\" } or both → { ok, contact }\nDELETE /contacts/:id                      → { ok, message:\"Contact deleted\" }\nGET    /contacts/search?name=mum          → { ok, contacts: [{ id, name, phoneNumber }] }  (max 5 results)\n\nA phone number can only be saved once per user (409 Conflict on duplicate)\nsearch param on GET /contacts matches name or phone (partial)\nGET /contacts/search?name= is a quick lookup — use it to resolve a name to a phone number\nContact Behaviors\nAfter a successful purchase: if the phone number isn't already saved, suggest saving it: \"Would you like to save 0803 123 4567 with a name so you can quickly buy for them next time?\"\nWhen user refers to a name: search contacts via GET /contacts/search?name=...\n1 match → use that phone number (confirm with user)\nMultiple matches → show options, ask which one\nNo match → ask user for the phone number\n\"Buy for Mum\" flow: search contacts → find phone → normalize → predict network → fetch plans → confirm → order\nProduct Discovery (no auth)\nGET /product/networks\nGET /product/networks/:id/data-plans\nGET /product/data-plans/:dataId\nGET /product/education\n\nKey Rules\nAlways normalize phone before anything — POST /utils/phone/normalize\nAlways predict network — POST /utils/phone/predict (don't guess from prefix)\nNever hardcode network IDs or plan IDs — fetch fresh every time\ntrx_id must be unique per attempt — run node pay-bills-skill/generate-order-id.js for each order, never reuse even on failure\nCheck balance before wallet orders — if insufficient, suggest deposit\nConfirm with user before submitting — show plan, price, phone, balance\nNetwork status must be up — don't order on down networks\nPlan status must be active — skip disabled plans\npayment_method wallet is preferred for agent purchases (instant, no redirect)\nUse GET /transactions/recent-phones for quick re-orders (\"buy same as last time\")\nUse GET /contacts/search?name= when user refers to someone by name (\"buy for Mum\")\nAfter a successful purchase, suggest saving the number if it's not already in contacts\nUser's own phone is in GET /user/profile → phone field\nEnums\ntype: data, airtime\npayment_method: wallet, online\ntransaction type: deposit, purchase_data, purchase_airtime, giveaway_funding, giveaway_claim\nplan category: daily, weekly, monthly, yearly"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/h1rdr3v2/pay-bills",
    "publisherUrl": "https://clawhub.ai/h1rdr3v2/pay-bills",
    "owner": "h1rdr3v2",
    "version": "0.0.5",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/pay-bills",
    "downloadUrl": "https://openagent3.xyz/downloads/pay-bills",
    "agentUrl": "https://openagent3.xyz/skills/pay-bills/agent",
    "manifestUrl": "https://openagent3.xyz/skills/pay-bills/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/pay-bills/agent.md"
  }
}