---
page_title: ClientAuthToken vs Signature
product: UPI TPAP SDK
platform: Android
page_source: https://juspay.io/in/docs/upi-tpap-sdk/android/miscellaneous/clientauthtoken-vs-signature
llms_txt: https://juspay.io/in/docs/llms.txt
product_llms_txt: https://juspay.io/in/docs/upi-tpap-sdk/llms.txt
---


## ClientAuthToken vs Signature




###   Outer Payload


The APIs in the doc follow a common top level structure for each request and response body with a common outer payload and an API specific inner payload.


### Payload
- **RequestId**:
  - Description: Unique uuid-v4 string
  - Value: Example: abcd-12345-abcd-12345
  - Tags: String, Mandatory
- **Service**:
  - Description: Value: in.juspay.hyperapi
  - Tags: String, Mandatory
- **Payload**:
  - Description: Parameters required to call Hyper SDK API
  - Tags: JSON, Mandatory





###   Inner Payload


Each Inner Payload must contain one of the two authentication field group:

> **Note**
> In the inner payload, only one of the below details is required to be passed. In case payload with signature is being passed in the request already, there is no need to pass clientAuthToken in the payload.






###   Payload structure with signature



### Payload
- **RequestId**:
  - Description: Unique uuid-v4 string
  - Value: Example: abcd-12345-abcd-12345
  - Tags: String, Mandatory
- **Service**:
  - Description: Value: in.juspay.hyperapi
  - Tags: String, Mandatory
- **Payload**:
  - Description: Parameters required to call Hyper SDK API
  - Value:
    - **MerchantKeyId**:
      - Description: Key ID to identify the public-private key pair used for signature generation.
    - **Signature**:
      - Description: Signature generated for the signaturePayload .
    - **SignaturePayload**:
      - Description: Parameters required to call Hyper SDK API
      - Value:
        - **Merchant_id**:
          - Description: Unique identifier associated with an account created by juspay. Ex: stock
          - Value: stock
          - Tags: String, Mandatory
        - **Customer_id**:
          - Description: Any unique reference associated with your customer.
          - Tags: String, Mandatory
        - **Timestamp**:
          - Description: Time when request is created in milliseconds.
          - Tags: String, Mandatory
  - Tags: JSON, Mandatory




#### Code Snippets: -

#### Java Code Snippet:

```java
{"success":false,"message":"Failed to fetch snippet"}
```

#### Kotlin Code Snippet:

```kotlin
{"success":false,"message":"Failed to fetch snippet"}
```



###   Payload structure with clientAuthToken



### Payload
- **RequestId**:
  - Description: Unique uuid-v4 string
  - Value: Example: abcd-12345-abcd-12345
  - Tags: String, Mandatory
- **Service**:
  - Description: Value: in.juspay.hyperapi
  - Tags: String, Mandatory
- **Payload**:
  - Description: Parameters required to call Hyper SDK API
  - Value:
    - **ClientAuthToken**:
      - Tags: String, Mandatory
  - Tags: JSON, Mandatory




#### Code Snippets: -

#### Java Code Snippet:

```java
{"success":false,"message":"Failed to fetch snippet"}
```

#### Kotlin Code Snippet:

```kotlin
{"success":false,"message":"Failed to fetch snippet"}
```


---

## Complete Code Reference

The following code files are referenced in the steps above:

### InitiatePayload.txt

```
{"success":false,"message":"Failed to fetch snippet"}
```


---

## See Also

- [Order ID Format](https://juspay.io/in/docs/upi-tpap-sdk/android/miscellaneous/order-id-format)
- [Session Expiry](https://juspay.io/in/docs/upi-tpap-sdk/android/miscellaneous/session-expiry)
