---
title: How to Create an API Key
description: "To create an API key, please follow the steps below: Log in to your Hello Clever account at https://merchant.helloclever.co Click on the Link site button on the top header and choose Hello Clever APIs"
---

[Skip to content](https://support.helloclever.co/merchant-knowledge-base/how-to-create-an-api-key#main-content)

[Contact Merchant Support](https://support.helloclever.co/merchant-knowledge-base/kb-tickets/new?hsLang=en)

![Logotype black@2x](https://support.helloclever.co/hs-fs/hubfs/Hello%20Clever%20Logo%20Assets/Logotype%20black@2x.png?width=200&height=61&name=Logotype%20black@2x.png)

- [Merchant Support](https://support.helloclever.co/merchant-knowledge-base)
- [Go to Consumer Support](https://support.helloclever.co/consumer-knowledge-base/faqs)
- [Contact Merchant Support](https://support.helloclever.co/merchant-knowledge-base/kb-tickets/new)

Open main navigation

Close main navigation

- [Merchant Support](https://support.helloclever.co/merchant-knowledge-base)
- [Go to Consumer Support](https://support.helloclever.co/consumer-knowledge-base/faqs)
- [Contact Merchant Support](https://support.helloclever.co/merchant-knowledge-base/kb-tickets/new)
- [Contact Merchant Support](https://support.helloclever.co/merchant-knowledge-base/kb-tickets/new)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Merchant Support](https://support.helloclever.co/merchant-knowledge-base?hsLang=en)
2. [Integrations & Developer Resources](https://support.helloclever.co/merchant-knowledge-base/integrations-developer-resources?hsLang=en)

# How to Create an API Key

The Hello Clever API provides seamless payment solutions for your applications, allowing you to create payment links, manage payins and payouts, and handle transactions efficiently. Whether you're integrating to offer one-time payments or recurring services, our API is designed to make it easy and secure for developers to connect with our platform.

### Getting Started

To begin using the Hello Clever API, you'll need an `app-id` and `secret-key`. These credentials are essential for authenticating your API requests and can be generated from our Merchant Portal.

- Production Portal: [https://api-merchant.helloclever.co](https://api-merchant.helloclever.co/)
- Sandbox Portal: [https://api.cleverhub.co](https://api.cleverhub.co/)

Make sure to use the appropriate credentials depending on whether you're developing and testing in the sandbox or deploying in production.

### API Endpoints

Hello Clever provides two sets of API endpoints:

- **Production API Endpoint**: `https://api-merchant.helloclever.co`
- **Sandbox API Endpoint**: `https://api.cleverhub.co`

Please use the sandbox endpoint for testing and integration purposes, and switch to the production endpoint when you're ready to go live.

### Authentication

To authenticate with the Hello Clever API, include your **`app-id`** and **`secret-key`** in the request headers for all API calls. These credentials are essential for ensuring secure access to our services. Each request you make to the Hello Clever API must be authenticated to protect both you and your customers.

**Authentication Headers**

| Header | Description |
| --- | --- |
| `app-id` | The unique application identifier issued when you register your application. It is used to identify your app to the Hello Clever platform. |
| `secret-key` | The secret key associated with your application. It should be kept private and never exposed in client-side code. It is used to verify the identity of your app and provide secure access to the API. |

#### Security Considerations

- **Keep Your Credentials Secure**: Ensure that your `secret-key` is kept confidential. Never expose it in client-side code or any publicly accessible areas.
- **Rotate Credentials Periodically**: We recommend rotating your `secret-key` periodically to enhance security.
- **Use HTTPS**: Always use HTTPS to ensure encrypted communication between your server and Hello Clever's API.

#### Special Case: Create Payment Gateway Link

For the [`/v1/payment_gateways/create_payment`](https://docs.helloclever.co/api-v1-reference/create-payment-gateway-link) endpoint, which is used to create a payment gateway link, a JWT token is required instead of the `app-id` and `secret-key`. This endpoint is intended for a client-to-server call, and the JWT token should be generated by our servers. More details can be found in the specific API reference.

The JWT token ensures that the payment process remains secure and allows for dynamic interactions directly between the client and our backend systems.

- [Getting Started](https://support.helloclever.co/merchant-knowledge-base/getting-started?hsLang=en)
- [Integrations & Developer Resources](https://support.helloclever.co/merchant-knowledge-base/integrations-developer-resources?hsLang=en)
- [Merchant Dashboard](https://support.helloclever.co/merchant-knowledge-base/merchant-dashboard?hsLang=en#main-content)

    - [General](https://support.helloclever.co/merchant-knowledge-base/merchant-dashboard?hsLang=en#general)
    - [Data & Analytics](https://support.helloclever.co/merchant-knowledge-base/merchant-dashboard?hsLang=en#data-analytics)
    - [Refunds & Disputes](https://support.helloclever.co/merchant-knowledge-base/merchant-dashboard?hsLang=en#refunds-disputes)
    - [Payment Links](https://support.helloclever.co/merchant-knowledge-base/merchant-dashboard?hsLang=en#payment-links)
- [Loyalty & Campaigns](https://support.helloclever.co/merchant-knowledge-base/loyalty-campaigns?hsLang=en#main-content)

    - [Instant Cashback Campaigns](https://support.helloclever.co/merchant-knowledge-base/loyalty-campaigns?hsLang=en#instant-cashback-campaigns)
    - [Milestone Campaigns](https://support.helloclever.co/merchant-knowledge-base/loyalty-campaigns?hsLang=en#milestone-campaigns)
- [Clever AI](https://support.helloclever.co/merchant-knowledge-base/clever-ai?hsLang=en)
- [Marketing & Resources](https://support.helloclever.co/merchant-knowledge-base/marketing-resources?hsLang=en)
- [Settlements](https://support.helloclever.co/merchant-knowledge-base/settlements?hsLang=en)
- [Hello Clever Bookings](https://support.helloclever.co/merchant-knowledge-base/hello-clever-bookings?hsLang=en#main-content)

    - [Dashboard](https://support.helloclever.co/merchant-knowledge-base/hello-clever-bookings?hsLang=en#dashboard)
    - [Business Profile](https://support.helloclever.co/merchant-knowledge-base/hello-clever-bookings?hsLang=en#business-profile)
    - [Customer](https://support.helloclever.co/merchant-knowledge-base/hello-clever-bookings?hsLang=en#customer)
- [FAQs](https://support.helloclever.co/merchant-knowledge-base/faqs?hsLang=en#main-content)

    - [General Info](https://support.helloclever.co/merchant-knowledge-base/faqs?hsLang=en#general-info)
    - [Payments](https://support.helloclever.co/merchant-knowledge-base/faqs?hsLang=en#payments)

- [Merchant Support](https://support.helloclever.co/merchant-knowledge-base)
- [Go to Consumer Support](https://support.helloclever.co/consumer-knowledge-base/faqs)
- [Contact Merchant Support](https://support.helloclever.co/merchant-knowledge-base/kb-tickets/new)

[![Logotype black@2x](https://support.helloclever.co/hs-fs/hubfs/Hello%20Clever%20Logo%20Assets/Logotype%20black@2x.png?width=200&height=61&name=Logotype%20black@2x.png "Logotype black@2x")](https://helloclever.co/)

<https://www.facebook.com/helloclever.co> <https://x.com/hello_clever> <https://www.instagram.com/helloclever.co/> <https://www.linkedin.com/company/helloclever> <https://www.tiktok.com/@helloclever.co> <https://www.youtube.com/@hello_clever>