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

# Setup

> Learn how to set up your provider credentials for Processing Only mode.

## Configuration in HUB2 dashboard

To use Processing Only mode, you must first ensure that you are using an API key with the necessary permissions. To do this, you can configure your API keys via our dashboard. Once this is done, you can move on to the step of configuring provider credentials.

<Steps>
  <Step title="API Key Configuration">
    Before configuring provider credentials, ensure your API key has the necessary permissions for Processing Only mode:

    <Tabs>
      <Tab title="Create New API Key">
        Generate a new API key with Processing Only permissions

        * Go to **Management** → **Developers**
        * Click **Create a key**
        * Select the following permissions during creation:
          * `Api.delegated_payment_create` - For creating delegated payments
          * `Api.delegated_transfer_create` - For creating delegated transfers
      </Tab>

      <Tab title="Update Existing API Key">
        If using an existing API key, update its permissions

        * Go to **Management** → **Developers**
        * Find your existing API key
        * Click **Edit** and add the following permissions:
          * `Api.delegated_payment_create` - For creating delegated payments
          * `Api.delegated_transfer_create` - For creating delegated transfers
      </Tab>
    </Tabs>

    <Card title="API keys" icon="link" href="/integration/en/getting_started/api_keys" arrow="true" cta="Go to the API Keys configuration guide" />

    <Warning>API keys without these permissions won't be able to access endpoints `/delegated/`.</Warning>
  </Step>

  <Step title="Add Provider Credentials">
    These are the information (API key, username, parameters...) giving you access to the provider's API.

    1. Log in to your HUB2 dashboard
    2. Navigate to **Management** → **Connectors credentials** (in sidebar menu)
    3. Click on **Register new credentials**
    4. In the modal, select the transaction type and select the provider in the dropdown list
    5. **Enter Credentials**: Provide your provider account credentials

    <Note>
      A credentials validation action is systematically performed before registration to confirm that the credentials are correct. This may include:

      * Call to the authentication token generation endpoint
      * Call to a GET /balance endpoint

      If validation fails, an error message will be displayed, prompting you to recheck your input.
    </Note>
  </Step>
</Steps>

## Supported Providers

The list of supported providers becomes available when the dropdown in the modal is expanded.
Below is the list of currently supported Providers.

| Providers | Available Services   |
| --------- | -------------------- |
| Orange CI | Payment and Transfer |
| MTN CI    | Payment and Transfer |
| Orange SN | Payment and Transfer |

<Note>This list will be updated as services are added.</Note>

## Best Practices

* **Regular Updates**: Update your credentials when they expire
* **Monitoring**: Regularly monitor your provider account activity
* **Backup Credentials**: Keep backup credentials in case of emergencies

## Getting Help

If you encounter issues during setup, contact our support team with your specific error messages