Parceiros — API | Gateway Crédito Direto

GET/partnersAutenticado

Listar parceiros

MASTER vê todos os parceiros. PARTNER vê apenas o próprio, se vinculado.

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 um parceiro na plataforma. Restrito ao papel MASTER. Slug único.

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" }'

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	Não	Identificador da subconta de pagamentos, quando houver.

Exemplo de requisição

Body JSON

{
  "name": "Parceiro Sul",
  "slug": "parceiro-sul"
}

Conflito de slug responde `409`.
Usuário PARTNER recebe `403`.