Cadastra um novo parceiro

Produção

https://gtw.unnotech.com.br/public

POST

/api/v1/partners

Cria um parceiro com dados pessoais/empresariais, conta bancária e endereço.

O bank_account.bank_id é o código compe (3 dígitos) do banco e é resolvido
via catalogue. A hierarquia (parent) é derivada do access_token.

Atenção: o campo is_retailer atualmente é sobrescrito pelo backend.

Requisição

Authorization

JWT Bearer

Adicionar o parâmetro

Authorization

a Cabeçalhos

Exemplo:

Authorization: ********************

Parâmetros Header

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200

application/json

Parceiro criado com sucesso.

Body

🟠400

🟠401

🟠403

🟠422

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://gtw.unnotech.com.br/public/api/v1/partners' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "partner": {
        "type": "pf",
        "name": "Fulano de Tal",
        "email": "fulano@detal.com.br",
        "phone": "11987654321",
        "document_number": "12345678901",
        "is_retailer": true,
        "parent_uuid": "a52a555d-68f8-4560-b544-8ebc76a447ac"
    },
    "address": {
        "zipcode": "01310100",
        "uf": "SP",
        "city": "São Paulo",
        "district": "Centro",
        "neighborhood": "Bela Vista",
        "street": "Avenida Paulista",
        "number": "1000",
        "complement": "Sala 202"
    },
    "bank_account": {
        "type": "CPP",
        "agency": "1234",
        "bank_id": "001",
        "bank_name": "Banco do Brasil",
        "agency_digit": "1",
        "account_number": "567890123",
        "account_digit": "5",
        "pix_key": "fulano@detal.com.br",
        "pix_type": "EMAIL"
    }
}'

Response Example

200 - Sucesso

{
    "data": {
        "id": "3ea1d784-4c6f-4dd0-bfa3-5e027c172fd1"
    },
    "message": "Parceiro cadastrado com sucesso!"
}

Modificado em 2026-05-09 02:17:11

Página anterior

Lista parceiros com filtros e paginação

Próxima página

Detalha um parceiro pelo UUID