HitPay
HitPay provides payment processing, commerce, invoicing, recurring billing, payout, and business-management APIs for merchants.
Verdict
Common use cases
- Reconcile daily payment totals at month-end
- Triage failed charges from customer support chat
- Check pending balance before approving payouts
- Pull invoice details for billing disputes
- Verify customer payment history during calls
Integration
- Vendor
- HitPay
- Category
- other
- Auth
- API_KEY
- Tools
- 15
- Composio slug
hitpay
Tools
- Get Account Status
Check the connected HitPay business's verification, bank-account, and payment-provider readiness.
- Get Balances
Return available, pending, deposit, and reserve balances by currency and wallet provider.
- Get Location
Retrieve one HitPay business location by ID.
- Get Payment Request
Retrieve the current status and details of one HitPay payment request.
- List Charges
Search completed and attempted charges by status, date, amount, payment request, customer, or location. Returns one page and an opaque continuation cursor.
- List Customers
List customer records stored by the connected HitPay business. Returns one provider-selected page because continuation input has not been verified.
- List Invoices
Find invoices by customer email, status, or merchant reference. Returns one provider page; continuation is unavailable because HitPay's cursor input has not been verified.
- List Locations
List business locations, optionally filtering by name keywords or an exact location ID. Returns one page and a cursor for the next page.
- List Orders
Search HitPay commerce orders by version, status, date, or keywords. Returns one provider page because continuation input is not verified.
- List Payment Requests
Search hosted payment requests and inspect their current payment status.
- List Product Categories
Browse or search active and nested HitPay product categories.
- List Products
Search the HitPay product catalog using product, inventory, location, and sales-channel filters.
- List Recurring Billings
Find recurring billing records by customer, reference, plan, or status.
- List Staff
Return staff members visible to the connected HitPay business account.
- List Subscription Plans
List recurring-payment plans configured for the connected HitPay business.
Setup
Setup guide
- 11. Open your Switchy workspace settings and navigate to the Integrations tab. 2. Find HitPay in the MCP directory and click Connect. 3. Log in to your HitPay dashboard at dashboard.hit-pay.com and go to Settings > API Keys. 4. Generate a new API key with read permissions and copy it. 5. Paste the key into Switchy's connection dialog and click Authorize. 6. Switchy will verify the key and display your connected business name. 7. Open any Project, type '@HitPay get account status' in the chat, and confirm you see verification and balance details. 8. If the response shows your business name and current balance, the connection is live.
What teammates see: by default, memories from HitPay are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Daily Revenue Summary
@HitPay list all completed charges from the past 24 hours and sum the amounts by currency. Show me the total revenue for each currency.
Failed Payment Report
@HitPay list charges with failed status from the past 7 days. Include customer email, amount, and failure reason for each.
Customer Payment History
@HitPay find all charges for customer email jane@example.com. Show the date, amount, status, and payment method for each transaction.
Pending Balance Check
@HitPay get balances for all currencies. Break down available, pending, and reserve amounts for each wallet provider.
Invoice Status Lookup
@HitPay find the invoice with merchant reference INV-2024-001. Show me the status, customer email, amount, and due date.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@HitPay pull our current balances and draft a short cash-flow summary for our weekly team update
Here's your HitPay cash position as of today: Available balance is SGD 8,450.30 (ready to withdraw), pending settlements total SGD 2,100.00 (clears in 1-3 business days), and reserve holds SGD 1,200.00. USD wallet shows $340.50 available. In plain terms: you have about $8.5k SGD liquid, another $2.1k landing soon, and HitPay is holding $1.2k as a rolling reserve. Week-over-week available balance is up 12%.
This example pairs the Get Balances tool with the AI's synthesis capability—raw wallet data becomes a narrative your team can act on. The MCP returns structured balance objects by currency; the AI interprets reserve vs. available. Useful for weekly finance check-ins without logging into the HitPay dashboard.
Use-case deep-dives
When HitPay wins for customer-service refund workflows
A 6-person support team handling 40-60 refund requests daily across Stripe, PayPal, and HitPay needs a single workspace to look up charges and issue refunds without switching tabs. HitPay's MCP is the right call if HitPay represents more than 20% of your payment volume and your team already uses Switchy for ticket context. The Get Payment Request and List Charges tools let agents confirm transaction details in chat, then route to the HitPay dashboard for the actual refund click. The trade-off: if you're only processing 5-10 HitPay transactions a week, the setup overhead outweighs the saved clicks. This MCP pays off when HitPay is a primary payment rail and your support team lives in a shared AI workspace.
HitPay balances belong in your monthly close checklist
A 2-person finance team at a SaaS company with customers in Singapore, Malaysia, and Hong Kong closes books on the 5th of each month and needs to reconcile HitPay balances across three currencies before filing. The Get Balances tool surfaces available, pending, and reserve amounts by currency in one query, so the finance lead can paste results into the reconciliation sheet without logging into HitPay's dashboard. This scenario works if your HitPay volume is predictable and you're already using Switchy for close checklists. If your HitPay account processes fewer than 50 transactions per month, manual dashboard checks are faster. The MCP wins when multi-currency HitPay balances are a recurring line item in your close process.
When HitPay invoice lookup speeds up collections calls
A 3-person sales team at a B2B services firm sends 20-30 HitPay invoices monthly and needs to check payment status before calling customers about overdue balances. The List Invoices tool filters by customer email or status, so the account manager can confirm whether an invoice is paid, pending, or overdue without leaving Switchy during the call. This scenario is borderline if your invoice volume is under 10 per month—manual HitPay dashboard checks are just as fast. The MCP pays off when your team sends enough HitPay invoices that status lookups interrupt the sales conversation multiple times per week. If HitPay is your primary invoicing tool and your team already uses Switchy for CRM context, add this MCP to your workspace.
Frequently asked
What does the HitPay MCP let me do in Switchy?
It connects your HitPay merchant account so your team can check payment statuses, pull transaction histories, look up customer records, and monitor account balances without logging into the HitPay dashboard. Useful for finance ops, customer support, and reconciliation workflows that need live payment data.
Do I need a HitPay API key to connect this MCP?
Yes. You'll generate an API key from your HitPay business dashboard under Settings → API Keys. The key ties to one business account, so whoever connects it in Switchy needs admin or developer access to that HitPay account to create the credential.
Can the HitPay MCP create new payment requests or refund charges?
No. This MCP is read-only — it retrieves payment requests, charges, invoices, and balances but cannot initiate payments, issue refunds, or update customer records. For write operations you still need the HitPay dashboard or a custom API integration.
How is this different from just using HitPay's dashboard?
The MCP pulls HitPay data into Switchy's shared AI workspace, so your team can ask natural-language questions like "show unpaid invoices from last week" without switching tabs or learning HitPay's UI. The dashboard remains necessary for creating payment links and managing settings.
Who on my team should connect the HitPay MCP?
Whoever owns your HitPay account and can generate API keys — typically your finance lead or a developer. Once connected, any Switchy workspace member can query the data through the AI, but only the connector can rotate or revoke the API key.