Postman Collection

Collection pronta para importar no Postman, Insomnia, ou qualquer client HTTP compativel.

Download

Baixar Postman Collection (JSON)

O que inclui

Categoria	Endpoints
PIX Cash-Out	Envio por chave, email, copia-e-cola, aprovar
PIX Cash-In	Gerar QR Code
Consultas	Por ID, E2E, tag, external_id, comprovante
Extrato	Statement com filtros e paginacao
Saldo	Balance da conta
Chaves PIX	Listar chaves
Devoluicao	Solicitar refund
Webhooks	Registrar, listar, remover
MED	Listar e detalhar
Validacao	CPF

Total: 22 endpoints

Configuracao

1. Importar no Postman

1. Abra o Postman
2. Clique em Import (canto superior esquerdo)
3. Arraste o arquivo JSON ou clique Upload Files
4. A collection "Owem Pay - API Externa" aparece no painel esquerdo

2. Configurar variaveis

Clique na collection > aba Variables e preencha:

Variavel	Valor	Descricao
base_url	https://api.owem.com.br/api/external	URL base da API (producao)
client_id	Seu cli_...	Client ID da API key
client_secret	Seu sk_...	Client Secret da API key

Para homologacao, use https://api-hml.owem.com.br/api/external.

3. HMAC automatico

A collection tem um pre-request script global que gera automaticamente o header hmac (HMAC-SHA512) para todas as requisicoes POST. Nao precisa calcular manualmente.

4. Variaveis automaticas

Os test scripts capturam automaticamente:

• last_transaction_id — do response de cash-out
• last_e2e_id — do response de cash-out
• last_qr_tx_id — do response de cash-in

Essas variaveis sao reutilizadas nas consultas subsequentes.

Valores monetarios

Atencao

Request: valores em centavos (R$ 1,00 = 100)

Response: valores em subcentavos (R$ 1,00 = 10000)

Para converter response para Reais: divida por 10.000.

Workflow sugerido

1. Saldo — GET /balance para verificar saldo disponivel
2. Cash-In — POST /pix/cash-in para gerar QR Code
3. Cash-Out — POST /pix/cash-out para enviar PIX
4. Consulta — GET /transactions/:id para acompanhar status
5. Comprovante — GET /transactions/:id/receipt para transacoes concluidas

Importar no Insomnia

1. Abra o Insomnia
2. Application > Preferences > Data > Import Data
3. Selecione From File e escolha o JSON
4. Configure as variaveis de ambiente com os mesmos valores acima