Token First Model Setup

Best for PCI compliant merchants who wants to store the card during initial checkout phase without charging their customers.

The Payment method SDK allows you to securely collect payment information and give customers the option to save their payment details for future transactions. By vaulting these details during the initial checkout phase.

Key Features

• Full Token Management – Create, retrieve, update, and delete payment tokens directly from your server.

• PSP and Network Tokenization – Generate both PSP tokens and network tokens through a single API.

• Secure Storage – Store tokens safely in Hyperswitch’s Vault.

• Reduced Frontend Complexity – Shift tokenization processes to the backend, minimizing frontend dependencies.

Understanding Payment and Vault Flow

Vaulting :

1. Collect Card Details – Card details are entered by customer and sent to your server.

2. Send a Tokenization Request – Make a /payment_methods API request with the card details.

3. Token Creation & Validation – Hyperswitch validates the request and generates a secure token in the vault.

4. PSP & Network Tokenization (Optional) – If configured through your Hyperswitch dashboard, we also generate PSP and/or network tokens when you pass relevant parameters as mentioned below

5. Receive Payment Method ID – You get a payment_method_id, which can be used for future payments.

Payment :

1. Payment using stored card : To charge the customer you will will have to call the /payment/create API and pass thepayment_method_id along with confirm as true

Integration Documentation -

• S2S Vault Tokenization

• Create Payment API