Configuration

To implement the Public Credit services, the partner must configure a URL to receive callback events.

In this step, the partner must configure:

1. A URL to receive callbacks;
2. This URL must have a homologation and a production environment;
3. The URL must be developed to receive GET or POST type requests;
4. An authentication method accepted by BMP.

After configuring the callback URL (homologation and production), choosing which HTTP method and which authentication method should be used, the partner must inform the BMP integration team so that this configuration can be parameterized in BMP.

See below for the technical details of each of these configurations.

1. URL

The partner must develop a callback URL and send it to BMP.

This URL will be used for communication between the partner and BMP, through callback events.

See the URL examples in the next step, below.

2. Environments

The callback for monitoring the status of proposals must be sent to both the approval environment and the production environment.

It is recommended that different URLs be used for each environment.

2.1 Examples of homologation URLs

www.example-of-homologation-url-com.br

2.2 Examples of production URLs

www.example-of-url-com.br

3. Call methods

The partner must choose an HTTP method that they would like to use to receive callbacks.

Available options include:

• POST
• GET

4. Authentication

The partner must also define an authentication method for receiving callbacks.

Available options include:

Authentication method	Key type	Token example
Bearer Token	Authorization	Bearer eyJhbGciOiJIUzI1CI6IkpXVCJ9
API Key	API-Key	1234567890abcdef1234567890abcdef
Basic Authentication	Authorization	Basic dXNlcm5hbWU6cGFzc3dvcmQ
X-API-Key	X-API-Key	0987654321fedcba0987654321fedcba
JWT (JSON Web Token)	Authorization	Bearer eyJhbGciOiJIUzI1NiIs
HMAC (Hash-based Message Authentication Code)	Authorization	HMAC 5d41402abc4b19d911017c592

All authentication methods accept keys up to 288 characters long.