1.4 Practical: Running Your First Payment via Hyperswitch (SDK)
Initiate a payment via SDK
Below mentioned are the step-by-step instructions organized in tab groups. Navigate through them in order to successfully initiate a payment via SDK.
Open the Hyperswitch Control Center:
Open your browser and navigate to: http://localhost:9000/dashboard/login.
You should see the Hyperswitch login screen with fields for Email and Password and options for “sign in with an email”.
Choose email-based sign-in:
On the login screen, click “sign-up”.
Enter an email ID of your choice in the Email field and click Continue.
Trigger the magic link:
After you click Continue, the screen will show a message saying “Please check your inbox” indicating that a magic login link has been sent to your email.
Open Mailhog to view the email:
In a new tab, go to: http://localhost:8025
This opens Mailhog, which captures outbound emails from your local Hyperswitch setup. You should see two emails in the inbox with subjects “Welcome to the HyperSwitch community!”, “Thank you for signing up on Hyperswitch Dashboard!”
Open the welcome email and confirm:
Click the “Welcome to the HyperSwitch community!” email.
Inside, you’ll see a message thanking you for signing up and a button to confirm your email address .
Click the confirmation button to complete email verification and continue the login flow.
(Optional) Two-Factor Authentication setup:
After confirming the email, you are redirected to an “Enable Two Factor Authentication” screen.
For the Academy setup, you can click “Skip now” to proceed without enabling 2FA, or follow the steps on screen if you want to configure an authenticator app.
Set up your dashboard password:
Next, you’ll see the “Set password” screen.
Enter a strong password in the Password and Confirm Password fields and click Confirm.
This sets your Control Center password for future logins
Return to the login screen:
After setting the password, you are redirected back to the standard login page at http://localhost:9000/dashboard/login.
Log in with email and password:
On the login page, enter the same email (e.g., [email protected]) and the password you just configured, then click Continue.
If authentication succeeds, you will be logged in to the Control Center.
Complete initial business setup:
On first login, you’ll see a “Welcome aboard! Let’s get started” modal asking for basic business details.
Enter a Business name (for example, “Academy”) and click Start Exploring.
You are now taken to the Control Center home page and are ready to configure connectors and run your first test payment.
Navigate to the Control Center Home:
Once logged in, you’ll land on the Control Center home page.
Here, you’ll see two important tiles: Integrate a Processor and Demo our checkout experience.
Go to Connectors → Payment Processors:
From the left navigation panel, click Connectors → Payment Processors.
Here, Hyperswitch shows all processors you can connect.
You’ll also see an option to Connect a Dummy Processor for testing.
Choose a Dummy Processor:
Click Connect a Dummy Processor.
A modal will open showing dummy processors such as Fauxpay, Paypal Dummy, Pretendpay, and Stripe Dummy.
Select Fauxpay by clicking Connect.
Configure Dummy Processor Credentials:
You are now taken to the processor setup screen.
Since this is a dummy processor, credentials like API keys are pre-filled.
Click Connect and Proceed to continue.
Select Payment Methods:
Next, you’ll see a list of payment methods supported by this dummy connector (Visa, Mastercard, Amex, etc.).
Ensure all methods are enabled, then click Proceed.
Review Summary:
The final step shows a summary of your setup:
Integration status: ACTIVE
Webhook endpoint
Profile
Credentials
Click Done to complete the connector setup.
Verify the Connector is Active:
Back on the Payment Processors page, you should now see Fauxpay listed under Connected Processors with status ACTIVE.
This confirms your setup is successful.
Return to Home to Start a Test Payment:
Go back to Overview from the left navigation.
You will now see the tile Make a test payment – Try our unified checkout.
Click Try It Out.
Setup Checkout Parameters:
You are now taken to the Setup Checkout screen.
The form on the left controls the checkout session, while the right side shows a live preview of the payment UI.
Enter amount 100 and leave defaults unchanged.
Click Show preview.
Preview the Unified Checkout Experience:
The preview pane on the right updates to show the available payment methods in this case, Card. You can verify how inputs (Card Number, Expiry, CVC) render.
Enter Test Card Details and Initiate the Payment:
On the Setup Checkout page, fill in the test card information in the preview widget:
Card Number: 4242 4242 4242 4242
Expiry: Any valid future date (e.g., 10/31)
CVC: Any 3 digits (e.g., 123)
Card Nickname: Optional (e.g., “VISA”)
Once all details are entered, click the Pay USD 100 button at the bottom of the preview. This action triggers the payment flow through the connected dummy processor (Fauxpay), simulating the exact behavior of a production checkout experience.
Payment Successfully Completed:
After a moment, you’ll see a confirmation screen indicating Payment Successful.
This tells you the processor responded positively and Hyperswitch updated the payment status accordingly.
Click Go to Payment Operations to review the payment details in the Control Center.
Reviewing the Payment in Control Center:
You’ll be taken to the detailed payment view under: Operations → Payments
This page contains the full breakdown of the payment lifecycle. The main summary shows:
Amount: 100 USD
Status: SUCCEEDED
Payment ID
Connector transaction ID
Connector used: Fauxpay
Last updated