# Xpress Wallet API

The Xpress Wallet API allows seamless integration of wallet functionalities into your products. Build smarter and faster applications with features for authentication, user management, merchant operations, and wallet transactions. This API operates in both sandbox and production modes, with endpoints designed to handle user authentication, customer management, and merchant wallet details.

#### How It Works

* **Authentication**: Obtain access and refresh tokens via the login endpoint.
* **User Management**: Manage user profiles and passwords.
* **Merchant Operations**: Handle merchant registration, profile updates, KYC, and access key generation.
* **Wallet Management**: Retrieve merchant wallet details and customer information.

#### Objectives

* Enable secure login and token management.
* Provide tools for managing merchant and customer data.
* Facilitate wallet-related transactions and profiles.

### Base URL

The base URL for API requests is defined as {{base-url}}. Replace this variable with the appropriate environment URL (e.g., <https://api.xpresswallet.com> for production or a sandbox URL).

{% hint style="info" %}
The Third party generic api requires api key.
{% endhint %}

[Request API Key](https://developer.providusbank.com/quick-start)

**Base Url:**
\
[https://api.xpresswallet.com](https://api.xpresswallet.com/)

Scripts

```javascript
if (pm.response.code === 200 || pm.response.code === 201 || pm.response.code === 400 || pm.response.code === 403) {

    const accessToken = pm.response.headers.get("X-Access-Token")
    const refreshToken = pm.response.headers.get("X-Refresh-Token")

    if (accessToken) {
        pm.environment.set("access-token", accessToken);
    }

    if (refreshToken) {
        pm.environment.set("refresh-token", refreshToken);
    }
}
```

***

### Base URL

All endpoints are relative to the base URL:

```
{{base-url}}
```

### Authentication

Most endpoints require authentication via `X-Access-Token` and `X-Refresh-Token` headers. Some endpoints also use a Bearer Token for authorization.

**Headers**:

```json
{
  "X-Access-Token": "{{access-token}}",
  "X-Refresh-Token": "{{refresh-token}}"
}
```

For endpoints requiring Bearer Token:

```json
{
  "Authorization": "Bearer {{vault:authorization-secret}}"
}
```


---

# 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://developer.providusbank.com/xpress-wallet-api.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.