Introduction

Express Checkout provides a streamlined, secure, and fast payment solution for merchants and customers. It supports a variety of payment methods and can easily integrate into existing systems. Whether you're selling a single product or offering a subscription service, our API ensures transactions are quick and frictionless.

Express Checkout APIs are built around basic HTTP communication and closely follows the standards of REST. While the URL themselves are not specific to resources, the URL path is intuitive to reflect the action performed by the API.

API Endpoint

Authentication

Juspay supports two modes of authentication: API Key for server-side calls and Client Auth Token for client-side authentication.

API Key:

• Usage: This is mainly used for server-side API calls. The API key can be retrieved from the Juspay dashboard. The API key is passed as the basic auth username. You do not need to provide a password. If its passed as Authorization in the header then it should be the Basic auth of Base64 encoded value of API Key.

• Security Warning: Never expose your API key to clients or in public repositories.

• The POST/txns API is exempt from authentication to allow sensitive card data to be posted to Juspay’s servers if you are PCI-compliant.

Sample request

To encode the key:

Client Auth Token

• Usage: This is a short-lived token (valid for 15 minutes), generated through the create order or GET /create customer APIs. It can be used for client-side authentication in SDK integration.

Header

• Ensure all requests use application/x-www-form-urlencoded format to avoid failures.

• x-merchantid is mandatory for all API calls and must match the merchant_id provided by Juspay.

Version

Proper version headers ensure that we do not send any information that your client is not capable of handling. Our latest API version is 2021-03-25.

Sample request