{"name":"Credit \u0026 Points Management Agent","description":"An agent that manages credit and points systems, including transfers, transactions, service offerings, and usage metering","url":"http://pay.qikfox.com/a2a","preferredTransport":"HTTP+JSON","provider":{"url":"https://qikfox.com","organization":"QikFox"},"version":"1.0.0","protocolVersion":"0.3.0","documentationUrl":"http://pay.qikfox.com/docs/a2a","capabilities":{"extensions":[{"uri":"http://pay.qikfox.com/extensions/points-management","description":"Extended points management operations including minting, burning, and redemption"},{"uri":"http://pay.qikfox.com/extensions/service-offerings","description":"Service subscription and purchase management"},{"uri":"http://pay.qikfox.com/extensions/usage-metering","description":"Service usage tracking and reporting"},{"uri":"http://pay.qikfox.com/extensions/coupon-system","description":"Promotional coupon redemption"},{"uri":"http://pay.qikfox.com/extensions/notifications","description":"User notification management"}]},"defaultInputModes":["application/json"],"defaultOutputModes":["application/json"],"skills":[{"id":"profile-management","name":"Profile Management","description":"Get and update user profile information.\n\nCommands:\n- profile.get: Get user profile\n  Input: {} (no parameters required)\n  Output: {\"name\": \"string\", \"email\": \"string\", \"preferences\": \"object\"}\n\n- profile.update: Update user profile\n  Input: {\"name\": \"string\", \"email\": \"string\", \"preferences\": \"object\"}\n  Output: {\"success\": \"boolean\", \"message\": \"string\"}","tags":["profile","user","account"],"examples":["{\"command\": \"profile.get\"}","{\"command\": \"profile.update\", \"name\": \"John Doe\", \"email\": \"john@example.com\"}"]},{"id":"points-management","name":"Points Management","description":"Add, transfer, and redeem points.\n\nCommands:\n- points.add: Add points to account\n  Input: {\"amount\": \"number\", \"reason\": \"string\"}\n  Output: {\"balance\": \"number\", \"transactionId\": \"string\"}\n\n- points.transfer: Transfer points to another user\n  Input: {\"recipientDID\": \"string\", \"amount\": \"number\", \"note\": \"string\"}\n  Output: {\"transactionId\": \"string\", \"newBalance\": \"number\"}\n\n- points.redeem: Redeem points for rewards\n  Input: {\"amount\": \"number\", \"rewardType\": \"string\"}\n  Output: {\"transactionId\": \"string\", \"remainingBalance\": \"number\"}","tags":["points","transfer","redeem","add"],"examples":["{\"command\": \"points.add\", \"amount\": 100, \"reason\": \"signup bonus\"}","{\"command\": \"points.transfer\", \"recipientDID\": \"did:example:bob\", \"amount\": 50}","{\"command\": \"points.redeem\", \"amount\": 200, \"rewardType\": \"gift_card\"}"]},{"id":"balance-accounts","name":"Balance \u0026 Accounts","description":"Check balance and list accounts.\n\nCommands:\n- balance.get: Get current balance\n  Input: {} (no parameters required)\n  Output: {\"balance\": \"number\", \"currency\": \"string\"}\n\n- accounts.list: List all accounts\n  Input: {} (no parameters required)\n  Output: {\"accounts\": [{\"id\": \"string\", \"balance\": \"number\", \"type\": \"string\"}]}","tags":["balance","accounts","wallet"],"examples":["{\"command\": \"balance.get\"}","{\"command\": \"accounts.list\"}"]},{"id":"transaction-history","name":"Transaction History","description":"View transaction history and details.\n\nCommands:\n- transaction.history: Get transaction history\n  Input: {\"limit\": \"number\", \"offset\": \"number\"}\n  Output: {\"transactions\": [{\"id\": \"string\", \"amount\": \"number\", \"type\": \"string\", \"timestamp\": \"string\"}], \"total\": \"number\"}","tags":["transactions","history","audit"],"examples":["{\"command\": \"transaction.history\", \"limit\": 10, \"offset\": 0}"]},{"id":"notifications","name":"Notifications","description":"List, read, mark, and delete notifications.\n\nCommands:\n- notifications.list: List all notifications\n  Input: {\"limit\": \"number\", \"unreadOnly\": \"boolean\"}\n  Output: {\"notifications\": [{\"id\": \"string\", \"message\": \"string\", \"read\": \"boolean\", \"timestamp\": \"string\"}]}\n\n- notifications.mark_read: Mark notification as read\n  Input: {\"notificationId\": \"string\"}\n  Output: {\"success\": \"boolean\"}\n\n- notifications.read_all: Mark all notifications as read\n  Input: {} (no parameters required)\n  Output: {\"success\": \"boolean\", \"count\": \"number\"}\n\n- notifications.delete: Delete a notification\n  Input: {\"notificationId\": \"string\"}\n  Output: {\"success\": \"boolean\"}","tags":["notifications","alerts","messages"],"examples":["{\"command\": \"notifications.list\", \"limit\": 20, \"unreadOnly\": true}","{\"command\": \"notifications.mark_read\", \"notificationId\": \"notif_123\"}","{\"command\": \"notifications.read_all\"}","{\"command\": \"notifications.delete\", \"notificationId\": \"notif_123\"}"]},{"id":"handle-linking","name":"Handle Linking","description":"Link and manage external handles/identities.\n\nCommands:\n- link_handle.initiate: Initiate handle linking process\n  Input: {\"handle\": \"string\", \"platform\": \"string\"}\n  Output: {\"linkToken\": \"string\", \"expiresAt\": \"string\"}\n\n- link_handle.get: Get linked handle information\n  Input: {} (no parameters required)\n  Output: {\"handle\": \"string\", \"platform\": \"string\", \"linkedAt\": \"string\"}\n\n- link_handle.unlink: Unlink external handle\n  Input: {\"handle\": \"string\"}\n  Output: {\"success\": \"boolean\"}","tags":["handle","link","identity"],"examples":["{\"command\": \"link_handle.initiate\", \"handle\": \"user\", \"platform\": \"twitter\"}","{\"command\": \"link_handle.get\"}","{\"command\": \"link_handle.unlink\", \"handle\": \"user\"}"]},{"id":"service-registration","name":"Service Registration","description":"Register, get, and list services.\n\nCommands:\n- service.register: Register a new service\n  Input: {\"serviceName\": \"string\", \"description\": \"string\", \"endpoint\": \"string\"}\n  Output: {\"serviceId\": \"string\", \"apiKey\": \"string\"}\n\n- service.get: Get service details\n  Input: {\"serviceId\": \"string\"}\n  Output: {\"serviceId\": \"string\", \"serviceName\": \"string\", \"description\": \"string\", \"status\": \"string\"}\n\n- service.list: List all services\n  Input: {\"limit\": \"number\", \"offset\": \"number\"}\n  Output: {\"services\": [{\"serviceId\": \"string\", \"serviceName\": \"string\", \"status\": \"string\"}]}","tags":["service","register","list"],"examples":["{\"command\": \"service.register\", \"serviceName\": \"My Service\", \"description\": \"Service description\", \"endpoint\": \"https://api.example.com\"}","{\"command\": \"service.get\", \"serviceId\": \"svc_123\"}","{\"command\": \"service.list\", \"limit\": 10}"]},{"id":"service-manifest","name":"Service Manifest","description":"Get manifest schema for external services.\n\nCommands:\n- service.manifest.schema: Get the JSON schema for service manifests\n  Input: {} (no parameters required)\n  Output: {\"schema\": \"object\", \"version\": \"string\"}","tags":["manifest","schema","external"],"examples":["{\"command\": \"service.manifest.schema\"}"]},{"id":"service-provider-kyb","name":"Service Provider KYB","description":"Know Your Business verification for service providers.\n\nCommands:\n- service.provider.kyb.requirements: Get KYB requirements\n  Input: {} (no parameters required)\n  Output: {\"requirements\": [\"string\"], \"documents\": [\"string\"]}\n\n- service.provider.kyb.submit: Submit KYB information\n  Input: {\"businessName\": \"string\", \"taxId\": \"string\", \"documents\": [\"string\"]}\n  Output: {\"submissionId\": \"string\", \"status\": \"string\"}\n\n- service.provider.kyb.list_pending: List pending KYB requests\n  Input: {\"limit\": \"number\"}\n  Output: {\"requests\": [{\"submissionId\": \"string\", \"businessName\": \"string\", \"status\": \"string\"}]}\n\n- service.provider.kyb.approve: Approve KYB request (admin only)\n  Input: {\"submissionId\": \"string\"}\n  Output: {\"success\": \"boolean\", \"providerId\": \"string\"}","tags":["kyb","verification","provider"],"examples":["{\"command\": \"service.provider.kyb.requirements\"}","{\"command\": \"service.provider.kyb.submit\", \"businessName\": \"Acme Corp\", \"taxId\": \"12-3456789\"}","{\"command\": \"service.provider.kyb.list_pending\", \"limit\": 10}","{\"command\": \"service.provider.kyb.approve\", \"submissionId\": \"kyb_123\"}"]},{"id":"service-offerings","name":"Service Offerings","description":"Register, add, list, purchase, and manage service offerings.\n\nCommands:\n- service.offerings.register: Register service offerings\n  Input: {\"serviceId\": \"string\", \"offerings\": [{\"name\": \"string\", \"price\": \"number\", \"duration\": \"string\"}]}\n  Output: {\"success\": \"boolean\", \"offeringIds\": [\"string\"]}\n\n- service.offerings.add: Add a new offering\n  Input: {\"serviceId\": \"string\", \"name\": \"string\", \"price\": \"number\", \"duration\": \"string\"}\n  Output: {\"offeringId\": \"string\"}\n\n- service.offerings.list_services: List all services with offerings\n  Input: {\"limit\": \"number\"}\n  Output: {\"services\": [{\"serviceId\": \"string\", \"serviceName\": \"string\", \"offeringsCount\": \"number\"}]}\n\n- service.offerings.list: List offerings for a service\n  Input: {\"serviceId\": \"string\"}\n  Output: {\"offerings\": [{\"offeringId\": \"string\", \"name\": \"string\", \"price\": \"number\"}]}\n\n- service.offerings.purchase: Purchase an offering\n  Input: {\"offeringId\": \"string\", \"quantity\": \"number\"}\n  Output: {\"purchaseId\": \"string\", \"totalCost\": \"number\"}\n\n- service.offerings.my_purchases: View my purchases\n  Input: {\"limit\": \"number\"}\n  Output: {\"purchases\": [{\"purchaseId\": \"string\", \"offeringName\": \"string\", \"purchaseDate\": \"string\"}]}\n\n- service.offerings.cancel: Cancel a purchase\n  Input: {\"purchaseId\": \"string\"}\n  Output: {\"success\": \"boolean\", \"refundAmount\": \"number\"}\n\n- service.offerings.set_auto_renew: Set auto-renew for subscription\n  Input: {\"purchaseId\": \"string\", \"autoRenew\": \"boolean\"}\n  Output: {\"success\": \"boolean\"}","tags":["offerings","purchase","subscriptions"],"examples":["{\"command\": \"service.offerings.register\", \"serviceId\": \"svc_123\", \"offerings\": [{\"name\": \"Basic\", \"price\": 9.99, \"duration\": \"monthly\"}]}","{\"command\": \"service.offerings.add\", \"serviceId\": \"svc_123\", \"name\": \"Premium\", \"price\": 19.99, \"duration\": \"monthly\"}","{\"command\": \"service.offerings.list_services\", \"limit\": 10}","{\"command\": \"service.offerings.list\", \"serviceId\": \"svc_123\"}","{\"command\": \"service.offerings.purchase\", \"offeringId\": \"off_123\", \"quantity\": 1}","{\"command\": \"service.offerings.my_purchases\", \"limit\": 10}","{\"command\": \"service.offerings.cancel\", \"purchaseId\": \"pur_123\"}","{\"command\": \"service.offerings.set_auto_renew\", \"purchaseId\": \"pur_123\", \"autoRenew\": true}"]},{"id":"usage-metering","name":"Usage Metering","description":"Report and track service usage.\n\nCommands:\n- metering.report: Report usage metrics\n  Input: {\"serviceId\": \"string\", \"metricName\": \"string\", \"value\": \"number\", \"timestamp\": \"string\"}\n  Output: {\"success\": \"boolean\", \"recordId\": \"string\"}\n\n- metering.my_usage: Get my usage data\n  Input: {\"serviceId\": \"string\", \"startDate\": \"string\", \"endDate\": \"string\"}\n  Output: {\"usage\": [{\"metricName\": \"string\", \"value\": \"number\", \"timestamp\": \"string\"}], \"total\": \"number\"}","tags":["metering","usage","tracking"],"examples":["{\"command\": \"metering.report\", \"serviceId\": \"svc_123\", \"metricName\": \"api_calls\", \"value\": 100}","{\"command\": \"metering.my_usage\", \"serviceId\": \"svc_123\", \"startDate\": \"2024-01-01\", \"endDate\": \"2024-01-31\"}"]},{"id":"pms-integration","name":"PMS Integration","description":"Payment Management System integration for service authentication and usage.\n\nCommands:\n- pms.auth.verify: Verify PMS authentication\n  Input: {\"token\": \"string\"}\n  Output: {\"valid\": \"boolean\", \"userId\": \"string\"}\n\n- pms.service.initiate: Initiate PMS service\n  Input: {\"serviceId\": \"string\", \"userId\": \"string\"}\n  Output: {\"sessionId\": \"string\", \"accessToken\": \"string\"}\n\n- pms.service.regenerate_sat: Regenerate service access token\n  Input: {\"sessionId\": \"string\"}\n  Output: {\"accessToken\": \"string\", \"expiresAt\": \"string\"}\n\n- pms.service.verify_token: Verify service token\n  Input: {\"accessToken\": \"string\"}\n  Output: {\"valid\": \"boolean\", \"sessionId\": \"string\"}\n\n- pms.service.usage.report: Report service usage\n  Input: {\"sessionId\": \"string\", \"usage\": \"number\", \"metricType\": \"string\"}\n  Output: {\"success\": \"boolean\", \"recordId\": \"string\"}\n\n- pms.service.refund: Process refund\n  Input: {\"transactionId\": \"string\", \"amount\": \"number\", \"reason\": \"string\"}\n  Output: {\"refundId\": \"string\", \"status\": \"string\"}","tags":["pms","payment","service-token"],"examples":["{\"command\": \"pms.auth.verify\", \"token\": \"eyJhbGc...\"}","{\"command\": \"pms.service.initiate\", \"serviceId\": \"svc_123\", \"userId\": \"user_456\"}","{\"command\": \"pms.service.regenerate_sat\", \"sessionId\": \"sess_789\"}","{\"command\": \"pms.service.verify_token\", \"accessToken\": \"sat_abc123\"}","{\"command\": \"pms.service.usage.report\", \"sessionId\": \"sess_789\", \"usage\": 50, \"metricType\": \"api_calls\"}","{\"command\": \"pms.service.refund\", \"transactionId\": \"txn_123\", \"amount\": 10.00, \"reason\": \"Service issue\"}"]},{"id":"subscriptions","name":"Subscriptions","description":"Create, purchase, manage, and cancel subscriptions.\n\nCommands:\n- subscription.create: Create a subscription plan\n  Input: {\"name\": \"string\", \"price\": \"number\", \"billingCycle\": \"string\", \"features\": [\"string\"]}\n  Output: {\"subscriptionId\": \"string\"}\n\n- subscription.purchase: Purchase subscription\n  Input: {\"subscriptionId\": \"string\", \"paymentMethod\": \"string\"}\n  Output: {\"purchaseId\": \"string\", \"startDate\": \"string\", \"nextBillingDate\": \"string\"}\n\n- subscription.get: Get subscription details\n  Input: {\"subscriptionId\": \"string\"}\n  Output: {\"subscriptionId\": \"string\", \"name\": \"string\", \"price\": \"number\", \"status\": \"string\"}\n\n- subscription.cancel: Cancel subscription\n  Input: {\"purchaseId\": \"string\", \"reason\": \"string\"}\n  Output: {\"success\": \"boolean\", \"endDate\": \"string\"}\n\n- subscription.list_by_user: List my subscriptions\n  Input: {\"status\": \"string\", \"limit\": \"number\"}\n  Output: {\"subscriptions\": [{\"purchaseId\": \"string\", \"name\": \"string\", \"status\": \"string\", \"nextBillingDate\": \"string\"}]}","tags":["subscription","recurring","billing"],"examples":["{\"command\": \"subscription.create\", \"name\": \"Premium Plan\", \"price\": 29.99, \"billingCycle\": \"monthly\", \"features\": [\"feature1\", \"feature2\"]}","{\"command\": \"subscription.purchase\", \"subscriptionId\": \"sub_123\", \"paymentMethod\": \"card_456\"}","{\"command\": \"subscription.get\", \"subscriptionId\": \"sub_123\"}","{\"command\": \"subscription.cancel\", \"purchaseId\": \"pur_789\", \"reason\": \"No longer needed\"}","{\"command\": \"subscription.list_by_user\", \"status\": \"active\", \"limit\": 10}"]},{"id":"postpaid-billing","name":"Postpaid Billing","description":"Postpaid invoice creation, payment, and usage tracking.\n\nCommands:\n- postpaid.invoice.create: Create postpaid invoice\n  Input: {\"userId\": \"string\", \"amount\": \"number\", \"dueDate\": \"string\", \"items\": [{\"description\": \"string\", \"amount\": \"number\"}]}\n  Output: {\"invoiceId\": \"string\", \"totalAmount\": \"number\"}\n\n- postpaid.invoice.pay: Pay invoice\n  Input: {\"invoiceId\": \"string\", \"paymentMethod\": \"string\"}\n  Output: {\"paymentId\": \"string\", \"status\": \"string\"}\n\n- postpaid.usage.report: Report postpaid usage\n  Input: {\"serviceId\": \"string\", \"usage\": \"number\", \"metricType\": \"string\"}\n  Output: {\"success\": \"boolean\", \"recordId\": \"string\"}\n\n- postpaid.usage.get: Get usage details\n  Input: {\"startDate\": \"string\", \"endDate\": \"string\"}\n  Output: {\"usage\": [{\"serviceId\": \"string\", \"metricType\": \"string\", \"value\": \"number\"}], \"totalCost\": \"number\"}\n\n- postpaid.invoices.pending: List pending invoices\n  Input: {\"limit\": \"number\"}\n  Output: {\"invoices\": [{\"invoiceId\": \"string\", \"amount\": \"number\", \"dueDate\": \"string\", \"status\": \"string\"}]}","tags":["postpaid","invoice","billing"],"examples":["{\"command\": \"postpaid.invoice.create\", \"userId\": \"user_123\", \"amount\": 100.00, \"dueDate\": \"2024-02-01\", \"items\": [{\"description\": \"API usage\", \"amount\": 100.00}]}","{\"command\": \"postpaid.invoice.pay\", \"invoiceId\": \"inv_123\", \"paymentMethod\": \"card_456\"}","{\"command\": \"postpaid.usage.report\", \"serviceId\": \"svc_123\", \"usage\": 1000, \"metricType\": \"api_calls\"}","{\"command\": \"postpaid.usage.get\", \"startDate\": \"2024-01-01\", \"endDate\": \"2024-01-31\"}","{\"command\": \"postpaid.invoices.pending\", \"limit\": 10}"]},{"id":"packages","name":"Package Purchase","description":"Purchase service packages.\n\nCommands:\n- package.purchase: Purchase a package\n  Input: {\"packageId\": \"string\", \"quantity\": \"number\", \"paymentMethod\": \"string\"}\n  Output: {\"purchaseId\": \"string\", \"totalCost\": \"number\", \"items\": [{\"itemId\": \"string\", \"quantity\": \"number\"}]}","tags":["package","bundle","purchase"],"examples":["{\"command\": \"package.purchase\", \"packageId\": \"pkg_123\", \"quantity\": 1, \"paymentMethod\": \"card_456\"}"]},{"id":"user-management","name":"User Management","description":"Check user existence and details.\n\nCommands:\n- users.check: Check if user exists\n  Input: {\"userId\": \"string\"}\n  Output: {\"exists\": \"boolean\", \"userId\": \"string\", \"status\": \"string\"}","tags":["user","check","verify"],"examples":["{\"command\": \"users.check\", \"userId\": \"user_123\"}"]},{"id":"buffer-management","name":"Buffer Management","description":"Reserve, track, and manage buffer allocations.\n\nCommands:\n- buffer.reserve: Reserve buffer\n  Input: {\"amount\": \"number\", \"purpose\": \"string\", \"expiresInMinutes\": \"number\"}\n  Output: {\"bufferId\": \"string\", \"amount\": \"number\", \"expiresAt\": \"string\"}\n\n- buffer.usage: Check buffer usage\n  Input: {\"bufferId\": \"string\"}\n  Output: {\"bufferId\": \"string\", \"allocated\": \"number\", \"used\": \"number\", \"remaining\": \"number\"}\n\n- buffer.status: Get buffer status\n  Input: {} (no parameters required)\n  Output: {\"buffers\": [{\"bufferId\": \"string\", \"amount\": \"number\", \"status\": \"string\"}], \"totalAllocated\": \"number\"}\n\n- buffer.clear_all: Clear all buffers\n  Input: {} (no parameters required)\n  Output: {\"success\": \"boolean\", \"clearedCount\": \"number\"}","tags":["buffer","reserve","allocation"],"examples":["{\"command\": \"buffer.reserve\", \"amount\": 100, \"purpose\": \"transaction\", \"expiresInMinutes\": 30}","{\"command\": \"buffer.usage\", \"bufferId\": \"buf_123\"}","{\"command\": \"buffer.status\"}","{\"command\": \"buffer.clear_all\"}"]},{"id":"coupon-system","name":"Coupon System","description":"Generate, list, get, revoke, and redeem coupons.\n\nCommands:\n- coupon.generate: Generate a coupon (admin only, requires API key)\n  Input: {\"tokenAmount\": \"number\", \"priceUsd\": \"number\", \"expiresInDays\": \"number\"}\n  Output: {\"coupon\": {\"couponCode\": \"string\", \"tokenAmount\": \"number\", \"priceUsd\": \"number\", \"status\": \"string\", \"expiresAt\": \"string\"}}\n\n- coupon.list: List all coupons (admin only, requires API key)\n  Input: {\"status\": \"string\", \"limit\": \"number\"}\n  Output: {\"coupons\": [{\"couponCode\": \"string\", \"tokenAmount\": \"number\", \"status\": \"string\"}], \"count\": \"number\"}\n\n- coupon.get: Get coupon details (admin only, requires API key)\n  Input: {\"couponCode\": \"string\"}\n  Output: {\"coupon\": {\"couponCode\": \"string\", \"tokenAmount\": \"number\", \"priceUsd\": \"number\", \"status\": \"string\", \"expiresAt\": \"string\"}}\n\n- coupon.revoke: Revoke a coupon (admin only, requires API key)\n  Input: {\"couponCode\": \"string\"}\n  Output: {\"success\": \"boolean\"}\n\n- coupon.redeem: Redeem coupon code (requires JWT authentication)\n  Input: {\"couponCode\": \"string\"}\n  Output: {\"transactionId\": \"string\", \"tokensAdded\": \"number\", \"newBalance\": \"number\"}","tags":["coupon","promo","discount"],"examples":["{\"command\": \"coupon.generate\", \"tokenAmount\": 100, \"priceUsd\": 10.00, \"expiresInDays\": 30}","{\"command\": \"coupon.list\", \"status\": \"active\", \"limit\": 50}","{\"command\": \"coupon.get\", \"couponCode\": \"ABCD-EFGH-IJKL\"}","{\"command\": \"coupon.revoke\", \"couponCode\": \"ABCD-EFGH-IJKL\"}","{\"command\": \"coupon.redeem\", \"couponCode\": \"ABCD-EFGH-IJKL\"}"]},{"id":"admin-operations","name":"Admin Operations","description":"Administrative operations including refunds.\n\nCommands:\n- admin.refund: Process a refund (admin only)\n  Input: {\"transactionId\": \"string\", \"amount\": \"number\", \"reason\": \"string\"}\n  Output: {\"refundId\": \"string\", \"status\": \"string\", \"refundedAmount\": \"number\"}","tags":["admin","refund","management"],"examples":["{\"command\": \"admin.refund\", \"transactionId\": \"txn_123\", \"amount\": 50.00, \"reason\": \"Customer request\"}"]}]}
