Conectar
Abra wss://app.vibecash.com.br/v1/websocket no ambiente publicado ou ws://127.0.0.1:4175/v1/websocket no ambiente local. Passe a chave da conta no header X-API-Key com a permissão websocket/connect. A chave fica no seu servidor.
Exemplo em Node.js
import WebSocket from 'ws';
const socket = new WebSocket('wss://app.vibecash.com.br/v1/websocket', {
headers: { 'X-API-Key': process.env.VIBECASH_API_KEY }
});
socket.on('message', raw => {
const event = JSON.parse(raw.toString());
if (event.type === 'ready') return;
console.log(event.event, event.id);
socket.send(JSON.stringify({ type: 'ack', id: event.id }));
});
socket.on('error', error => console.error(error.message));Eventos e reconexão
Após ready, a conexão recebe novos eventos PIX da sua conta. O ACK é opcional. Use Integrações → WebSocket → Testar evento para emitir webhook.test. Após reconectar, consulte os pagamentos e saques pendentes pela API para recuperar eventos que aconteceram durante a desconexão.