NuvTools.Payment.Omie.ApiClient 10.0.8

NuvTools Payment Libraries

Payment abstraction library and API clients for Brazilian financial services. Part of the NuvTools Framework.

Projects

NuvTools.Payment.BancoDoBrasil.ApiClient

Typed HTTP client for the Banco do Brasil Payments API with OAuth2 authentication.

Features

• OAuth2 token generation (client_credentials)
• Batch bank slip payment creation
• Payment query by ID

Configuration

{
  "BancoDoBrasil": {
    "AuthUrl": "https://...",
    "BaseUrl": "https://...",
    "ClientId": "",
    "ClientSecret": "",
    "ApiKey": ""
  }
}

Registration

services.AddBancoDoBrasilApiClient(configuration);

NuvTools.Payment.Sicoob.ApiClient

Typed HTTP client for the Sicoob Banking API (bank slips).

Features

• Bank slip query by number or period
• Bank slip creation
• Second copy generation
• Cancellation, due date extension, and amount change

Configuration

{
  "Sicoob": {
    "BaseUrl": "https://...",
    "ClientId": "",
    "Token": ""
  }
}

Registration

services.AddSicoobApiClient(configuration);

NuvTools.Payment.Omie.ApiClient

Typed HTTP client for the Omie ERP API (service orders, accounts receivable, and bank slip issuance).

Features

• Client lookup
• Service registration query
• Service order (OS) creation
• Accounts receivable entry creation
• Bank slip (boleto) generation and retrieval

Configuration

{
  "Omie": {
    "AppKey": "",
    "AppSecret": "",
    "BaseUrlClient": "https://...",
    "BaseUrlService": "https://...",
    "BaseUrlOrderService": "https://...",
    "BaseUrlOrderBilling": "https://..."
  }
}

Registration

services.AddOmieApiClient(configuration);

Common Patterns

All API clients share the same infrastructure, provided by NuvTools.Payment:

• Result pattern: every method returns IResult<T> from NuvTools.Common.ResultWrapper (Succeeded, Data, Message, Messages, ResultType).
• Standard resilience: registered via services.AddPaymentResilientHttpClient<TInterface, TImpl>(name) — applies retry, circuit breaker, and timeout policy across all providers.
• Configuration binding from IConfiguration sections using the Options pattern.

Each provider exposes its own contract (ISicoobBankSlipApiClient, IBbBankSlipPaymentApiClient, IOmieApiClient) that returns provider-specific DTOs. There is no provider-neutral domain layer — Brazilian banking integrations are intrinsically provider-shaped, so the API stays direct.

Note (Omie): OmieApiClient is registered as a singleton and uses an internal static HttpClient. It intentionally bypasses HttpClientFactory and the standard resilience pipeline — Omie's gateway misbehaves with HTTP/2 and Polly retry. Do not change this without re-validating against the Omie sandbox.

Build

dotnet build NuvTools.Payment.slnx