Pular para o conteúdo principal

Banking API

A API Pública Conta Digital fornece acesso programático a operações bancárias, incluindo gerenciamento de contas, consultas de saldo, histórico de transações e transferências PIX.

URL Base

Todas as requisições da API devem ser feitas para:
https://conta-public-api.kiwify.com
Para desenvolvimento e testes, use o ambiente de desenvolvimento: https://conta-public-api-dev.kiwify.com

Versionamento da API

A API usa versionamento por caminho na URL. A versão atual é v1. Todos os endpoints versionados são prefixados com /v1/.

Formato de Erros

Todos os erros seguem um formato JSON consistente:
{
  "error": {
    "code": "error_code",
    "message": "Descrição do erro legível",
    "details": {}
  },
  "timestamp": "2024-01-15T10:30:00Z"
}

Códigos de Status HTTP Comuns

Status HTTPDescrição
200Sucesso
401Falha na autenticação - assinatura inválida, timestamp expirado ou access ID inválido
403Acesso negado - IP não está na lista de permitidos ou permissões insuficientes
404Recurso não encontrado
500Erro interno do servidor

Próximos Passos