{% columns %}
{% column width="50%" %}
## Get Started with KwikPaisa
Launch payments, payouts, and banking APIs in minutes.
Create your account, generate API keys, and make your first live API request using simple integration examples for every major tech stack.
{% hint style="warning" icon="life-ring" %}
**Need some help?**
Troubleshoot common issues or ask for help.
I get a 401 Unauthorized error
This usually happens when the request signature is invalid or required authentication headers are missing.
#### Verify the following:
* `x-client-id` is correct
* `x-signature` is generated properly
* `x-timestamp` is a valid UNIX timestamp
* Your API secret key is correct
* Request body matches the exact payload used during signature generation
KwikPaisa Signature Formula
HMAC\_SHA256(payload + timestamp, secret\_key)
#### Important Rules
* Payload keys must be recursively sorted
* JSON must use unescaped slashes
* Signature must be generated using the exact request payload
I get a 400 Bad Request error
This means one or more required request fields are missing or invalid.
#### Common Reasons
* Invalid amount format
* Missing `order_id`
* Invalid UPI ID or bank details
* Empty request body
* Invalid JSON structure
#### Example
For Create Order API:
* `amount`
* `customer_mobile`
* `order_id`
must be passed correctly.
Also ensure:
* `Content-Type: application/json`
* Valid request payload format
My payment or payout stays in processing
Transactions may remain in processing state while awaiting confirmation from banking or UPI networks.
#### Recommended Action
* Use Order Status API for payments
* Use Payout Status API for payouts
* Avoid creating duplicate requests for the same transaction
#### Payment APIs
* Create Order
* Order Status
* Order Cancel
#### Payout APIs
* Balance Inquiry
* Transaction Initiation
* Payout Status
The request succeeds, but the response is not what I expect
This usually happens due to:
* Incorrect environment usage
* Wrong webhook handling
* Duplicate order IDs
* Invalid payout mode
* Incorrect callback parsing
#### Verify:
* You are using the correct API endpoint
* Request payload matches API documentation
* Webhook responses are being parsed correctly
* Transaction status is checked using status APIs
#### Recommended
Always rely on:
* Order Status API
* Payout Status API
instead of frontend callback responses.
My webhook is not working
#### Verify the following:
* Webhook URL is publicly accessible
* Your server returns HTTP `200 OK`
* SSL certificate is valid
* Firewall is not blocking requests
#### Important
KwikPaisa automatically retries failed webhook deliveries.
Ensure your webhook:
* accepts POST requests
* processes JSON payloads
* responds quickly
My signature works locally but fails on server
This is usually caused by payload formatting differences.
#### Ensure:
* Payload sorting is identical
* JSON encoding is consistent
* Timestamp is generated in seconds
* No extra spaces or formatting changes exist
#### Correct Signature Logic
```
signature = HMAC_SHA256(payload + timestamp, secret_key)
```
{% file src="/files/R87geOSlo8c4TtoszIdL" %}
I get insufficient balance errors during payouts
Your payout wallet balance may be low.
#### Before initiating payouts:
* Check available balance using Balance Inquiry API
* Ensure sufficient wallet balance exists
* Verify payout limits configured for your account
Duplicate transaction detected
KwikPaisa blocks duplicate transaction attempts for security and reconciliation purposes.
#### Best Practices
* Always use unique `order_id`
* Avoid retrying instantly
* Use status APIs before retrying failed transactions
Which APIs should I use for transaction verification?
For reliable transaction verification:
#### Payments
Use:
* Order Status API
#### Payouts
Use:
* Payout Status API
Avoid relying only on:
* frontend redirects
* user-side success screens
* temporary processing responses
{% endhint %}
With your first integration complete, explore our API guides and references to build payments, payouts, and banking workflows with KwikPaisa.
Get startedAPI reference
{% endcolumn %}
{% column width="50%" %}
{% stepper %}
{% step %}
#### Create Your Merchant Account
Sign up and generate your API credentials to start integrating KwikPaisa APIs.
Sign upLog in
{% endstep %}
{% step %}
#### Make Your First API Request
Connect with KwikPaisa APIs using secure authentication and signature-based requests.
```
Endpoint:
POST {baseUrl}/api/v3/pg/order/create
```
{% tabs %}
{% tab title="JavaScript" %}
{% code overflow="wrap" %}
```javascript
const crypto = require('crypto');
const payload = {
amount: "100.00",
order_id: "ORD123456"
};
const timestamp = Math.floor(Date.now() / 1000);
const signature = crypto
.createHmac('sha256', 'YOUR_SECRET_KEY')
.update(JSON.stringify(payload) + timestamp)
.digest('hex');
console.log(signature);
```
{% endcode %}
{% endtab %}
{% tab title="Python" %}
{% code overflow="wrap" %}
```python
import json
import hmac
import hashlib
import time
payload = {
"amount": "100.00",
"order_id": "ORD123456"
}
# Sort payload keys
sorted_payload = dict(sorted(payload.items()))
# Convert to JSON
payload_json = json.dumps(
sorted_payload,
separators=(',', ':')
)
# Generate timestamp
timestamp = str(int(time.time()))
# Generate signature
signature = hmac.new(
b'YOUR_SECRET_KEY',
(payload_json + timestamp).encode(),
hashlib.sha256
).hexdigest()
print(signature)
```
{% endcode %}
{% endtab %}
{% tab title="cURL" %}
{% code overflow="wrap" %}
```bash
curl --request POST \
--url {baseUrl}/api/v3/pg/order/create \
--header "Content-Type: application/json" \
--header "x-client-id: YOUR_CLIENT_ID" \
--header "x-timestamp: 1716206400" \
--header "x-signature: GENERATED_SIGNATURE" \
--data '{
"amount": "100.00",
"order_id": "ORD123456",
"customer_mobile": "9999999999"
}'
```
{% endcode %}
{% endtab %}
{% tab title="Go" %}
{% code overflow="wrap" expandable="true" %}
```go
package main
import (
"crypto/hmac"
"crypto/sha256"
"encoding/hex"
"encoding/json"
"fmt"
"time"
)
func main() {
payload := map[string]string{
"amount": "100.00",
"order_id": "ORD123456",
}
payloadJSON, _ := json.Marshal(payload)
timestamp := fmt.Sprintf("%d", time.Now().Unix())
message := string(payloadJSON) + timestamp
secretKey := "YOUR_SECRET_KEY"
h := hmac.New(sha256.New, []byte(secretKey))
h.Write([]byte(message))
signature := hex.EncodeToString(h.Sum(nil))
fmt.Println(signature)
}
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% endstep %}
{% step %}
#### Parse the Response
If the request is successful, KwikPaisa APIs return a response like this:
{% code title="response.json" overflow="wrap" %}
```json
{
"code": "200",
"status": "success",
"message": "API authentication successful!",
"return_data": {
"kwikX_order_id": "kp_40dec464-7155-43a3-855d-c95c5ab1be71",
"created_at": "13-05-2026 08:34 AM",
"order_id": 3501946751751,
"order_status": "UN_PAID",
"payment_link": "http://orchestration.localhost/payment/sandbox/pay_TSN7ASUDmzcZNyH8qLeG8PrR4CWB9pwFQOuDPYia0fd5k2fMzN"
}
}
```
{% endcode %}
{% endstep %}
{% endstepper %}
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="50%" %}
{% endcolumn %}
{% column width="50%" valign="middle" %}
## Explore the KwikPaisa Developer Platform
Access integration guides, API references, webhook documentation, and SDK examples to build secure payment and banking experiences with KwikPaisa.
API GuidesAPI Reference
{% endcolumn %}
{% endcolumns %}
Need Integration Support?
Get help with API integration, webhooks, payouts, and onboarding from the KwikPaisa technical team.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://developers.kwikpaisa.com/readme.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
