> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eliteneobank.com/llms.txt
> Use this file to discover all available pages before exploring further.

# First api request

# First API request

Now that your Sandbox API credentials are ready, you can make your first authenticated request using the Elite Neo Bank Payment Gateway APIs.

In this guide, you will:

* Create your first payment order
* Generate authentication headers
* Send an authenticated API request
* Receive a hosted checkout payment link

Before continuing, ensure you have already completed:

* Account onboarding
* Sandbox credential generation
* Authentication setup

Recommended prerequisites:

➡️ [Generate API Credentials](https://docs.eliteneobank.com/guide/quick-start/generate-api-keys.md)\
➡️ [Authentication → Headers](https://docs.eliteneobank.com/guide/authentication/headers.md)\
➡️ [Authentication → Timestamp](https://docs.eliteneobank.com/guide/authentication/timestamp.md)\
➡️ [Authentication → Signature](https://docs.eliteneobank.com/guide/authentication/signature.md)

***

## Create Your First Payment Order

The Create Order API generates a hosted checkout session and returns a secure payment link that can be shared with customers.

Example request payload:

```json theme={null}
{
  "order_id": 6116229263036,
  "order_amount": 105,
  "order_currency": "INR",
  "order_note": "Additional order info",
  "service_type": "DIGITAL",
  "customer": {
    "name": "Ajay",
    "email": "developer@jangras.co",
    "phone": "9816512345",
    "address": {
      "line1": "Capital Office, Kemp House",
      "line2": "152 - 160 City Road",
      "city": "London",
      "state": "London",
      "country": "UK",
      "postal_code": "EC1V 2NX"
    }
  },
  "return_url": "https://merchant.in/process_return.php?order_id=order_1626945143520"
}
```

## Generate Authentication Headers

Before sending the request:

1. Generate a UNIX timestamp
2. Generate the HMAC SHA256 signature
3. Attach authentication headers

Required authentication headers:

➡️ [Authentication → Headers](https://docs.eliteneobank.com/guide/authentication/headers.md)\
➡️ [Authentication → Timestamp](https://docs.eliteneobank.com/guide/authentication/timestamp.md)\
➡️ [Authentication → Signature](https://docs.eliteneobank.com/guide/authentication/signature.md)

## Send Your First API Request

Example cURL request:

```json theme={null}
curl --request POST \
--url https://sandbox.Elite Neo Bank.com/api/v3/pg/order/create \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "X-API-KEY: YOUR_API_KEY" \
--header "X-SIGNATURE: GENERATED_SIGNATURE" \
--header "X-TIMESTAMP: GENERATED_TIMESTAMP" \
--data '{
  "order_id": 6116229263036,
  "order_amount": 105,
  "order_currency": "INR",
  "order_note": "Additional order info",
  "service_type": "DIGITAL",
  "customer": {
    "name": "Ajay",
    "email": "developer@jangras.co",
    "phone": "9816512345"
  },
  "return_url": "https://merchant.in/process_return.php?order_id=order_1626945143520"
}'
```

***

## Example Success Response

```json theme={null}
{
  "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": "https://sandbox.Elite Neo Bank.com/payment/pay_TSN7ASUDmzcZNyH8qLeG8PrR4CWB9pwFQOuDPYia0fd5k2fMzN"
  }
}
```

***

## Redirect Customer to Hosted Checkout

Use the returned:

```
payment_link
```

to redirect customers to the Elite Neo Bank Hosted Checkout page.

Example:

```
window.location.href = payment_link;
```

Customers can then complete payment securely using the hosted payment interface.

***

## Verify Payment Status

After payment completion:

* Verify payment status server-side
* Use the Order Status API
* Validate webhook notifications
* Reconcile transaction records

Recommended references:

➡️ [Payment Gateway → Order Status API](https://docs.eliteneobank.com/guide/payment-gateway-integration/create-order.md)\
➡️ [Webhooks → Webhook Setup](https://docs.eliteneobank.com/guide/webhooks/webhook-setup.md)\
➡️ [Webhooks → Signature Verification](https://docs.eliteneobank.com/guide/webhooks/signature-verification.md)

***

## Recommended Integration Flow

1. [Generate API credentials](https://docs.eliteneobank.com/guide/quick-start/generate-api-keys.md)
2. [Configure authentication](https://docs.eliteneobank.com/guide/authentication/headers.md)
3. [Create payment order](https://docs.eliteneobank.com/guide/payment-gateway-integration/create-order.md)
4. [Redirect customer to hosted checkout](https://docs.eliteneobank.com/guide/payment-gateway-integration/redirect-user.md)
5. [Verify payment status](https://docs.eliteneobank.com/guide/payment-gateway-integration/check-status.md)
6. [Process webhook events](https://docs.eliteneobank.com/guide/webhooks/webhook-setup.md)
7. Reconcile transaction

***

## Common Integration Errors

| Error | Possible Reason |
| - | - |
| Invalid Signature | Incorrect signature generation |
| Expired Timestamp | Reused or old timestamp |
| Authentication Failed | Invalid API credentials |
| Invalid Payload | Incorrect request structure |

***

## Production Recommendations

Before moving to production:

* Complete Sandbox testing
* Validate webhook verification
* Implement retry handling
* Enable secure backend signature generation
* Verify transaction reconciliation workflows

Recommended references:

➡️ Sandbox Testing\
➡️ [Retry Logic](https://docs.eliteneobank.com/guide/error-handling/retry-logic.md)\
➡️ [Security Checks](https://docs.eliteneobank.com/guide/going-live/security-checks.md)\
➡️ [Production Checklist](https://docs.eliteneobank.com/guide/going-live/production-checklist.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.