Authentication

OAuth2 Client

class pypix_api.auth.oauth2.OAuth2Client(token_url, client_id=None, cert=None, pvk=None, cert_pfx=None, pwd_pfx=None, sandbox_mode=False)

Bases: object

Cliente OAuth2 para autenticação com a API

__init__(token_url, client_id=None, cert=None, pvk=None, cert_pfx=None, pwd_pfx=None, sandbox_mode=False)

Inicializa o cliente OAuth2

Parameters:

• token_url (str) – URL de autenticação OAuth2

• client_id (str | None) – Client ID para autenticação OAuth2

• cert (str | None) – Path para o certificado PEM (opcional)

• pvk (str | None) – Path para a chave privada PEM (opcional)

• cert_pfx (str | bytes | BinaryIO | None) – Path ou dados do certificado PFX (opcional)

• pwd_pfx (str | None) – Senha do certificado PFX (opcional)

• sandbox_mode (bool) – Se True, não requer certificado (default: False)

get_token(scope=None)

Obtém ou renova o token de acesso para o escopo especificado

Parameters:

scope (str | None) – Escopo(s) necessário(s) para a API. Exemplos: - Cobrança por Boleto: “boletos_inclusao boletos_consulta boletos_alteracao webhooks_alteracao webhooks_consulta webhooks_inclusao” - Conta Corrente: “cco_consulta cco_transferencias openid” - Recebimento no PIX: “cob.write cob.read cobv.write cobv.read lotecobv.write lotecobv.read pix.write pix.read webhook.read webhook.write payloadlocation.write payloadlocation.read”

Returns:

Token de acesso válido para o escopo solicitado

Return type:

str

mTLS Authentication

pypix_api.auth.mtls.get_session_with_mtls(cert=None, pvk=None, cert_pfx=None, pwd_pfx=None, sandbox_mode=False)

Return type:

Session