NORYK GATEWAY — SEUS PRIMEIROS PASSOS

Este acesso conecta seu negócio ao painel e à API da Noryk Gateway.
Você pode consultar sua carteira, criar cobranças Pix e acompanhar vendas
e saques. O ambiente real recebe e envia Pix; cada operação precisa ser revisada.

1. CRIE SUA PRIMEIRA SENHA
O convite individual pode chegar por contato@noryk.finance ou ser compartilhado
pelo administrador para o seu e-mail de acesso.
Abra esse link, confira o e-mail mostrado e escolha uma senha entre 6 e 128
caracteres. Confirme a mesma senha no segundo campo. Não envie a senha de volta.
O convite vale 24 horas e é de uso único. Apenas abrir a página não ativa a conta.
Se o convite expirar antes de ativar a conta, peça outro ao administrador.
Se você já criou a senha, entre pelo painel normal.

2. ENTRE NO PAINEL
Abra https://gateway.noryk.finance/ e use seu e-mail e a senha que acabou de criar.
O acesso usa somente e-mail e senha. A sessão fica no navegador enquanto o acesso está aberto.

O painel mostra:
- Visão geral: posição da conta e cobranças recentes.
- Vendas: cobranças, Pix copia e cola e acompanhamento dos estados.
- Carteira: valores a liberar, disponíveis e reservados em saque.
- Integração: links e orientações da API.
- Credenciais: criação e revogação de suas chaves de integração.
- Segurança: senha, sessões e condições de movimentação da conta.

3. CONFIRA AS TARIFAS DA SUA CONTA
O administrador configura as condições de cada cliente. Os padrões iniciais
são 10% por recebimento e R$10 por saque, mas sua conta pode ter outra condição.
Confira o painel ou GET /v1/me antes de integrar. Cada operação preserva sua
própria tarifa; mudar a configuração não recalcula o histórico.

4. CRIE SUA CHAVE DE API
Em Credenciais, dê um nome à integração e mantenha somente as permissões de
que precisa. O padrão permite consulta (read) e criação de cobranças
(payments:write), com validade de 30 dias e máximo de 90 dias.
Confirme a emissão com sua senha atual. A chave completa aparece uma única vez. Guarde-a no ambiente
protegido do seu servidor. Não coloque em frontend, grupo, prompt ou repositório.
Se perder a chave completa, revogue-a e emita outra pelo painel.

A permissão de saque pela API não vem marcada por padrão e exige destinos
e limites aprovados. No painel, informe valor e chave Pix e confirme sua senha.
O máximo a receber é o saldo disponível menos a tarifa de saque.

5. CONECTE SEU SISTEMA OU PROGRAMADOR
Base da API: https://gateway.noryk.finance
Documentação: https://gateway.noryk.finance/docs
OpenAPI: https://gateway.noryk.finance/openapi-client.json
Orientações para agentes de IA: https://gateway.noryk.finance/llms.txt

Autentique as chamadas do backend com Authorization: Bearer SUA_CHAVE.
Uma chave da sua conta não consulta nem movimenta dados de outros clientes.
Os exemplos deste kit usam variáveis de ambiente; nenhum deles contém uma chave.

6. FAÇA A PRIMEIRA COBRANÇA PIX
Leia GET /v1/me e GET /v1/wallet. Para criar uma cobrança, use POST /v1/charges
com amountCents inteiro: 10000 significa R$100. Persista antes uma
Idempotency-Key única para o pedido. Guarde o id retornado e acompanhe
GET /v1/charges/{id}. No ambiente real, o copia e cola retornado é pagável.

Se a resposta não chegar, conserve o mesmo corpo e a mesma chave. Não crie
outra chave só para repetir. Um resultado incompleto permanece sem confirmação.
Não há reenvio automático nos exemplos. A coleção Postman contém apenas uma
criação manual de cobrança e consultas; não inclui envio de saques.

7. ACOMPANHE O ESTADO CORRETO
awaiting_payment: aguardando pagamento.
paid: recebido e ainda a liberar.
settled: liquidação confirmada; o líquido pode entrar no disponível.
requested/processing: saque em andamento.
verifying: desfecho em conferência; a reserva é mantida.
completed/failed: desfecho confirmado de saque.

Não trate paid como saldo disponível. Um timeout não comprova falha financeira.
As listas são paginadas: continue com nextCursor até que ele seja nulo.
O acompanhamento do cliente é por consulta; não há webhook de saída ao lojista.

SE PRECISAR DE AJUDA
Retorne ao canal em que recebeu o convite. Informe o que tentou fazer,
o horário aproximado, o código do erro e o requestId, quando existir.
Não envie senha, chave completa ou dados desnecessários
de pagadores. Para convite vencido, solicite outro ao administrador.


EXTRATO E PAGINAÇÃO
Cada linha de GET /v1/ledger tem id único, estável e opaco: use esse id para
persistir ou deduplicar lançamentos. journalId apenas agrupa linhas relacionadas
e pode repetir; não deduplique por ele. Continue com limit e nextCursor até
nextCursor ser null. Dados e saldos de demonstração não são transferidos para a base real.
