Financeiro
Publicar o cliente como pagador no Asaas
Garante que o cliente exista como pagador no Asaas: vincula o que o CNPJ dele já tem lá ou cria um novo, e guarda o id. Repetir não cria outro. Sem CNPJ no cadastro, é recusado (422 no campo cnpj) antes de falar com o Asaas. A recusa do Asaas responde 502 com o código dele em details.provider_code.
Autorização
bearer billing:executeAutorizaçãoBearer <token>
Credencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.
Em: header
Escopo: billing:execute
Parâmetros de caminho
tenant_id*integer
Id do cliente
Formato
int64Parâmetros de cabeçalho
Idempotency-Key?|
Chave opcional de 1 a 255 caracteres ASCII visíveis; quando enviada, vale o mesmo contrato da §8.
Corpo da resposta
application/json
application/json
curl -X PUT "https://example.com/billing/profiles/0/payer" \ -H "Idempotency-Key: b3f0c1e2-4a5b-4c6d-8e9f-0a1b2c3d4e5f"{ "asaas_customer_id": "string", "created_from_global_at": "2019-08-24T14:15:22Z", "dealer_id": 0, "dealer_name": "string", "exception_fields": [ "string" ], "receptive_channels_qty": 0, "receptive_channels_since": "2019-08-24", "registration": { "billing_email": "string", "cnpj": "string", "complete": true, "contacts": { "financial": { "email": "string", "name": "string", "telegram": "string", "whatsapp": "string" }, "technical": { "email": "string", "name": "string", "telegram": "string", "whatsapp": "string" } } }, "repricing": null, "tenant_id": 0, "tenant_name": "string", "terms": { "currency": "string", "due_day": 0, "platform_monthly_cents": 0, "receptive_channel_unit_cents": 0, "text_additional_cents": 0, "text_ia_allowance_cents": 0, "text_principal_cents": 0, "voice_additional_cents": 0, "voice_ia_allowance_cents": 0, "voice_principal_cents": 0 }, "updated_at": "2019-08-24T14:15:22Z"}