For SaaS Setup

Step-by-step checklist for going live with Juspay Hyperswitch SaaS deployment including connector configuration, webhooks, and security

Refer to this checklist for a seamless transition as you prepare to go live with your integration.

The connector configurations set up in the sandbox need to be replicated on the Juspay Hyperswitch production account.

​Signing of Juspay Hyperswitch services agreement

• Ensure that the Juspay Hyperswitch services agreement is signed and shared with the Juspay Hyperswitch team. In case you need any help, please drop an email to [email protected]

The Juspay Hyperswitch team will share your production Juspay Hyperswitch credentials once the above process is completed.

If you are using our SDK, pci compliance is automatically taken care of.

​Connector Configurations

• Configure all the required connectors using production credentials on the Juspay Hyperswitch production dashboard and enable the required payment methods.

• Ensure that the payment methods are enabled on the connector (payment processor) dashboard.

• Enable raw card processing for each connector. Some connectors offer this as a dashboard toggle feature. Some processors might need you to share a PCI Attestation of Compliance over email to enable this.

To access the PCI Attestation of Compliance (AOC) document on Juspay Hyperswitch, simply navigate to the Compliance section under settings in the Juspay Hyperswitch Dashboard. If you need further assistance, you can also email at [email protected]

​Secure your api-keys

• Make sure your secret key (api-key) is not exposed on the front-end (website/mobile app).

• Ensure that your workflow avoids the duplication or storage of your API keys in multiple locations.

​Set up Webhooks

• Configure your webhook endpoint on our dashboard to receive notifications for different events.

• Update Hyperswitch’s webhook endpoints on your connector’s Dashboard. Refer here for detailed instructions.

• Update the connector secret key in our dashboard for us to authenticate webhooks sent by your connector.

​Secure your Payments

• Make sure you decrypt and verify the signed payload sent along with the payment status in your return URL.

• Always verify the payment amount and payment status before fulfilling your customer’s shopping cart/service request.

​Error Handling

• Make sure your API integration is set up to handle all the possible error scenarios (refer this link).

• Ensure your Unified Checkout (SDK) integration is set up to handle all the possible error scenarios (refer this link).

• Ensure that your integration can handle the entire payments lifecycle and test various scenarios using actual payment details.

For more details, kindly refer to the state machine diagrams.

​Customize and sanity check the payment experience

• Ensure the pay button is properly highlighted to the customer.

• Ensure a blended look and feel of the payment experience using the styling APIs of Unified Checkout.

You are good to go to run Juspay Hyperswitch in production and provide your customers with a safe, reliable, and smooth payment experience.