STRYK, POS API
Liga a caixa ao STRYK
Consumos de restaurante e bar no quarto: configuração, contrato API e novas tentativas seguras.
A carregar …
1Configuração
Confirma com o fornecedor se a caixa suporta a API STRYK. Uma API própria ou OAuth exige um adaptador; gerar uma chave não comprova compatibilidade. Na configuração POS crie um ponto de venda com imposto válido e uma chave limitada a ele. GET /ping verifica a ligação; um lançamento controlado no quarto verifica a escrita.
2Chaves e segurança
A chave completa começa por pos_live_ e só está disponível na criação. O olho altera a visibilidade; Copiar usa sempre o valor completo. Depois fica apenas o identificador. Utiliza-a no servidor por HTTPS, nunca no navegador ou nos registos. Antes da troca reconcilie os recibos pendentes com a chave antiga: as referências pertencem-lhe. Não reenvie recibos antigos com uma chave nova; revoga depois a antiga.
3Conta do quarto e valores
Verifica hóspede e quarto por /accounts ou /room-lookup. Só estadias com entrada efetiva e sem saída podem ser debitadas. Respeite allowCharge, bloqueios, limita e conta de faturação fechada. Envia bookingId e room juntos. Preços brutos positivos na moeda do hotel, imposto válido na data do serviço. Quantidade com três casas decimais, dinheiro com duas; chargedAt com fuso horário. Sem lançamentos API após a saída.
4Lançamentos e novas tentativas
Cada linha precisa de externalRef permanente. Após timeout, primeiro GET /charges/{externalRef}; só com 404 repita o mesmo pedido com a mesma chave. Repetição exata: 201 e idempotentReplay=true; conteúdo alterado ou referência anulada: 409. Até 50 linhas atómicas. Com 429 espere pelo menos 60 segundos; limita de 100 pedidos por minuto e chave.
5Anulação e fatura
DELETE /charges/{externalRef} anula uma linha própria aberta sem duplicar o efeito. Linhas transferidas para fatura corrigem-se em Finanças. Lançar no quarto não é pagar; na saída as linhas abertas passam para a fatura. Reconcilia registos manuais durante falhas antes do envio API.
6Webhooks e validação
Webhooks opcionais: charge.posted e charge.cancelled. Configura um segredo separado e verifica HMAC-SHA256 sobre o corpo original. X-STRYK-Webhook-Id identifica a subscrição. Elimina duplicados por event e data.chargeId; não pressuponha a ordem. Testa lançamentos, repetições, bloqueios, limites, vários quartos, anulação, faturação e webhooks.
