DOM360
Financeiro

Liberar provisoriamente um cliente

POST
/billing/charges/{charge_id}/provisional-releases

Dá um prazo, pela política da plataforma, contra esta cobrança: o cliente volta a operar agora, a menos que outra cobrança mantenha o bloqueio. Motivo obrigatório. Uma segunda liberação aberta na mesma cobrança é 409.

Autorização

bearer billing:execute
Autorizaçã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

charge_id*string

Id da cobrança

Parâ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 requisição

application/json

Definições TypeScript

Use o tipo request body no TypeScript.

O corpo de POST /billing/charges/{charge_id}/provisional-releases.

Corpo da resposta

application/json

application/json

curl -X POST "https://example.com/billing/charges/string/provisional-releases" \  -H "Idempotency-Key: b3f0c1e2-4a5b-4c6d-8e9f-0a1b2c3d4e5f" \  -H "Content-Type: application/json" \  -d '{    "reason": "string"  }'
{  "charge_id": "cf8b747b-a752-4d0a-9a4d-7d19fc1769f3",  "closed_at": "2019-08-24T14:15:22Z",  "closed_by_email": "string",  "closed_reason": null,  "created_at": "2019-08-24T14:15:22Z",  "expires_at": "2019-08-24T14:15:22Z",  "granted_by_email": "string",  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "reason": "string"}