---
page_title: Introduction
product: API Reference 
page_source: https://juspay.io/br/docs/api-reference-brazil/docs/express-checkout/introduction
llms_txt: https://juspay.io/br/docs/llms.txt
product_llms_txt: https://juspay.io/br/docs/api-reference-brazil/llms.txt
---


# 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** 




| Environment | Endpoint |
|---|---|
| Sandbox | https://api.sandbox.juspay.io |
| Production | https://api.juspay.io |



### **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** 


#### Sample 1 Code Snippet:

```sample 1
curl --location --request POST 'https://api.juspay.io/orders' \
--header 'Authorization: Basic QkIwQjxxxdssjxxxwfqpkddNzBBMUE2Og=='
```

#### Sample 2 Code Snippet:

```sample 2
curl https://api.juspay.io/orders \
    -u "$your_api_key:"
```


**To encode the key:** 


#### Python Code Snippet:

```python
import base64
api_key = "your_api_key"
encoded_key = base64.b64encode(api_key.encode()).decode()
print(encoded_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** 




#### Shell Code Snippet:

```shell
-H 'Content-Type: application/x-www-form-urlencoded'
-H 'x-merchantid:$your_merchantId'

```


* 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** 


#### Sample 1 Code Snippet:

```sample 1
curl https://api.juspay.io/orders \
    -H "version: 2023-06-30" \
    -u "$your_api_key:"
```

#### Sample 2 Code Snippet:

```sample 2
curl --location --request POST 'https://api.juspay.io/orders' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'version: 2023-06-30' \
--header 'Authorization: Basic QkIwQjMxxxxwdqdg8eq0NzBBMUE2Og=='
```


## Sample Code Snippets:
### Top Header:

#### Request Code Snippet:

```request
curl --location --request POST 'https://api.juspay.io/session' \
    --header 'x-merchantid: yourMerchantId' \
    --header 'Authorization: Basic base64encodedkey==' \
    --header 'Content-Type: application/json' \
    --data-raw '{
    "amount":"10.00",
    "order_id":"yourUniqueOrderId",
    "customer_id":"yourUniqueCustId",
    "customer_phone":"9876543210",
    "customer_email":"dummyemail@gmail.com",
    "payment_page_client_id":"picasso",
    "action":"paymentPage",
    "options.create_mandate":"OPTIONAL/REQUIRED",
    "mandate.max_amount":"1000.00",
    "mandate.start_date":"1644420442",
    "mandate.end_date":"1646234827"
}'

```

### Bottom Header:

#### Request:
```json
curl GET 'https://api.juspay.io/orders/{{order_id}}' \
--header 'x-merchantid: merchant_id' \
--header 'Authorization: Basic <base64 of key:>'
--header 'version: 2020-12-31'
```



---

## See Also

- [Integration Architecture](https://juspay.io/br/docs/api-reference-brazil/docs/express-checkout/integration-architecture)