Cele patru capabilități care contează
Secțiune intitulată „Cele patru capabilități care contează”| Capabilitate | Ce înseamnă | De ce produsele se blochează fără ea |
|---|---|---|
| Tarife și disponibilitate live | Prețuri actuale și ce este efectiv rezervabil, pe interval de date | Tarifele cache nu funcționează la confirmare și erodează încrederea |
| Crearea rezervării | Crearea unei rezervări reale pe care hotelul o primește | Fără ea ești doar un link de recomandare, nu un produs |
| Plata | Preluarea banilor ca parte a rezervării | Redirecționarea către alt site ucide conversia |
| Confirmarea și webhooks | Informarea oaspetelui, hotelului și sistemului tău despre ce s-a întâmplat | Altfel apar probleme de suport și reconciliere |
Majoritatea „API-urilor hoteliere” găsite de un dezvoltator acoperă primul și uneori al doilea. Tranzacția este partea dificilă și cea care decide dacă ai un produs.
A cui ofertă integrezi?
Secțiune intitulată „A cui ofertă integrezi?”Această întrebare modelează tot ce urmează. Oferta revândută printr-un lanț vine cu un adaos în tarif, disponibilitate mai veche și fără cale de întoarcere la hotel pentru întrebări despre rezervare. Oferta directă de la hotel poartă tariful propriu al hotelului, disponibilitate live și un hotel care știe că rezervarea există.
Pentru orice situație în care călătorul va compara cu site-ul propriu al hotelului — ceea ce este majoritatea cazurilor — oferta controlată de hotel evită momentul stânjenitor când prețul tău este mai prost.
Cine este comerciantul înregistrat
Secțiune intitulată „Cine este comerciantul înregistrat”Dacă construiești rezervarea hotelului singur, a deveni comerciant înregistrat înseamnă să preiei responsabilitatea pentru plăți, chargeback-uri, rambursări, gestionarea taxelor și adesea o licență de agenție de turism în fiecare piață.
Pe Wink, hotelul rămâne comerciantul înregistrat și plata este colectată pentru hotel, deci integratorul nu moștenește această responsabilitate. Aranjamentele de comerciant înregistrat sunt disponibile pentru integrările API unde un partener chiar trebuie să preia plata, iar această cale implică propriile cerințe de licențiere.
Trei niveluri de integrare
Secțiune intitulată „Trei niveluri de integrare”- Componente web. Adaugi o căutare rezervabilă, listă de camere sau checkout într-o pagină existentă. Fără muncă pe backend; cel mai puțin control asupra layout-ului.
- REST API. Control complet asupra căutării, tarifelor, creării rezervării și confirmării, autentificat cu OAuth2. Folosește-l când fluxul de rezervare face parte din experiența produsului tău.
- Server MCP. Aceleași capabilități expuse pentru agenții AI, astfel încât un asistent să poată căuta, calcula prețuri și finaliza o rezervare în loc să trimită utilizatorul către un site.
Cele trei nu sunt exclusive — un produs folosește adesea componente pentru suprafața de marketing și API-ul pentru fluxul principal.
Ce să construiești prima dată
Secțiune intitulată „Ce să construiești prima dată”- Caută și calculează preț pentru un singur oraș și un singur interval de date. Obține tarife reale înainte să proiectezi ceva.
- Creează o rezervare test completă, inclusiv plata și confirmarea.
- Abonează-te la
booking.createși la evenimentele de anulare înainte să construiești orice UI deasupra. - Decide devreme modelul tău de atribuire — contextul sursei trebuie să călătorească cu rezervarea, altfel raportarea va fi doar presupuneri mai târziu.
- Gestionează cazurile de eșec: disponibilitate pierdută între ofertă și rezervare, plata refuzată, rambursări parțiale.
Prețuri pe care un dezvoltator ar trebui să le știe
Secțiune intitulată „Prețuri pe care un dezvoltator ar trebui să le știe”API-urile Consumer și Booking Engine sunt gratuite. API-ul Partner include o alocație lunară gratuită de 10.000 nopți de hotel, apoi se facturează pe unitate. Rezervările confirmate poartă taxa de platformă a hotelului de 1,5% plus costul procesării cardului, iar o comisionare implicită de 10% se aplică când produsul tău a generat rezervarea — astfel integratorul câștigă, nu plătește.
Greșeli comune
Secțiune intitulată „Greșeli comune”- Construirea pe tarife cache. Par ok în dezvoltare, dar eșuează în producție.
- Lăsarea plății pe o redirecționare. Fiecare transfer pierde rezervări.
- Ignorarea webhook-urilor până la lansare. Reconcilierea devine o muncă manuală.
- A deveni comerciant înregistrat fără să fie nevoie. Este o decizie de licențiere și responsabilitate, nu doar tehnică.
- Ne-transmiterea contextului sursei. Atribuirea nu poate fi reconstruită ulterior.