Using Hyperswitch SDK with External Vault

Ideal for teams seeking data independence in a neutral vault combined with Hyperswitch’s optimized payment UI and routing .

In this approach, the Hyperswitch SDK is used to capture card details, but card storage and tokenization are handled by an external vault. Hyperswitch backend orchestrates payments using tokens issued by the external vault.

The merchant configures connectors and routing rules in the Hyperswitch Dashboard. Hyperswitch backend translates orchestration decisions into PSP specific requests using the provided external vault tokens.

The Workflow:

• Client: The HS SDK collects card details.

• Routing: The SDK sends the Card data to Hyperswitch Core.

• External Tokenization: Hyperswitch detects an "External Vault" configuration. Instead of storing the Card Data in its own DB, it sends a request to the External Vault to store the Card Data.

• Mapping: The External Vault returns a third-party token (e.g., tok_ext_123). Hyperswitch saves this token and maps it to a Hyperswitch payment_method_id.

• Payment: When a payment is initiated, Hyperswitch retrieves the raw card data using the third-party token and sends the data to the Processor (Connector).

Integration Documentation :

1. Primary Guide: Unified Checkout: Saving Payment Methods

2. Unified Checkout : Integration guide