Endpoint: PUT /plans/plans/split/{id}/
Autenticação: Obrigatória — JWT via Authorization: Bearer <access_token>.
Substitui os campos persistidos de um plano de split existente. PATCH também é aceito para atualizações parciais. Ambos os métodos expõem name, zoop_tax_plan, split_details e split_details_online. O campo automatic_developer_fee não é editável por este endpoint. As alterações entram em vigor imediatamente para qualquer vendedor que referencie este plano de split, inclusive transações em andamento que ainda não tenham sido liquidadas.

Parâmetros de caminho

id
string (uuid)
required
Identificador único do plano de split.

Corpo da requisição

Para PUT, todos os campos são obrigatórios. Para PATCH, inclua apenas os que deseja alterar.
name
string
required
Nome de exibição.
zoop_tax_plan
string (uuid)
required
Identificador do plano de taxa subjacente. Alterar este campo reposiciona o plano de split sobre uma nova tabela de tarifas e raramente é a melhor opção — prefira criar um novo plano de split.
split_details
string
required
Tabela de split presencial, JSON serializado como string. Formato: { payment_type: { installments: { card_brand: { participant_label: percentual } } } }. A chave de bandeira Todas as bandeiras % funciona como fallback curinga; Programador representa a parcela do programador.
split_details_online
string
required
Tabela de split online (digitada manualmente), mesmo formato de split_details.

Resposta

200 OK com o registro atualizado (mesmo formato da criação):
{
  "id": "5f1e2a4b-3c5d-4f6a-9b7c-1e2d3f4a5b6c",
  "name": "Comercio - Master 100 (atualizado)",
  "zoop_tax_plan": "6a3a5b1e-7c2a-4b6f-9a3e-2c1d8e4f1b22",
  "split_details": "{'credit': {'1': {'Todas as bandeiras %': {'Master': 1.2, 'Programador': 0.1}}}}",
  "split_details_online": "{'credit': {'1': {'Todas as bandeiras %': {'Master': 1.7, 'Programador': 0.1}}}}"
}

Erros

StatusQuando
400Campo obrigatório ausente em PUT, ou zoop_tax_plan não corresponde a nenhum plano de taxa existente.
401Cabeçalho Authorization ausente ou inválido.
404Nenhum plano de split com o id informado.

Exemplos

curl -X PUT https://api.dlpay.cloud/plans/plans/split/5f1e2a4b-3c5d-4f6a-9b7c-1e2d3f4a5b6c/ \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJh..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Comercio - Master 100 (atualizado)",
    "zoop_tax_plan": "6a3a5b1e-7c2a-4b6f-9a3e-2c1d8e4f1b22",
    "split_details": "{\"credit\": {\"1\": {\"Todas as bandeiras %\": {\"Master\": 1.2, \"Programador\": 0.1}}}}",
    "split_details_online": "{\"credit\": {\"1\": {\"Todas as bandeiras %\": {\"Master\": 1.7, \"Programador\": 0.1}}}}"
  }'