Parceiros — API | Gateway Crédito Direto

GET/partnersAutenticado

Listar parceiros

MASTER vê a árvore inteira. Cliente ou fornecedor vê a própria conta e as subcontas. Subconta vê só a si. O UUID da conta de pagamentos aparece apenas para o MASTER.

https://gateway.credito-direto.com/api/partners

cURL

curl --request GET \
  --url 'https://gateway.credito-direto.com/api/partners' \
  --header 'accept: application/json' \
  --header 'authorization: Bearer TOKEN'

Exemplo de resposta

Response JSON

{
  "items": [
    {
      "id": "prt_01",
      "name": "Parceiro Demo",
      "slug": "parceiro-demo",
      "transfeeraAccountId": null,
      "active": true
    }
  ]
}

POST/partnersAutenticadoMaster

Criar parceiro

Cria cliente, fornecedor ou subconta abaixo de um pai, com operador inicial e módulos. Restrito ao MASTER. Profundidade máxima 2.

https://gateway.credito-direto.com/api/partners

cURL

curl --request POST \
  --url 'https://gateway.credito-direto.com/api/partners' \
  --header 'accept: application/json' \
  --header 'authorization: Bearer TOKEN' \
  --header 'content-type: application/json' \
  --data '{ "name": "Parceiro Sul", "slug": "parceiro-sul", "transfeeraAccountId": "account_id:806cafe8-f245-4aee-8785-2f385604454f" }'

Corpo da requisição

Campo	Tipo	Obrigatório	Descrição
name	string	Sim	Nome do parceiro.
slug	string	Sim	Identificador URL-safe: letras minúsculas, números e hífen (`^[a-z0-9-]+$`).
transfeeraAccountId	string	Sim	Id da conta digital já criada na Transfeera. Aceita o UUID, o scope account_id:{uuid} ou o JSON do login. O client_id e o client_secret continuam os da conta principal e não são gravados.

Exemplo de requisição

Body JSON

{
  "name": "Parceiro Sul",
  "slug": "parceiro-sul",
  "transfeeraAccountId": "account_id:806cafe8-f245-4aee-8785-2f385604454f"
}

Conflito de slug ou e-mail responde `409`.
Usuário que não é MASTER recebe `403`.
Cash-out (`payments`) e modo TV nascem desligados.
O vínculo consulta a conta na Transfeera antes de gravar. Conta já ligada em outro nó responde `409`.
`PATCH /partners/:id` ajusta módulos, pai, vínculo e status. `POST /partners/:id/users` cria outro operador.