Aller au contenu

Alya Dev Trip

Alya Hotel System — Documentation

Plugin WordPress pour agences · Version 1.1.16-dev · alyatrip.com

Documentation pour agences

Les 4 documentations Catalogue Manuel agence Ouvrir la présentation

Pour les agences

Alya Dev Trip

Alya Hotel System

Plugin WordPress à intégrer : hôtels et vols via LiteAPI

Documentation pour les agences qui intègrent Alya Hotel System. Ce n’est pas un guide pour le voyageur qui réserve, ni un PMS hôtelier.

37captures réelles
10%marge testée (live)

Les 4 documentations

Quatre livrables pour les agences qui intègrent le plugin. Pas un site d’aide voyageur.

1 · Commercial

Présentation 38 slides et portail d’intégration.

Agence qui intègre / décideur.

Ouvrir

2 · Catalogue

Fonctionnalités du plugin pour une agence. Interface FR / EN / AR.

Agence avant / pendant l’intégration.

Ouvrir

3 · Technique

Dossier IT de l’agence. Accès staff.

IT / administrateur WordPress de l’agence.

Connexion staff

4 · Manuel agence

Intégrer, configurer et opérer le cockpit. Le parcours public décrit ce que voient vos clients.

Agency Admin, Agency Staff, Administrator.

Ouvrir

Alya Dev Trip Connector

Documentation du connecteur. Tableau de bord du compte connecteur — distinct du cockpit Alya. Thème cible : Hoteldz Tech.

Ouvrir Alya Dev Trip Connector

Aperçu

Identité produit, architecture et faits vérifiés.

Identité

  • Produit Alya Hotel System
  • Société Alya Dev Trip
  • Version 1.1.16-dev
  • Site https://alyatrip.com
  • Fournisseur Alya Dev Trip Connector
  • REST alya/v1 — le navigateur n’envoie jamais la clé privée
  • Thème Traveler 3.2.9 (live) · Hoteldz Tech (cible)

Architecture

  1. Hoteldz Tech (cible) · chrome live Traveler 3.2.9
  2. WordPress REST alya/v1
  3. Alya Hotel System
  4. Alya Dev Trip Connector · LiteAPI
  5. Stripe Payment SDK → TRANSACTION_ID → book

Les tables MySQL locales sont des miroirs. La source fournisseur est LiteAPI bookingId.

Homepage hero

Produit

Les cartes mènent à la section correspondante.

Hôtels Vols Parcours public Agence Back office Paiements Commission Connecteur Rapports Sécurité

Ce n’est pas un PMS. Les rôles sont Administrator, Agency Admin et Agency Staff.

Bénéfices (preuves existantes)

  • Recherche et réservation d’hôtels via WordPress
  • Parcours vols : recherche, offres, extras, paiement Stripe
  • Cockpit agence (tableau de bord, CRM, rapports)
  • Marge / commission injectée côté serveur
  • Paiement voyageur via Payment SDK (pas WooCommerce)
  • Connecteur : Alya Dev Trip Connector (LiteAPI)

Architecture cible

Thème et connecteur actuels versus cibles. Les cibles restent PLANNED / FUTURE.

Actuel (vérifié)

  • Thème actuel : Traveler 3.2.9
  • Hop technique actuel : LiteAPI
  • Alya Hotel System · REST alya/v1

Cible

Planifié / futur
  • Thème cible : Hoteldz Tech
  • Nom commercial : Alya Dev Trip Connector
  • Alya Hotel System (same product)

Les cibles sont une présentation documentation. Elles ne remplacent pas l’implémentation live.

Hôtels

Parcours hôtel : recherche, fiche, chambre, checkout, paiement.

Résultats

Ce que fait l’utilisateur Sees hotel cards, Favori, Comparer, map toggle. Live: Paris 20–22 Sep 2026, ~30 hotels.

Hotel search results
Fiche hôtel

Ce que fait l’utilisateur Opens B&B HOTEL Paris 17 Batignolles on /hotel-contract-system/?hotel_id=lp1ea94.

Hotel details + rates
Tarifs

Ce que fait l’utilisateur Compares rate plans, cancellation, price. Live: 6 offers, Réserver.

Available rooms / rate plans
Checkout

Ce que fait l’utilisateur Fills holder + guest on /checkout-hotel/. Not WooCommerce checkout.

Checkout guest form
Prebook

Ce que fait l’utilisateur Locks the rate. Live: 213.67 EUR, twin, non-refundable, 20–22 Sep 2026.

Prebook + payment widget
Paiement

Ce que fait l’utilisateur Sees Stripe Payment SDK: Pay / Google Pay READY.

Payment interface

Vols

Parcours vols : recherche, offres, passagers, extras, paiement.

Offres

Ce que fait l’utilisateur Sees fare offers after a valid search. Live: ALG–CDG 13–20 Sep 2026, 59+ offers, 107–2475 EUR.

Flight offers ALG–CDG
Vérification

Ce que fait l’utilisateur Fills contact + adult passenger (title M./Mme, passport).

Passengers
Extras / bagages

Ce que fait l’utilisateur Attaches extras before book. Live: checked bag 23/32 kg, cabin 10 kg, seat map.

Extras
Paiement

Ce que fait l’utilisateur Stripe Payment SDK. Live: 153.94 EUR, Payer et réserver READY.

Flight payment UI

Parcours public

Parcours public que l’agence expose. Ce n’est pas un mode d’emploi pour le client final.

Ce que l’agence expose (parcours public)

  • Hôtels : recherche → tarifs → prebook → paiement Stripe → réservation
  • Vols : recherche → offres → passagers → extras → paiement Stripe
  • Pages : Mes réservations, compte, FAQ
  • Favoris / comparer : enregistrement local dans le navigateur
  • Annulation hôtel voyageur : staff uniquement

Pages

  • Home https://alyatrip.com
  • Hotels /hotels/
  • Fiche /hotel-contract-system/
  • Checkout /checkout-hotel/
  • Flights /flights/

Agence

Agency Admin et Agency Staff : opérateurs du plugin. Pas un PMS multi-tenant.

Agence

  1. Réserver pour un client — Cockpit Réserver. Moyens : carte voyageur, carte agence, wallet. Crédit en production uniquement.
  2. Annuler un hôtel — Agency Admin / Administrator, pas le front public.
  3. Documents — Voucher / reçu. Facture si SIRET + adresse.
  4. Rapports — Agrégats locaux de l’agence, pas un export finance du connecteur.

Agency Staff : tableau de bord, réservations, clients, rapports, documents, logs, CRM (lecture).

Ne peut pas réserver pour un client, annuler un hôtel, ouvrir le coffre des clés, ni purger les logs.

Cockpit : /function-user-settings/ — utilisateurs staff uniquement.

Agent book payment banner
Dashboard overview

Back office

Cockpit agence : modules métier et captures d’écran.

Dashboard

Tableau de bord : indicateurs de l’agence (SANDBOX).

Dashboard

CRM

Dossiers de réservation (liste fournisseur + index local).

CRM

Reservations

Index local des réservations hôtels.

Reservations

Pricing

Marge globale 10 %. Pas de second markup WordPress.

Pricing

Payments

Miroir des paiements voyageur. Pas de capture/remboursement WordPress.

Payments

Agencies

Fiche agence. Ce n’est pas un PMS multi-tenant.

Agencies

Reports

Rapports CA / commission / CSV. Les prebooks ne sont pas du CA.

Reports

Agent Book

Réserver un hôtel pour un client (carte voyageur, carte agence, wallet).

Agent Book

Agent Book Flight

Réserver un vol pour un client.

Agent Book Flight

Flights

Dossiers vols de l’agence.

Flights

Customers

Fiches clients créées à partir de l’e-mail du titulaire.

Customers

Team

Membres de l’agence (utilisateurs WordPress).

Team

Support

Helpdesk : tickets guidés, pas un chatbot.

Support

Hotels Cache

Cache local des fiches hôtels. Ce n’est pas un PMS.

Hotels Cache

Destinations

Cache des villes pour la recherche.

Destinations

Documents

Vouchers et itinéraires (SANDBOX).

Documents

Emails

Journal des e-mails envoyés par le plugin.

Emails

Logs

Journal des appels API. Les secrets n’apparaissent pas.

Logs

Audit

Journal des actions de l’équipe.

Audit

Alerts

Alertes opérationnelles (prebooks abandonnés, etc.).

Alerts

Connector

Santé du connecteur. Les clés restent masquées.

Connector

Settings

Réglages. Le coffre des clés est dans wp-admin.

Settings

Tools

Outils d’administration (réservés à l’administrateur).

Tools

Docs

Documentation dans le cockpit.

Docs

Paiements

WooCommerce n’est pas le moteur de paiement du connecteur.

TRAVELER
↓
STRIPE PAYMENT SDK
↓
TRANSACTION_ID
↓
ALYA REST API
↓
LITEAPI
↓
BOOKING

Le voyageur paie via Stripe Payment SDK. WooCommerce n’encaisse pas ces réservations.

Traveler card

TRANSACTION_ID · Public traveler + agent option

Stripe Payment SDK. secretKey from LiteAPI prebook. Nuitee MoR. Widget VERIFIED LIVE. Charge this funnel not submitted.

Agency account card

ACC_CREDIT_CARD · Staff only

Card on the Nuitee agency account. No Stripe widget. Public REST 403 without can_use_agency_payment().

LiteAPI wallet

WALLET · Staff only

Supplier wallet method. Not an Alya prepaid ledger. Agencies page has no wallet balance UI.

Credit

CREDIT · Staff, production only

Cockpit JS blocks CREDIT in sandbox. Local credit_limit is structural only.

Moyens absents du plugin

CIB, SATIM, Edahabia, PayPal, virement, chèque et espèces ne sont pas dans Alya Hotel System. Un bandeau marketing Elementor peut encore les citer — ce n’est pas ce plugin.

Hotel payment widget READY

Payments cockpit (SANDBOX mirror)

Commission

Observé pour la configuration testée à 10 %. Pas un contrat commercial.

Supplier Price
↓
Margin (LiteAPI field)
↓
Selling Price
↓
Commission (estimate)

commission_estimate = selling × margin / (100 + margin)

VERIFIED FOR TESTED 10% CONFIGURATION

Live reports: CA 3446.72 EUR, commission 313.30, markup 0.00. Check: 3446.72 × 10 / 110 ≈ 313.34 vs 313.30 (rounding).

Live Pricing: global 10%, overlay 0, engine cap 0–90.

Estimateur de commission Démonstration uniquement

Démonstration uniquement. Formule de la configuration testée à 10 %. Pas un contrat.

Commission estimée 10.00

selling × margin / (100 + margin)

  • Margin — percent injected into LiteAPI rates body
  • Markup — local column selling − supplier when both exist (live reports 0.00)
  • Commission — LiteAPI field when present, else estimate formula
  • Net / selling — supplier vs traveler-facing selling including margin

Pricing 10% overlay 0

Reports CA / commission / markup

Wallet

Ne pas appeler le wallet LiteAPI un wallet prépayé Alya.

LiteAPI wallet

Ce n’est pas un wallet prépayé Alya.

  • Carte voyageur = TRANSACTION_ID (Payment SDK)
  • Carte compte agence = ACC_CREDIT_CARD
  • LiteAPI wallet = WALLET (staff, supplier)

L’écran Agences n’affiche pas de solde wallet.

Agencies — no wallet UI

Connecteur

Nom commercial : Alya Dev Trip Connector. Hop technique LiteAPI. Les endpoints ne sont pas renommés.

Alya Dev Trip
↓
Hoteldz Tech cible
↓
Alya Hotel System · alya/v1
↓
Alya Dev Trip Connector

Alya Dev Trip Connector

  • Auth Clé API dans le coffre WordPress. Jamais dans le navigateur.
  • Hotels places, hotels, rates, prebook, book, cancel, amend/rebook
  • Flights rates, verify, prebooks, bookings, cancellations, prebook services
  • Payment Payment SDK + TRANSACTION_ID
  • Webhooks inbound connecteur → WordPress
  • Tableau de bord du connecteur nouvel onglet — pas le cockpit Alya

Ouvrir Alya Dev Trip Connector

Documentation du connecteur. Tableau de bord du compte connecteur — distinct du cockpit Alya. Thème cible : Hoteldz Tech.

Hoteldz Tech

Hoteldz Tech — thème cible. Alya Dev Trip Connector — nom commercial du connecteur.

Planifié / futur — direction frontend. Ce n’est pas le thème installé aujourd’hui.

Rapports

Agrégats SQL locaux. Pas un export finance du connecteur.

Reports CA / commission / markup

CA 3446.72 EUR · commission 313.30 · markup 0.00 (SANDBOX, 30 Aug 2026). Formula for tested 10%: selling × 10 / 110. Démonstration uniquement

Manuel agence

Manuel pour l’agence qui intègre et opère le plugin. Le parcours public est ce que voient vos clients.

Documentation pour les agences qui intègrent Alya Hotel System. Ce n’est pas un guide pour le voyageur qui réserve, ni un PMS hôtelier.

Intégrer le plugin

  1. WordPress — Activer Alya Hotel System. Thème cible : Hoteldz Tech (planifié). Chrome live : Traveler 3.2.9. WooCommerce n’est pas le moteur de paiement du connecteur.
  2. Fournisseur — Clés dans le vault WordPress (Administrator). Le navigateur n’envoie jamais la clé.
  3. Pages — Les pages manquantes (vols, mes-reservations, compte, FAQ, documentation) peuvent être créées sans écraser l’existant.
  4. Rôles — Administrator (vault), Agency Admin (ops, pas de vault), Agency Staff (lecture). Pas de rôle Hôtel Manager.

Opérer (Agency Admin / Staff)

  1. Cockpit /function-user-settings/ — dashboard, CRM, réservations, pricing, rapports.

    Dashboard

  2. Réserver pour un client (agent book) — cap requise.

    Agent book

  3. Marge / commission observée 10 % — pas un contrat.

    Pricing

Parcours public (clients de l’agence)

Ce que voient les voyageurs sur le site de l’agence — pas un mode d’emploi client final.

  1. STEP 01 Open homepage Hôtels.

    Hotel tab

  2. STEP 02 Search Paris 20–22 Sep 2026, 2 adults. Result: ~30 hotels.

    Results

  3. STEP 03 Open fiche hotel_id=lp1ea94.

    Details

  4. STEP 04 Choose room (double / twin, remboursable vs non).

    Rooms

  5. STEP 05 Checkout holder form.

    Checkout

  6. STEP 06 Vérifier le tarif → Stripe Payment SDK.

    Prebook / Stripe

Flight booking

  1. STEP 01 Open /flights/ (reload for a fresh nonce).

    Flight UI

  2. STEP 02 Search ALG–CDG 13–20 Sep 2026. Offers live (59+).

    Flight offers

  3. STEP 03 Passengers.

    Passengers

  4. STEP 04 Extras / bagages / sièges.

    Extras

  5. STEP 05 Paiement Stripe.

    Flight Pay UI

Agency Admin / Staff / Administrator

Agency Admin : agent book, CRM, team, pas de vault. Staff : lecture. Administrator : vault. Voir le back office.

Captures

Captures réelles uniquement. Pas de mockups.

Homepage

Hotel tab

Hotel results

Hotel details

Hotel rooms

Checkout

Prebook / Pay UI

Flight search

Flight offers

Flight passengers

Flight extras

Flight Pay UI

Dashboard

Reservations

Agencies

CRM

Pricing

Payments

Reports

Agent book

Agent book flight

Flights ops

Customers

Support

Team

Hotels cache

Destinations

Documents

Emails

Logs

Audit

Alerts

Connector (keys masked)

Settings (redacted)

Tools

In-cockpit docs

Catalogue

Fonctionnalités à présenter à une agence qui intègre. Les filtres n’inventent pas de couverture.

Homepage

Public entry, unified Vols/Hôtels search, contacts.

Workflow Open alyatrip.com

Homepage

Hotel search

Destination, dates, occupancy.

Workflow Places → search

Hotel search

Hotel results

~30 hotels observed. Favori / Comparer local.

Workflow GET /search

Hotel results

Hotel details & rates

Fiche /hotel-contract-system/. 6 offers live.

Workflow Details → rates → Réserver

Hotel details & rates

Checkout & prebook

Holder form then rate lock 213.67 EUR.

Workflow Form → Vérifier le tarif

Checkout & prebook

Traveler payment UI

Pay / Google Pay READY. Pay not submitted.

Workflow Payment SDK → TRANSACTION_ID

Traveler payment UI

Flight search UI

IATA funnel on /flights/.

Workflow Search form

Flight search UI

Flight offers

ALG–CDG 13–20 Sep 2026, 59+ offres.

Workflow Search → select

Flight offers

Flight extras

Bagages et sièges avant paiement.

Workflow Extras → continuer

Flight extras

Flight payment UI

Stripe Payment SDK 153.94 EUR.

Workflow Payer et réserver

Flight payment UI

Agent book

Staff methods: TRANSACTION_ID, ACC_CREDIT_CARD, WALLET, CREDIT (prod).

Workflow #book

Agent book

Agencies

Single agency live. Not a multi-tenant PMS. No wallet UI.

Workflow #agencies

Agencies

Dashboard

Local KPIs SANDBOX.

Workflow Cockpit #overview

Dashboard

CRM

23 remote+local vs dashboard 8.

Workflow #crm

CRM

Pricing

10% margin, overlay 0.

Workflow #pricing

Pricing

Reports

CA 3446.72 / commission 313.30 / markup 0.00.

Workflow #reports

Reports

Sécurité

Pas de certifications inventées. Les secrets ne sont jamais affichés.

Nonce

Public REST uses wp_rest nonce + IP buckets. Reload /flights/ before search. A prior pass hit expired nonce; this pass ALG–CDG offers loaded.

REST security

API key never in the browser. Public config has no secrets.

Capabilities

administrator, alya_agency_admin, alya_agency_staff, public traveler. Staff cannot edit bookings / vault / purge. Agency Admin has no manage_options.

API key protection

X-API-Key from vault on the server only. Headers to LiteAPI never exposed to traveler JS.

Thème

Cible visuelle : Hoteldz Tech (PLANNED / FUTURE). Chrome live aujourd’hui : Traveler 3.2.9.

  • Thème cible Hoteldz Tech — PLANNED / FUTURE
  • Chrome live aujourd’hui Traveler 3.2.9 (Shinetheme), no child
  • hoteldz.tech is NOT the installed live theme
  • Elementor + WooCommerce present
  • Alya injects shortcodes; hotel fiche slug /hotel-contract-system/
  • WooCommerce cart is not the connector payment engine

Hoteldz Tech

Direction frontend : Hoteldz Tech. Connecteur commercial : Alya Dev Trip Connector.

Planifié / futur — ne pas basculer le thème de production.

Glossaire

Termes produit. Les noms techniques ne sont pas traduits.

Prebook
Verrouillage tarifaire avant paiement. Ce n’est pas un bookingId.
bookingId
Identifiant fournisseur LiteAPI après book réussi.
TRANSACTION_ID
TRANSACTION_ID — identifiant Payment SDK, jamais envoyé par le navigateur vers LiteAPI.
WALLET
WALLET LiteAPI (staff). Pas un ledger prépayé Alya.
Margin
Pourcentage injecté serveur dans le corps tarifs LiteAPI.
LiteAPI
LiteAPI — hop technique d’Alya Dev Trip Connector. Endpoints inchangés.
Alya Dev Trip Connector
Alya Dev Trip Connector — nom commercial du connecteur. Ne renomme pas LiteAPI.
Hoteldz Tech
Hoteldz Tech — direction frontend FUTURE. Pas le thème live.

FAQ

Questions fréquentes tirées des preuves. Pas de fonctionnalités inventées.

Pourquoi la recherche vols affiche « Session de page expirée » ?

La page a trop longtemps attendu. Rechargez /flights/ puis relancez la recherche.

Le paiement Stripe confirme-t-il déjà la réservation ?

Le widget verrouille le tarif (prebook). La réservation fournisseur est créée après un paiement réussi.

WooCommerce encaisse-t-il les réservations du connecteur ?

Non. Le moteur est Stripe Payment SDK / TRANSACTION_ID. WooCommerce n’est pas le moteur de paiement du connecteur.

Existe-t-il un wallet prépayé Alya ?

Non trouvé. WALLET = LiteAPI (staff). Pas de solde sur l’écran Agences.

Hoteldz Tech est-il le thème live ?

Non. Thème live : Traveler 3.2.9. Hoteldz Tech = PLANNED / FUTURE.