Plugin WordPress para integração entre a API PayTour v2 e o Togo Framework, permitindo sincronização automática de viagens e sistema de reservas com autenticação via app_key e app_secret.
- ✅ Autenticação atualizada: Implementação do novo método de autenticação PayTour v2
- ✅ App Key/Secret: Suporte completo a credenciais de aplicativo
- ✅ Token Management: Gerenciamento automático de
access_tokenerefresh_token - ✅ API v2: Migração completa para a nova API PayTour v2
- ✅ Logs melhorados: Sistema de logs mais detalhado para debug
- Características
- Requisitos
- Instalação
- Configuração
- Autenticação PayTour
- Uso
- Shortcodes
- API
- Troubleshooting
- Changelog
- ✅ Sincronização automática de viagens da PayTour API v2
- ✅ Sistema de verificação de disponibilidade em tempo real
- ✅ Processamento de reservas integrado
- ✅ Sincronização bidirecional de status
- ✅ Cache inteligente para performance
- ✅ Gerenciamento automático de tokens de acesso
- ✅ Suporte a credenciais de aplicativo (app_key/app_secret)
- ✅ Codificação Base64 automática
- ✅ Renovação automática de tokens
- ✅ Fallback para nova autenticação quando necessário
- ✅ Logs detalhados de autenticação
- ✅ Totalmente integrado com Togo Framework
- ✅ Utiliza Custom Post Types
togo_tripetogo_booking - ✅ Compatível com Elementor
- ✅ Responsivo e mobile-friendly
- ✅ Suporte a múltiplos idiomas
- WordPress 5.0 ou superior
- PHP 7.4 ou superior
- MySQL 5.6 ou superior
- Togo Framework (versão 1.0.0+)
- Togo Theme (ativo)
- Credenciais de aplicativo (app_key e app_secret)
- Acesso aos endpoints da API v2
- Faça download do plugin
- Acesse Plugins > Adicionar Novo > Enviar Plugin
- Selecione o arquivo ZIP do plugin
- Clique em Instalar Agora
- Ative o plugin
# Na VPS
cd /www/wwwroot/ilhabela.bidooh.com.br/wp-content/plugins/
unzip tripz-paytour-plugin-v2.zip
chown -R www:www tripz-paytour-plugin-v2/
chmod -R 755 tripz-paytour-plugin-v2/Após a ativação, verifique se:
- O menu Configurações > Tripz PayTour está disponível
- Não há mensagens de erro no painel
- O Togo Framework está ativo
Acesse Configurações > Tripz PayTour e configure:
Sua chave de aplicativo PayTour (app_key)
Obtida no painel administrativo da PayTour
Sua chave secreta de aplicativo PayTour (app_secret)
Mantenha em segurança - nunca compartilhe
https://api.paytour.com.br/v2
(normalmente não precisa ser alterada)
- A cada hora
- Duas vezes por dia
- Diariamente (recomendado)
- Semanalmente
- Clique em Testar Conexão
- Verifique se o status mostra "Conexão estabelecida com sucesso"
- Se houver erro, verifique suas credenciais
- Clique em Sincronizar Trips
- Aguarde a conclusão do processo
- Verifique as estatísticas atualizadas
O plugin implementa o fluxo de autenticação oficial da PayTour v2:
- Concatenação:
app_key:app_secret - Codificação: Base64 da string concatenada
- Login:
POST /lojas/login?grant_type=application - Header:
Authorization: Basic [base64_string] - Resposta:
access_tokenerefresh_token - Uso:
Authorization: Bearer [access_token]
- O plugin monitora a expiração do token
- Renova automaticamente usando
refresh_token - Faz novo login se a renovação falhar
- Logs detalhados para debug
- Acesse o painel administrativo da PayTour
- Vá para a seção "Desenvolvedor" ou "Integrações"
- Gere ou visualize suas credenciais de aplicativo
- Copie o app_key e app_secret
- Configurada no intervalo escolhido
- Executa via WP-Cron
- Atualiza trips existentes
- Cria novos trips automaticamente
- Botão Sincronizar Trips no painel
- Útil para atualizações imediatas
- Mostra progresso em tempo real
Use o shortcode em qualquer página ou post:
[tripz_trip_availability id="123"]<?php
$paytour_id = get_post_meta(get_the_ID(), 'paytour_id', true);
if ($paytour_id) {
echo do_shortcode('[tripz_trip_availability id="' . get_the_ID() . '"]');
}
?>Exibe formulário de verificação de disponibilidade.
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
id |
int | 0 | ID do post togo_trip |
show_price |
bool | true | Exibir preço |
show_duration |
bool | true | Exibir duração |
button_text |
string | "Verificar Disponibilidade" | Texto do botão |
// Básico
[tripz_trip_availability id="123"]
// Customizado
[tripz_trip_availability id="123" show_price="false" button_text="Consultar Datas"]
// Sem duração
[tripz_trip_availability id="123" show_duration="false"]POST /lojas/login?grant_type=application
POST /lojas/login?grant_type=refresh_token
GET /trips
GET /trips/availability
POST /bookings
PUT /bookings/{id}/status
TripzPayTour.checkAvailability(123, {
checkin: '2024-01-15',
checkout: '2024-01-20',
adults: 2,
children: 0
}).done(function(response) {
console.log('Disponibilidade:', response);
});Possíveis causas:
- App Key ou App Secret incorretos
- Credenciais não configuradas no painel PayTour
- Problema na codificação Base64
Soluções:
- Verifique se as credenciais estão corretas
- Teste manualmente:
echo -n "app_key:app_secret" | base64
curl -X POST "https://api.paytour.com.br/v2/lojas/login?grant_type=application" \
-H "Authorization: Basic [base64_result]"Soluções:
- O plugin deve renovar automaticamente
- Se persistir, limpe os tokens salvos:
- Vá para Configurações > Tripz PayTour
- Salve as configurações novamente
- Verifique logs para detalhes
Soluções:
- Verifique se a autenticação está funcionando
- Consulte logs em Configurações > Tripz PayTour
- Teste a conexão manualmente
// wp-config.php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);Adicione ?debug=1 à URL da página de configurações para acessar:
- Limpar cache
- Exportar logs
- Reset do plugin
| Opção | Descrição |
|---|---|
tripz_paytour_access_token |
Token de acesso atual |
tripz_paytour_refresh_token |
Token para renovação |
tripz_paytour_token_expires_at |
Timestamp de expiração |
| Campo | Tipo | Descrição |
|---|---|---|
paytour_id |
string | ID único na PayTour |
trip_price |
float | Preço base do trip |
trip_duration |
string | Duração do trip |
trip_location |
string | Localização principal |
paytour_data |
json | Dados completos da PayTour |
- ✅ BREAKING: Migração para PayTour API v2
- ✅ BREAKING: Novo método de autenticação (app_key/app_secret)
- ✅ Gerenciamento automático de tokens
- ✅ Renovação automática de access_token
- ✅ Logs melhorados para debug
- ✅ Interface administrativa atualizada
- ✅ Documentação completa do novo fluxo
- ✅ Integração completa com Togo Framework
- ✅ Remoção da dependência do WooCommerce
- ✅ Novos hooks para reservas
- ✅ Interface administrativa melhorada
- ✅ Sistema de cache otimizado
- ✅ Adicionado suporte a múltiplas opções de trip
- ✅ Melhorias na interface do usuário
- ✅ Correções de bugs na sincronização
- ✅ Versão inicial
- ✅ Integração básica com PayTour
- ✅ Sistema de sincronização
- ✅ Verificação de disponibilidade
Se você está atualizando da versão anterior:
- Backup: Faça backup do site antes da atualização
- Credenciais: Obtenha app_key e app_secret no painel PayTour
- Configuração: Reconfigure as credenciais na nova interface
- Teste: Execute teste de conexão após a configuração
- Sincronização: Execute sincronização manual para verificar
Este plugin é licenciado sob GPL v2 ou posterior.
Desenvolvido por Maremar Turismo para integração com a plataforma PayTour v2.
Maremar Turismo - Especialistas em Ilhabela
- Website: https://maremar.tur.br
- Email: contato@maremar.tur.br
- PayTour API: https://api.paytour.com.br/v2/docs