Skip to main content

Authorization

Follow this guide to create a new Chargeback credential that will allow Nexla to authenticate to and exchange data with your Chargeback account.
chargeback_api_auth.png

Chargeback

Prerequisites​

Before creating a Chargeback credential, you need to obtain authentication credentials from your Chargeback account. Chargeback uses Basic Authentication with a Public Key (username) and Secret Key (password) combination to authenticate API requests.

To use Chargeback with Nexla, you need:

  • Access to your Chargeback account
  • A Chargeback account with appropriate permissions to access the resources you want to work with
  • Your Public Key and Secret Key for Basic Authentication
  • The base URL for your Chargeback environment

The Chargeback API supports different environments, and you need to specify the appropriate base URL for your environment. Common base URLs include production and sandbox environments. For detailed information about Chargeback authentication, credential setup, and available environments, refer to the Chargeback API documentation.

Create a Chargeback Credential​

  • To create a new Chargeback credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

New Credential Overlay – Chargeback

ChargebackCred.png

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

Basic Authentication Configuration​

  1. Enter your Chargeback Public Key or username in the Public Key field. This is the Public Key or username associated with your Chargeback account that will be used for Basic Authentication.

  2. Enter your Chargeback Secret Key or password in the Secret Key field. This is the Secret Key or password associated with your Chargeback account that will be used together with the Public Key for Basic Authentication.

  3. Enter the base URL for your Chargeback environment in the Environment Base URL field. This should be the complete base URL of your Chargeback API environment, including the protocol (https://) but without any trailing slashes. To access the Chargeback API in different environments, change the base URL in your requests.

    Keep your authentication credentials secure and do not share them publicly. The credentials provide access to your Chargeback account and should be treated as sensitive information. Basic Authentication credentials are sent in the Authorization header for all API requests to the Chargeback API. The base URL determines which Chargeback environment your credential will access (e.g., production, sandbox, or other environments).

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.