Hyperswitch integration
Hyperswitch is an open-source payments orchestrator, self-hosted or run on Juspay's sandbox and production clusters, that routes card and alternative payment methods across many processors behind one API. Create, confirm, capture, cancel, update and list payments, incremental and extended authorizations, session tokens, payment links, external 3DS authentications and 3DS decision rules; create and list refunds, disputes with their evidence uploads and aggregates, mandates, payouts with their confirm, fulfil and cancel steps, and relay requests; manage customers and their saved payment methods; manage merchant accounts, business profiles, merchant connectors and connector webhooks, organizations, profile acquirers, API keys, blocklist fingerprints and batch uploads, GSM rules, card issuers and subscriptions; configure static and dynamic routing including success-based, elimination and contract algorithms, default fallbacks and gateway score feedback; and read webhook events with their delivery attempts and retries. The host is part of the credential: use your own domain when self-hosting, sandbox.hyperswitch.io or api.hyperswitch.io on Hyperswitch's clusters. Authentication is a Hyperswitch key sent in the api-key header. The same header carries the merchant API key and, for merchant-account and organization management, the admin API key, so connect the key whose privileges match the endpoints you call.
Say what should happen.
The workflow builds itself.
What you can do with Hyperswitch
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
List, 9 operations
list_api_keysList api keysGETAPI Key - List.list_customersList customersGETCustomers - List.list_disputesList disputesGETDisputes - List Disputes.list_paymentsList paymentsGETPayments - List.list_payoutsList payoutsGETPayouts - List.list_payouts_with_filtersList payouts with filtersPOSTPayouts - List using filters.list_profile_disputesList profile disputesGETDisputes - List Disputes for The Given Profiles.list_profile_webhook_eventsList profile webhook eventsPOSTEvents - List.list_refundsList refundsPOSTRefunds - List.
Payment method, 6 operations
create_payment_methodCreate payment methodPOSTPaymentMethods - Create.delete_payment_methodDelete payment methodDELETEPayment Method - Delete.get_payment_methodGet payment methodGETPayment Method - Retrieve.list_customer_payment_methodsList customer payment methodsGETList payment methods for a Customer.list_merchant_payment_methodsList merchant payment methodsGETList payment methods for a Merchant.list_saved_payment_methods_for_paymentList saved payment methods for paymentGETList customer saved payment methods for a Payment.
Connector, 4 operations
create_merchant_connectorCreate merchant connectorPOSTMerchant Connector - Create.delete_merchant_connectorDelete merchant connectorDELETEMerchant Connector - Delete.get_merchant_connectorGet merchant connectorGETMerchant Connector - Retrieve.list_merchant_connectorsList merchant connectorsGETMerchant Connector - List.
Create, 4 operations
create_elimination_routing_algorithmCreate elimination routing algorithmPOSTRouting - Elimination.create_payoutCreate payoutPOSTPayouts - Create.create_subscriptionCreate subscriptionPOSTSubscription - Create.create_success_based_routing_algorithmCreate success based routing algorithmPOSTRouting - Auth Rate Based.
Account, 3 operations
create_merchant_accountCreate merchant accountPOSTMerchant Account - Create.delete_merchant_accountDelete merchant accountDELETEMerchant Account - Delete.get_merchant_accountGet merchant accountGETMerchant Account - Retrieve.
Api key, 3 operations
create_api_keyCreate api keyPOSTAPI Key - Create.get_api_keyGet api keyGETAPI Key - Retrieve.revoke_api_keyRevoke api keyDELETEAPI Key - Revoke.
Business profile, 3 operations
create_business_profileCreate business profilePOSTProfile - Create.get_business_profileGet business profileGETProfile - Retrieve.list_business_profilesList business profilesGETProfile - List.
Cancel, 3 operations
cancel_paymentCancel paymentPOSTPayments - Cancel.cancel_payoutCancel payoutPOSTPayouts - Cancel.cancel_subscriptionCancel subscriptionPOSTSubscription - Cancel Subscription.
Card issuer, 3 operations
create_card_issuerCreate card issuerPOSTCard Issuer - Create.delete_card_issuerDelete card issuerDELETECard Issuer - Delete.list_card_issuersList card issuersGETCard Issuer - List.
Confirm, 3 operations
confirm_paymentConfirm paymentPOSTPayments - Confirm.confirm_payoutConfirm payoutPOSTPayouts - Confirm.confirm_subscriptionConfirm subscriptionPOSTSubscription - Confirm.
Customer, 3 operations
create_customerCreate customerPOSTCustomers - Create.delete_customerDelete customerDELETECustomers - Delete.get_customerGet customerGETCustomers - Retrieve.
Eligibility check, 3 operations
create_authentication_eligibility_checkCreate authentication eligibility checkPOSTAuthentication - POST Eligibility Check.list_authentication_eligibility_checksList authentication eligibility checksGETAuthentication - GET Eligibility Check.submit_payment_eligibility_check_dataSubmit payment eligibility check dataPOSTPayments - Submit Eligibility Check Data.
Evidence, 3 operations
attach_dispute_evidenceAttach dispute evidencePUTDisputes - Attach Evidence to Dispute.delete_dispute_evidenceDelete dispute evidenceDELETEDisputes - Delete Evidence attached to a Dispute.get_dispute_evidenceGet dispute evidenceGETDisputes - Retrieve Dispute Evidence.
Filter, 3 operations
list_dispute_filtersList dispute filtersGETDisputes - Disputes Filters.list_payout_filtersList payout filtersPOSTPayouts - List available filters.list_profile_dispute_filtersList profile dispute filtersGETDisputes - Disputes Filters Profile.
Routing, 3 operations
create_routing_configCreate routing configPOSTRouting - Create.get_routing_configGet routing configGETRouting - Retrieve.list_routing_configsList routing configsGETRouting - List.
Aggregate, 2 operations
get_dispute_aggregateGet dispute aggregateGETDisputes - Get Disputes Aggregate.get_profile_dispute_aggregateGet profile dispute aggregateGETDisputes - Get Disputes Aggregate for Profiles.
Authentication, 2 operations
create_authenticationCreate authenticationPOSTAuthentication - Create.create_payment_3ds_authenticationCreate payment 3ds authenticationPOSTPayments - External 3DS Authentication.
Batch, 2 operations
get_blocklist_batch_jobGet blocklist batch jobGETget batch.list_blocklist_batch_jobsList blocklist batch jobsGETlist batch.
Blocklist, 2 operations
block_fingerprintBlock fingerprintPOSTcreate blocklist.list_blocklistList blocklistGETlist blocklist.
Cancel post capture, 2 operations
cancel_payment_post_captureCancel payment post capturePOSTPayments - Cancel Post Capture.get_payment_post_capture_cancellationGet payment post capture cancellationGETPayments - Cancel Post Capture Retrieve.
Eligibility, 2 operations
check_authentication_eligibilityCheck authentication eligibilityPOSTAuthentication - Eligibility.submit_payment_eligibility_dataSubmit payment eligibility dataPOSTPayments - Submit Eligibility Data.
Evaluate, 2 operations
evaluate_routing_ruleEvaluate routing rulePOSTRouting - Rule Evaluate.evaluate_routing_rulesEvaluate routing rulesPOSTRouting - Evaluate.
Mandate, 2 operations
get_mandateGet mandateGETMandates - Retrieve Mandate.list_customer_mandatesList customer mandatesGETMandates - Customer Mandates List.
Organization, 2 operations
create_organizationCreate organizationPOSTOrganization - Create.get_organizationGet organizationGETOrganization - Retrieve.
Payment, 2 operations
create_paymentCreate paymentPOSTPayments - Create.get_paymentGet paymentGETPayments - Retrieve.
Refund, 2 operations
create_refundCreate refundPOSTRefunds - Create.get_refundGet refundGETRefunds - Retrieve.
Relay, 2 operations
create_relayCreate relayPOSTRelay - Create.get_relayGet relayGETRelay - Retrieve.
Subscription, 2 operations
create_and_confirm_subscriptionCreate and confirm subscriptionPOSTSubscription - Create and Confirm.get_subscriptionGet subscriptionGETSubscription - Retrieve.
Accept, 1 operation
accept_disputeAccept disputePOSTDisputes - Accept Dispute.
Activate, 1 operation
activate_routing_configActivate routing configPOSTRouting - Activate config.
Active, 1 operation
get_active_routing_configGet active routing configGETRouting - Retrieve Config.
Attempt, 1 operation
list_webhook_event_attemptsList webhook event attemptsGETEvents - Delivery Attempt List.
Authenticate, 1 operation
authenticate_authenticationAuthenticate authenticationPOSTAuthentication - Authenticate.
Capture, 1 operation
capture_paymentCapture paymentPOSTPayments - Capture.
Client, 1 operation
list_payment_methods_for_paymentList payment methods for paymentGETList payment methods for a Payment.
Complete authorize, 1 operation
complete_payment_authorizationComplete payment authorizationPOSTPayments - Complete Authorize.
Create platform, 1 operation
create_platform_accountCreate platform accountPOSTPlatform - Create.
Deactivate, 1 operation
deactivate_routing_configDeactivate routing configPOSTRouting - Deactivate.
Default, 1 operation
get_default_fallback_routing_configGet default fallback routing configGETRouting - Retrieve Default Config.
Delete, 1 operation
delete_gsm_ruleDelete gsm rulePOSTGsm - Delete.
Dispute, 1 operation
get_disputeGet disputeGETDisputes - Retrieve Dispute.
Enabled authn methods token, 1 operation
create_authentication_method_tokenCreate authentication method tokenPOSTAuthentication - Enable Authn Methods Token.
Estimate, 1 operation
get_subscription_estimateGet subscription estimateGETSubscription - Get Estimate.
Event, 1 operation
list_merchant_webhook_eventsList merchant webhook eventsPOSTEvents - List.
Execute, 1 operation
execute_three_ds_decision_ruleExecute three ds decision rulePOST3DS Decision - Execute.
Extend authorization, 1 operation
extend_payment_authorizationExtend payment authorizationPOSTPayments - Extended Authorization.
Fulfill, 1 operation
fulfill_payoutFulfill payoutPOSTPayouts - Fulfill.
Get, 1 operation
get_gsm_ruleGet gsm rulePOSTGsm - Get.
Gsm, 1 operation
create_gsm_ruleCreate gsm rulePOSTGsm - Create.
Incremental authorization, 1 operation
create_payment_incremental_authorizationCreate payment incremental authorizationPOSTPayments - Incremental Authorization.
Item, 1 operation
list_subscription_itemsList subscription itemsGETSubscription - Get Items.
Pause, 1 operation
pause_subscriptionPause subscriptionPOSTSubscription - Pause Subscription.
Payment link, 1 operation
get_payment_linkGet payment linkGETPayments Link - Retrieve.
Payout, 1 operation
get_payoutGet payoutGETPayouts - Retrieve.
Post session token, 1 operation
create_payment_post_session_tokensCreate payment post session tokensPOSTPayments - Post Session Tokens.
Profile, 1 operation
list_profile_default_routing_configsList profile default routing configsGETRouting - Retrieve Default For Profile.
Profile acquirer, 1 operation
create_profile_acquirerCreate profile acquirerPOSTProfile Acquirer - Create.
Redirect, 1 operation
redirect_authenticationRedirect authenticationPOSTAuthentication - Redirect.
Resume, 1 operation
resume_subscriptionResume subscriptionPOSTSubscription - Resume Subscription.
Retry, 1 operation
retry_webhook_eventRetry webhook eventPOSTEvents - Manual Retry.
Revoke, 1 operation
revoke_mandateRevoke mandatePOSTMandates - Revoke Mandate.
Session token, 1 operation
create_payment_session_tokensCreate payment session tokensPOSTPayments - Session token.
Statu, 1 operation
get_poll_statusGet poll statusGETPoll - Retrieve Poll Status.
Sync, 1 operation
sync_authenticationSync authenticationPOSTAuthentication - Sync.
Toggle, 1 operation
toggle_blocklistToggle blocklistPOSTcreate toggle.
Webhook, 1 operation
register_connector_webhookRegister connector webhookPOSTConfigure Connector Webhook - Register.
Showing the first 120 of 146 endpoints. The rest are in the product, searchable from the workflow builder and from chat.
Use Hyperswitch from Claude Code, Cursor or Codex
Connect Hyperswitch in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Hyperswitch operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Hyperswitch
- Create your workspace
Sign up free. Nothing to install.
- Connect Hyperswitch once
Add your Hyperswitch connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Hyperswitch integration FAQ
What can you do with the Hyperswitch integration?
LiveContext exposes 146 operations on Hyperswitch, covering list, payment method, connector and create.
