# API Basics

The API gives you access to all payment features that you can use on our dashboard and lets you extend them for use in your application. The API allows you initiate payment, make payment, and manage payout transactions between yourself and another party. Here's is what you need to do:

* Create an account: Start your experience by creating a free [Vesicash account](https://merchant.vesicash.com/). By default, you would have access to your test environment after you sign up. The test keys can be generated from the developer's tab of the settings page.

<figure><img src="/files/5npp1BWETdx907vahdxL" alt=""><figcaption></figcaption></figure>

* Configure your integration: Utilize our API integration to configure your payment system.
* Complete your KYC: To take your account live, We'll need to review your details and profile it correctly for the best experience. You are required to submit your business documents and other relevant information to make this review possible.
* Go live and accept payments from your customers: Once your account has been approved, you can start collecting payments from your customers

When you've fully tested and are ready to go live, you can proceed to create a [live business account](https://merchant.vesicash.com/) and of course, login to generate[ live API Keys](https://merchant.vesicash.com/) to replace the test keys.&#x20;

### Making a Request

Next to each endpoint is the expected method to access that endpoint. All you need to do is pass in the specific parameters as will be shown in this documentation, and you can make calls to the endpoints.

### Input/Output Format

Both request body data and response data are formatted as JSON. Content type for responses will always be `application/json`.

Generally, all responses will be in the following format:

{% hint style="info" %}

#### Standard API response format

{\
&#x20;"status": \[string] - indicating whether or not the request could be processed,\
"code" : \[integer] - indicating the request code,\
&#x20;"message": \[string] - contains the result of the action that was processed,\
"data": \[object] - contains the payload of the action that was processed\
}
{% endhint %}

### Base URL

All API requests must be made over HTTPS to the following base URL, and unencrypted HTTP connections are not supported.&#x20;

When calling any API, the environment keys used, would determine if the request is on a test environment of live environment.&#x20;

**NOTE:** All request must be made with a valid Vesicash public and Private keys.

| Environment | URL                            |
| ----------- | ------------------------------ |
| Production  | <https://api.mor.vesicash.com> |


---

# 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://docs.vesicash.com/api-documentation/api-basics.md?ask=<question>
```

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.