Skip to main content
PUT
/
api
/
v1
/
providers
/
defaults
curl -X PUT 'https://app.plowf.com/api/v1/providers/defaults' \
  -H 'Authorization: Bearer seu_token_aqui' \
  -H 'Content-Type: application/json' \
  -d '{
    "payment_type": "PIX",
    "provider_uuids": [
      "9f1c0a30-3b8c-4a82-a4d7-2b8e93b1f001",
      "9f1c0a30-3b8c-4a82-a4d7-2b8e93b1f002"
    ]
  }'

{
  "message": "Provedores padrão atualizados com sucesso."
}
Atualiza a lista priorizada de provedores usados como padrão para um tipo de pagamento. A ordem do array define a prioridade: o primeiro UUID é o provedor preferencial; os seguintes são fallbacks acionados quando o anterior falha. A chamada substitui a configuração anterior para o payment_type informado — provedores ausentes do array são removidos da lista de defaults.
Este endpoint não é permitido para tokens vinculados a um provedor. Use um token sem escopo de provedor para alterar a configuração de defaults da conta.
curl -X PUT 'https://app.plowf.com/api/v1/providers/defaults' \
  -H 'Authorization: Bearer seu_token_aqui' \
  -H 'Content-Type: application/json' \
  -d '{
    "payment_type": "PIX",
    "provider_uuids": [
      "9f1c0a30-3b8c-4a82-a4d7-2b8e93b1f001",
      "9f1c0a30-3b8c-4a82-a4d7-2b8e93b1f002"
    ]
  }'

​
Body Parameters

​
payment_type
string
required
Tipo de pagamento para o qual a configuração se aplica. Valores aceitos: PIX.
​
provider_uuids
string[]
required
Lista ordenada de UUIDs dos provedores (1 a 10 itens, sem duplicatas). Use GET /providers para descobrir os UUIDs disponíveis na conta. Todos os UUIDs devem pertencer a provedores com status ACTIVE.

​
Validações

  • payment_type deve ser um dos valores válidos (PIX)
  • provider_uuids deve conter entre 1 e 10 UUIDs, todos válidos e sem repetição
  • Cada UUID deve pertencer à conta autenticada e referenciar um provedor com status = ACTIVE

​
Resposta de Sucesso

{
  "message": "Provedores padrão atualizados com sucesso."
}
​
message
string
Mensagem de confirmação da atualização

​
Erros Comuns