Non-custodial crypto payment platform for USDC/USDT on Solana and Base
\nStablix provides secure, escrow-based payment infrastructure for online businesses. When a customer pays, funds are held in a smart contract escrow until the merchant releases them or the buffer period expires.
\nProduction: https://api.stablix.xyz/api/v1\n\n✅ Accept USDC/USDT on Solana and Base
\n✅ Non-custodial escrow protection
\n✅ Recurring subscriptions with token approvals
\n✅ Built-in dispute resolution
\n✅ Real-time webhooks
\n✅ Tiered volume limits with KYC
\nGet your API key from the Stablix dashboard
\nSet up your environment variables
\nCreate your first invoice
\nSet up webhooks to receive payment notifications
\nEmail: support@stablix.xyz
\nDiscord: discord.gg/stablix
\nAll API requests require authentication using an API key.
\nInclude your API key in the x-api-key header:
x-api-key: sk_live_xxxxxxxxxxxxxxxxxxxx\nWhen creating an API key, you can specify permissions:
\nRate limit headers are included in every response:
\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 58\nX-RateLimit-Reset: 1640000000\nFor POST requests, include x-idempotency-key header to prevent duplicate operations:
x-idempotency-key: unique-request-id-12345\nIdempotency keys are valid for 24 hours.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":"{{API_KEY}}"}]},"isInherited":true,"source":{"_postman_id":"834a5bf6-746a-494b-9390-7470ba320d12","id":"834a5bf6-746a-494b-9390-7470ba320d12","name":"Stablix API Docs","type":"collection"}},"urlObject":{"protocol":"https","host":["api","stablix","xyz"],"query":[],"variable":[]}},"response":[],"_postman_id":"a209a6ce-adce-4b82-a677-545afbf34102"},{"name":"About Webhooks","id":"25cfeff6-0cef-44c6-8847-b1e233618f78","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.stablix.xyz","description":"Webhooks notify your application when events occur in Stablix.
\n{\n \"id\": \"evt_xxxxxxxxxxxxx\",\n \"type\": \"invoice.paid\",\n \"created_at\": \"2025-02-04T00:00:00Z\",\n \"data\": {\n \"invoice_id\": \"inv_xxxxxxxxxxxxx\",\n \"amount\": 100.00,\n \"status\": \"paid\"\n }\n}\nAll webhooks are signed using HMAC-SHA256. Verify using:
\nconst crypto = require('crypto');\n\nfunction verifyWebhook(payload, signature, timestamp, secret) {\n const signedPayload = `${timestamp}.${JSON.stringify(payload)}`;\n const expectedSignature = crypto\n .createHmac('sha256', secret)\n .update(signedPayload)\n .digest('hex');\n \n return crypto.timingSafeEqual(\n Buffer.from(signature),\n Buffer.from(expectedSignature)\n );\n}\nIf your endpoint returns non-2xx, Stablix retries:
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":"{{API_KEY}}"}]},"isInherited":true,"source":{"_postman_id":"834a5bf6-746a-494b-9390-7470ba320d12","id":"834a5bf6-746a-494b-9390-7470ba320d12","name":"Stablix API Docs","type":"collection"}},"urlObject":{"protocol":"https","host":["api","stablix","xyz"],"query":[],"variable":[]}},"response":[],"_postman_id":"25cfeff6-0cef-44c6-8847-b1e233618f78"},{"name":"About Errors","id":"77db9dbf-ec78-45a3-92d0-f3817d8a3974","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.stablix.xyz","description":"Stablix uses conventional HTTP response codes.
\n{\n \"success\": false,\n \"error\": {\n \"code\": \"INVALID_AMOUNT\",\n \"message\": \"Amount must be greater than 0\",\n \"details\": {\n \"field\": \"amount\",\n \"value\": -10\n }\n }\n}\nDocumentation and guides for using the Stablix API. These requests are for reference only - they demonstrate concepts rather than functional endpoints.
\n","_postman_id":"93bc436d-fb41-445f-bf44-cae6e8f820d3","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":"{{API_KEY}}"}]},"isInherited":true,"source":{"_postman_id":"834a5bf6-746a-494b-9390-7470ba320d12","id":"834a5bf6-746a-494b-9390-7470ba320d12","name":"Stablix API Docs","type":"collection"}}},{"name":"Invoices","item":[{"name":"Create Invoice","id":"c7faafbb-a871-45a2-bcfe-7e9f1b7af75c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"x-idempotency-key","value":"cc8a3d15-a423-4724-9595-5a06fe2a2286","description":"Unique key to prevent duplicate invoices. Use order ID or UUID.
\n","type":"text"}],"body":{"mode":"raw","raw":"{\n \"amount\": 100.00,\n \"currencies\": [\"USDC\", \"USDT\"],\n \"chains\": [\"solana\", \"base\"],\n \"description\": \"Order #12345\",\n \"customer_email\": \"customer@example.com\",\n \"metadata\": {\n \"order_id\": \"12345\",\n \"product\": \"Premium Plan\"\n },\n \"buffer_hours\": 24,\n \"expires_in\": 3600\n}"},"url":"https://api.stablix.xyz/api/v1/invoices","description":"Create a new payment invoice. Returns a payment URL and addresses where customers can send funds.
\n{\n \"success\": true,\n \"data\": {\n \"invoice_id\": \"inv_Y7xLCd5BPfPs1023hBMJ7\",\n \"amount\": 100.00,\n \"status\": \"pending\",\n \"payment_url\": \"https://pay.stablix.xyz/inv_Y7xLCd5BPfPs1023hBMJ7\",\n \"payment_address\": {\n \"solana\": \"7wcwUMtrb5JXqpLyi4U5j6zjtMZvUFyuhwP8oso3LJLT\",\n \"base\": \"0x659CE0FC2499E1Fa14d30F5CD88aD058ba490e39\"\n },\n \"expires_at\": \"2025-02-04T01:00:00Z\"\n }\n}\nRetrieve details of a specific invoice.
\n{\n \"success\": true,\n \"data\": {\n \"invoice_id\": \"inv_Y7xLCd5BPfPs1023hBMJ7\",\n \"amount\": 100.00,\n \"status\": \"paid\",\n \"paid_at\": \"2025-02-04T00:30:00Z\",\n \"paid_chain\": \"solana\",\n \"paid_currency\": \"USDC\",\n \"tx_hash\": \"5xyz...\",\n \"escrow_status\": \"funded\",\n \"release_at\": \"2025-02-05T00:30:00Z\"\n }\n}\nThe invoice ID (starts with inv_)
\n","type":"text/plain"},"type":"any","value":"inv_Y7xLCd5BPfPs1023hBMJ7","key":"invoiceId"}]}},"response":[{"id":"0924bb78-d3c9-4299-92f7-1e20ba2226e0","name":"Paid Invoice","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.stablix.xyz/api/v1/invoices/:invoiceId","host":["https://api.stablix.xyz/api/v1"],"path":["invoices",":invoiceId"],"variable":[{"id":"0e603621-75ef-407b-b6d8-0318079083bd","key":"invoiceId","value":"inv_Y7xLCd5BPfPs1023hBMJ7","description":"The invoice ID (starts with inv_)"}]},"description":"# Get Invoice\n\nRetrieve details of a specific invoice.\n\n## Path Parameters\n\n| Parameter | Description |\n|-----------|-------------|\n| `invoiceId` | The invoice ID (e.g., `inv_Y7xLCd5BPfPs1023hBMJ7`) |\n\n## Response\n\n```json\n{\n \"success\": true,\n \"data\": {\n \"invoice_id\": \"inv_Y7xLCd5BPfPs1023hBMJ7\",\n \"amount\": 100.00,\n \"status\": \"paid\",\n \"paid_at\": \"2025-02-04T00:30:00Z\",\n \"paid_chain\": \"solana\",\n \"paid_currency\": \"USDC\",\n \"tx_hash\": \"5xyz...\",\n \"escrow_status\": \"funded\",\n \"release_at\": \"2025-02-05T00:30:00Z\"\n }\n}\n```\n\n## Invoice Statuses\n\n| Status | Description |\n|--------|-------------|\n| `pending` | Awaiting payment |\n| `paid` | Payment received, funds in escrow |\n| `released` | Funds released to merchant |\n| `refunded` | Funds returned to customer |\n| `disputed` | Payment under dispute |\n| `expired` | Invoice expired without payment |\n| `cancelled` | Invoice cancelled by merchant |"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"data\": {\n \"invoice_id\": \"inv_Y7xLCd5BPfPs1023hBMJ7\",\n \"amount\": 100.00,\n \"status\": \"paid\",\n \"paid_at\": \"2025-02-04T00:30:00Z\",\n \"paid_chain\": \"solana\",\n \"paid_currency\": \"USDC\",\n \"tx_hash\": \"5xyz123abc...\",\n \"escrow_status\": \"funded\",\n \"release_at\": \"2025-02-05T00:30:00Z\"\n }\n}"}],"_postman_id":"1472bc41-8771-4552-b281-75ec8d431dc5"},{"name":"List Invoices","id":"3f031ce1-76e5-4bef-ae65-8c183b672124","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.stablix.xyz/api/v1/invoices?status=paid&limit=20&offset=0","description":"Retrieve a paginated list of invoices.
\n{\n \"success\": true,\n \"data\": {\n \"invoices\": [...],\n \"pagination\": {\n \"total\": 150,\n \"limit\": 20,\n \"offset\": 0,\n \"has_more\": true\n }\n }\n}\nFilter by status: pending, paid, expired, refunded, disputed, cancelled
\n","type":"text/plain"},"key":"status","value":"paid"},{"description":{"content":"Results per page (max: 100)
\n","type":"text/plain"},"key":"limit","value":"20"},{"description":{"content":"Pagination offset
\n","type":"text/plain"},"key":"offset","value":"0"},{"disabled":true,"description":{"content":"Start date (ISO 8601)
\n","type":"text/plain"},"key":"from","value":"2025-01-01T00:00:00Z"},{"disabled":true,"description":{"content":"End date (ISO 8601)
\n","type":"text/plain"},"key":"to","value":"2025-12-31T23:59:59Z"}],"variable":[]}},"response":[],"_postman_id":"3f031ce1-76e5-4bef-ae65-8c183b672124"},{"name":"Cancel Invoice","id":"9cab1747-516e-4c92-8863-f6570447e63e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://api.stablix.xyz/api/v1/invoices/:invoiceId/cancel","description":"Cancel a pending invoice. Only invoices with status: pending can be cancelled.
{\n \"success\": true,\n \"data\": {\n \"invoice_id\": \"inv_xxxxxxxxxxxxx\",\n \"status\": \"cancelled\",\n \"cancelled_at\": \"2025-02-04T00:45:00Z\"\n }\n}\nThe invoice ID to cancel
\n","type":"text/plain"},"type":"any","value":"inv_xxxxxxxxxxxxx","key":"invoiceId"}]}},"response":[],"_postman_id":"9cab1747-516e-4c92-8863-f6570447e63e"},{"name":"Refund Invoice","id":"d68a2db1-475c-4c93-b424-245e4c06e915","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"reason\": \"Customer requested refund\"\n}"},"url":"https://api.stablix.xyz/api/v1/invoices/:invoiceId/refund","description":"Refund a paid invoice. Only available during the buffer period before funds are released.
\n{\n \"success\": true,\n \"data\": {\n \"invoice_id\": \"inv_xxxxxxxxxxxxx\",\n \"status\": \"refunded\",\n \"refund_tx_hash\": \"5abc...\",\n \"refunded_at\": \"2025-02-04T01:00:00Z\"\n }\n}\nThe invoice ID to refund
\n","type":"text/plain"},"type":"any","value":"inv_xxxxxxxxxxxxx","key":"invoiceId"}]}},"response":[],"_postman_id":"d68a2db1-475c-4c93-b424-245e4c06e915"}],"id":"edfe2b25-b97c-4d91-9ed9-58284ff54633","description":"Invoices are one-time payment requests. When you create an invoice, Stablix generates a unique payment address where customers can send funds.
\npending → paid → released\n ↘ refunded\n ↘ disputed\npending → expired\npending → cancelled\n{\n \"invoice_id\": \"inv_Y7xLCd5BPfPs1023hBMJ7\",\n \"merchant_id\": \"mer_xxxxxxxxxxxxx\",\n \"amount\": 100.00,\n \"currencies\": [\"USDC\", \"USDT\"],\n \"chains\": [\"solana\", \"base\"],\n \"description\": \"Order #12345\",\n \"customer_email\": \"customer@example.com\",\n \"status\": \"pending\",\n \"payment_address\": {\n \"solana\": \"7wcwUMtrb...\",\n \"base\": \"0x659CE0FC...\"\n },\n \"buffer_hours\": 24,\n \"expires_at\": \"2025-02-05T00:00:00Z\",\n \"metadata\": {},\n \"created_at\": \"2025-02-04T00:00:00Z\"\n}\nCreate a new subscription plan.
\nSplits allow automatic revenue sharing. Percentages are in basis points (1/100th of a percent).
\n{\n \"address\": \"0x1234...\",\n \"chain\": \"base\",\n \"percentage\": 1000,\n \"label\": \"Partner\"\n}\n⚠️ Important: Split addresses must match the chain (Solana addresses for Solana, EVM for Base).
\n{\n \"success\": true,\n \"data\": {\n \"plan_id\": \"plan_xxxxxxxxxxxxx\",\n \"name\": \"Pro Plan\",\n \"amount\": 29.99,\n \"interval\": \"month\",\n \"subscribe_url\": \"https://pay.stablix.xyz/subscribe/plan_xxxxxxxxxxxxx\"\n }\n}\nRetrieve details of a specific plan.
\n{\n \"success\": true,\n \"data\": {\n \"plan_id\": \"plan_xxxxxxxxxxxxx\",\n \"name\": \"Pro Plan\",\n \"amount\": 29.99,\n \"interval\": \"month\",\n \"interval_count\": 1,\n \"subscriber_count\": 150,\n \"total_revenue\": 4498.50,\n \"created_at\": \"2025-01-01T00:00:00Z\"\n }\n}\nThe plan ID
\n","type":"text/plain"},"type":"any","value":"plan_xxxxxxxxxxxxx","key":"planId"}]}},"response":[],"_postman_id":"3750874d-9a0b-4b17-beb7-0b978ee1c1a0"},{"name":"List Plans","id":"841e14c8-cc33-4c87-8b1d-d739b84c5b02","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.stablix.xyz/api/v1/plans?active=true&limit=20","description":"Retrieve all plans for your merchant account.
\nFilter by active/archived status
\n","type":"text/plain"},"key":"active","value":"true"},{"description":{"content":"Results per page (max: 100)
\n","type":"text/plain"},"key":"limit","value":"20"},{"disabled":true,"description":{"content":"Pagination offset
\n","type":"text/plain"},"key":"offset","value":"0"}],"variable":[]}},"response":[],"_postman_id":"841e14c8-cc33-4c87-8b1d-d739b84c5b02"},{"name":"Update Plan","id":"3e2a6928-519e-4489-934f-a4af1ced5d33","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Pro Plan (Updated)\",\n \"description\": \"Updated description\",\n \"metadata\": {\n \"features\": [\"unlimited_api_calls\", \"priority_support\", \"custom_integrations\"]\n }\n}"},"url":"https://api.stablix.xyz/api/v1/plans/:planId","description":"Update plan details. You cannot change pricing fields (amount, interval) on plans with active subscriptions.
\nThe plan ID to update
\n","type":"text/plain"},"type":"any","value":"plan_xxxxxxxxxxxxx","key":"planId"}]}},"response":[],"_postman_id":"3e2a6928-519e-4489-934f-a4af1ced5d33"},{"name":"Archive Plan","id":"c6923137-6cd0-4291-93e8-c0be429f44f5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://api.stablix.xyz/api/v1/plans/:planId/archive","description":"Archive a plan to prevent new subscriptions. Existing subscriptions continue to bill normally.
\n{\n \"success\": true,\n \"data\": {\n \"plan_id\": \"plan_xxxxxxxxxxxxx\",\n \"archived_at\": \"2025-02-04T00:00:00Z\"\n }\n}\nThe plan ID to archive
\n","type":"text/plain"},"type":"any","value":"plan_xxxxxxxxxxxxx","key":"planId"}]}},"response":[],"_postman_id":"c6923137-6cd0-4291-93e8-c0be429f44f5"},{"name":"Get Public Plan","id":"68df0c28-cf75-4c05-bed1-0528fb48e21b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.stablix.xyz/api/v1/plans/:planId/public","description":"Retrieve public plan information without authentication. Used for subscribe pages.
\n🔓 No API key required
\n{\n \"success\": true,\n \"data\": {\n \"plan_id\": \"plan_xxxxxxxxxxxxx\",\n \"name\": \"Pro Plan\",\n \"description\": \"Access to all premium features\",\n \"amount\": 29.99,\n \"interval\": \"month\",\n \"interval_count\": 1,\n \"currencies\": [\"USDC\", \"USDT\"],\n \"chains\": [\"solana\", \"base\"],\n \"trial_days\": 14,\n \"merchant\": {\n \"business_name\": \"Acme Corp\",\n \"logo_url\": \"https://...\"\n }\n }\n}\nThe plan ID
\n","type":"text/plain"},"type":"any","value":"plan_xxxxxxxxxxxxx","key":"planId"}]}},"response":[],"_postman_id":"68df0c28-cf75-4c05-bed1-0528fb48e21b"}],"id":"6a902a73-e046-4f27-96f9-2737d8bdba63","description":"Plans define the pricing and billing terms for recurring subscriptions. Create plans once, then create subscriptions against them.
\n{\n \"plan_id\": \"plan_xxxxxxxxxxxxx\",\n \"name\": \"Pro Plan\",\n \"description\": \"Access to all premium features\",\n \"amount\": 29.99,\n \"interval\": \"month\",\n \"interval_count\": 1,\n \"currencies\": [\"USDC\", \"USDT\"],\n \"chains\": [\"solana\", \"base\"],\n \"trial_days\": 14,\n \"buffer_hours\": 24,\n \"subscriber_count\": 150,\n \"total_revenue\": 4498.50\n}\nCreate a new subscription. This generates a subscription record that awaits token approval from the subscriber.
\n{\n \"success\": true,\n \"data\": {\n \"subscription_id\": \"sub_xxxxxxxxxxxxx\",\n \"status\": \"pending_approval\",\n \"approve_url\": \"https://pay.stablix.xyz/subscribe/sub_xxxxxxxxxxxxx\"\n }\n}\napprove_url or build your own approval UIConfirm a subscription after the subscriber has approved token spending. This validates the approval on-chain and charges the first payment.
\nWe recommend approving 12 billing cycles:
\nApproval Amount = Plan Amount × 12\nFor a $29.99/month plan: $29.99 × 12 = $359.88
{\n \"success\": true,\n \"data\": {\n \"subscription_id\": \"sub_xxxxxxxxxxxxx\",\n \"status\": \"active\",\n \"first_charge\": {\n \"charge_id\": \"chg_xxxxxxxxxxxxx\",\n \"amount\": 29.99,\n \"tx_hash\": \"5abc...\"\n },\n \"billing\": {\n \"next_charge_at\": \"2025-03-01T00:00:00Z\"\n }\n }\n}\nThe subscription ID to confirm
\n","type":"text/plain"},"type":"any","value":"sub_xxxxxxxxxxxxx","key":"subscriptionId"}]}},"response":[],"_postman_id":"7be9c9a7-a0cb-46b1-9499-e801c5313dd5"},{"name":"Get Subscription","id":"e745580e-2165-486a-aae7-d16e36689fba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.stablix.xyz/api/v1/subscriptions/:subscriptionId","description":"Retrieve details of a specific subscription.
\n{\n \"success\": true,\n \"data\": {\n \"subscription_id\": \"sub_xxxxxxxxxxxxx\",\n \"plan_id\": \"plan_xxxxxxxxxxxxx\",\n \"status\": \"active\",\n \"subscriber\": {\n \"email\": \"subscriber@example.com\",\n \"wallet_address\": \"7wcwUMtrb...\",\n \"external_id\": \"user_123\"\n },\n \"approved_chain\": \"solana\",\n \"approved_currency\": \"USDC\",\n \"approval\": {\n \"approved_amount\": 359.88,\n \"total_charged\": 29.99,\n \"remaining_allowance\": 329.89\n },\n \"billing\": {\n \"current_period_start\": \"2025-02-01T00:00:00Z\",\n \"current_period_end\": \"2025-03-01T00:00:00Z\",\n \"next_charge_at\": \"2025-03-01T00:00:00Z\",\n \"total_charges\": 1\n }\n }\n}\nThe subscription ID
\n","type":"text/plain"},"type":"any","value":"sub_xxxxxxxxxxxxx","key":"subscriptionId"}]}},"response":[],"_postman_id":"e745580e-2165-486a-aae7-d16e36689fba"},{"name":"List Subscriptions","id":"8184e9b9-a155-403d-b6d8-8ffe86ba01e2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.stablix.xyz/api/v1/subscriptions?status=active&plan_id=plan_xxx&limit=20","description":"Retrieve all subscriptions.
\nFilter: active, trialing, past_due, cancelled, paused
\n","type":"text/plain"},"key":"status","value":"active"},{"description":{"content":"Filter by plan ID
\n","type":"text/plain"},"key":"plan_id","value":"plan_xxx"},{"description":{"content":"Results per page (max: 100)
\n","type":"text/plain"},"key":"limit","value":"20"}],"variable":[]}},"response":[],"_postman_id":"8184e9b9-a155-403d-b6d8-8ffe86ba01e2"},{"name":"Cancel Subscription","id":"73dabff9-68d0-4cc0-a12e-f109997f39b2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"reason\": \"Customer requested cancellation\",\n \"cancel_at_period_end\": true\n}"},"url":"https://api.stablix.xyz/api/v1/subscriptions/:subscriptionId/cancel","description":"Cancel a subscription. You can cancel immediately or at the end of the current billing period.
\n{\n \"success\": true,\n \"data\": {\n \"subscription_id\": \"sub_xxxxxxxxxxxxx\",\n \"status\": \"cancelled\",\n \"cancelled_at\": \"2025-02-04T00:00:00Z\",\n \"cancel_at_period_end\": true,\n \"current_period_end\": \"2025-03-01T00:00:00Z\"\n }\n}\nThe subscription ID to cancel
\n","type":"text/plain"},"type":"any","value":"sub_xxxxxxxxxxxxx","key":"subscriptionId"}]}},"response":[],"_postman_id":"73dabff9-68d0-4cc0-a12e-f109997f39b2"},{"name":"Pause Subscription","id":"2b20da3d-1b0b-4b6d-83f1-9bd4f6945767","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"resume_at\": \"2025-03-01T00:00:00Z\"\n}"},"url":"https://api.stablix.xyz/api/v1/subscriptions/:subscriptionId/pause","description":"Pause a subscription. No charges will occur while paused.
\nThe subscription ID to pause
\n","type":"text/plain"},"type":"any","value":"sub_xxxxxxxxxxxxx","key":"subscriptionId"}]}},"response":[],"_postman_id":"2b20da3d-1b0b-4b6d-83f1-9bd4f6945767"},{"name":"Resume Subscription","id":"784c83e0-d415-456f-bc8b-da3c31997f72","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://api.stablix.xyz/api/v1/subscriptions/:subscriptionId/resume","description":"Resume a paused subscription.
\n{\n \"success\": true,\n \"data\": {\n \"subscription_id\": \"sub_xxxxxxxxxxxxx\",\n \"status\": \"active\",\n \"next_charge_at\": \"2025-02-04T00:00:00Z\"\n }\n}\nThe subscription ID to resume
\n","type":"text/plain"},"type":"any","value":"sub_xxxxxxxxxxxxx","key":"subscriptionId"}]}},"response":[],"_postman_id":"784c83e0-d415-456f-bc8b-da3c31997f72"},{"name":"Get Subscription Charges","id":"3a1ea45b-a80c-47fc-a5df-0057c991de44","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.stablix.xyz/api/v1/subscriptions/:subscriptionId/charges","description":"Retrieve all charges for a subscription.
\n{\n \"success\": true,\n \"data\": {\n \"charges\": [\n {\n \"charge_id\": \"chg_xxxxxxxxxxxxx\",\n \"amount\": 29.99,\n \"fee\": 0.15,\n \"net_amount\": 29.84,\n \"escrow_status\": \"released\",\n \"escrow_tx_hash\": \"5xyz...\",\n \"release_tx_hash\": \"5abc...\",\n \"period_start\": \"2025-02-01T00:00:00Z\",\n \"period_end\": \"2025-03-01T00:00:00Z\",\n \"charged_at\": \"2025-02-01T00:00:00Z\"\n }\n ]\n }\n}\nThe subscription ID
\n","type":"text/plain"},"type":"any","value":"sub_xxxxxxxxxxxxx","key":"subscriptionId"}]}},"response":[],"_postman_id":"3a1ea45b-a80c-47fc-a5df-0057c991de44"},{"name":"Refund Charge","id":"49f12db7-a33e-40a0-a3cb-84b627658bc8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"reason\": \"Service issue - customer complaint\"\n}"},"url":"https://api.stablix.xyz/api/v1/subscriptions/:subscriptionId/charges/:chargeId/refund","description":"Refund a specific subscription charge. Only available during the buffer period.
\n{\n \"success\": true,\n \"data\": {\n \"charge_id\": \"chg_xxxxxxxxxxxxx\",\n \"refund_tx_hash\": \"5def...\",\n \"refunded_at\": \"2025-02-04T00:00:00Z\"\n }\n}\nThe subscription ID
\n","type":"text/plain"},"type":"any","value":"sub_xxxxxxxxxxxxx","key":"subscriptionId"},{"id":"5a98a813-897c-4a75-80e2-c140ab13ad02","description":{"content":"The charge ID to refund
\n","type":"text/plain"},"type":"any","value":"chg_xxxxxxxxxxxxx","key":"chargeId"}]}},"response":[],"_postman_id":"49f12db7-a33e-40a0-a3cb-84b627658bc8"}],"id":"bda82fcd-816b-4e16-a914-b1c643a1b98c","description":"Subscriptions handle recurring billing for your customers. They are created against plans and automatically charge customers on each billing cycle.
\npending_approval → active → cancelled\n ↘ trialing → active\n ↘ past_due → active (on retry)\n ↘ cancelled (max retries)\nactive → paused → active (resumed)\nSubscriptions use token approvals (ERC-20 approve / SPL delegate) to enable automatic recurring charges:
When allowance runs low, the subscriber will need to re-approve.
\n","_postman_id":"bda82fcd-816b-4e16-a914-b1c643a1b98c","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":"{{API_KEY}}"}]},"isInherited":true,"source":{"_postman_id":"834a5bf6-746a-494b-9390-7470ba320d12","id":"834a5bf6-746a-494b-9390-7470ba320d12","name":"Stablix API Docs","type":"collection"}}},{"name":"Disputes","item":[{"name":"List Disputes","id":"f40f5bc3-6735-4251-beb6-f5d8005751c4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.stablix.xyz/api/v1/disputes?status=open&limit=20","description":"Retrieve all disputes for your merchant account.
\n{\n \"success\": true,\n \"data\": {\n \"disputes\": [\n {\n \"dispute_id\": \"dsp_xxxxxxxxxxxxx\",\n \"type\": \"invoice\",\n \"invoice_id\": \"inv_xxxxxxxxxxxxx\",\n \"status\": \"open\",\n \"reason\": \"product_not_received\",\n \"amount\": 100.00,\n \"created_at\": \"2025-02-04T00:00:00Z\"\n }\n ]\n }\n}\nFilter: open, under_review, resolved, closed
\n","type":"text/plain"},"key":"status","value":"open"},{"description":{"content":"Results per page
\n","type":"text/plain"},"key":"limit","value":"20"},{"disabled":true,"description":{"content":"Filter: invoice, subscription
\n","type":"text/plain"},"key":"type","value":"invoice"}],"variable":[]}},"response":[],"_postman_id":"f40f5bc3-6735-4251-beb6-f5d8005751c4"},{"name":"Get Dispute","id":"53e8b5c6-50e8-4b45-a2c7-c348cf7ca57f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.stablix.xyz/api/v1/disputes/:disputeId","description":"Retrieve details of a specific dispute.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":"{{API_KEY}}"}]},"isInherited":true,"source":{"_postman_id":"834a5bf6-746a-494b-9390-7470ba320d12","id":"834a5bf6-746a-494b-9390-7470ba320d12","name":"Stablix API Docs","type":"collection"}},"urlObject":{"path":["disputes",":disputeId"],"host":["https://api.stablix.xyz/api/v1"],"query":[],"variable":[{"id":"927e499f-c1b7-4d59-88e1-bb55abdd127b","description":{"content":"The dispute ID
\n","type":"text/plain"},"type":"any","value":"dsp_xxxxxxxxxxxxx","key":"disputeId"}]}},"response":[],"_postman_id":"53e8b5c6-50e8-4b45-a2c7-c348cf7ca57f"},{"name":"Respond to Dispute","id":"463c78a9-117f-4a02-8b95-3f51bc94aca3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"response\": \"The product was delivered on time. Here is proof of delivery.\",\n \"evidence\": {\n \"delivery_proof\": \"https://example.com/tracking.png\",\n \"communication_logs\": \"Email thread showing delivery confirmation\"\n }\n}"},"url":"https://api.stablix.xyz/api/v1/disputes/:disputeId/respond","description":"Submit your response and evidence to contest a dispute.
\n{\n \"success\": true,\n \"data\": {\n \"dispute_id\": \"dsp_xxxxxxxxxxxxx\",\n \"status\": \"under_review\",\n \"response_submitted_at\": \"2025-02-04T01:00:00Z\"\n }\n}\nThe dispute ID
\n","type":"text/plain"},"type":"any","value":"dsp_xxxxxxxxxxxxx","key":"disputeId"}]}},"response":[],"_postman_id":"463c78a9-117f-4a02-8b95-3f51bc94aca3"},{"name":"Accept Dispute","id":"3afc5103-3a85-46ed-b151-ec7f5f29b8c4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://api.stablix.xyz/api/v1/disputes/:disputeId/accept","description":"Accept the dispute and refund the customer. Use this if the customer's claim is valid.
\n{\n \"success\": true,\n \"data\": {\n \"dispute_id\": \"dsp_xxxxxxxxxxxxx\",\n \"status\": \"resolved\",\n \"resolution\": \"accepted\",\n \"refund_tx_hash\": \"5xyz...\",\n \"resolved_at\": \"2025-02-04T01:00:00Z\"\n }\n}\nThe dispute ID to accept
\n","type":"text/plain"},"type":"any","value":"dsp_xxxxxxxxxxxxx","key":"disputeId"}]}},"response":[],"_postman_id":"3afc5103-3a85-46ed-b151-ec7f5f29b8c4"}],"id":"50f8e1f5-2a15-4866-a7c6-5259b7758a84","description":"Disputes allow customers to contest payments. When a dispute is opened, the escrowed funds are held until resolution.
\nopen → under_review → resolved (merchant wins)\n ↘ resolved (customer wins → refund)\n ↘ resolved (split)\nopen → accepted (merchant accepts → refund)\nCheck API health status.
\n🔓 No API key required
\n{\n \"status\": \"healthy\",\n \"version\": \"1.0.0\",\n \"timestamp\": \"2025-02-04T00:00:00Z\"\n}\nAPI health check endpoints. Use these to monitor API availability.
\n","_postman_id":"2207a563-08ee-4814-b4fa-971fa27681f6","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":"{{API_KEY}}"}]},"isInherited":true,"source":{"_postman_id":"834a5bf6-746a-494b-9390-7470ba320d12","id":"834a5bf6-746a-494b-9390-7470ba320d12","name":"Stablix API Docs","type":"collection"}}}],"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":"{{API_KEY}}"}]}},"event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"dafc4fb9-eea3-4db4-b877-55fa344b6c0b"}},{"listen":"test","script":{"type":"text/javascript","exec":["// Auto-save common IDs from responses","if (pm.response.code === 200 || pm.response.code === 201) {"," try {"," const json = pm.response.json();"," if (json.data) {"," if (json.data.invoice_id) pm.environment.set('LAST_INVOICE_ID', json.data.invoice_id);"," if (json.data.plan_id) pm.environment.set('LAST_PLAN_ID', json.data.plan_id);"," if (json.data.subscription_id) pm.environment.set('LAST_SUBSCRIPTION_ID', json.data.subscription_id);"," if (json.data.dispute_id) pm.environment.set('LAST_DISPUTE_ID', json.data.dispute_id);"," }"," } catch (e) {}","}"],"id":"4d6c0e35-049c-44e1-9a08-75f408a1fe78"}}],"variable":[{"key":"baseUrl","value":"https://api.stablix.xyz/api/v1","type":"string"}]}