/api/v1/b2c/

Integre com contratos versionados.

Resumo dos contratos do GestaProp e exemplos da API B2C v1. Cada operação indica seu status; os schemas versionados governam a integração.

OpenAPI 3.1 v1 es · en · fr · pt

POST /api/v1/b2c/offers Dados fictícios

curl -X POST https://gestaprop.com/api/v1/b2c/offers \
  -H "Content-Type: application/json" \
  -H "Origin: https://hotel.example" \
  -H "X-Public-Site-Id: pst_hotel-demo" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "propertyId": 42,
    "checkInDate": "2026-11-14",
    "checkOutDate": "2026-11-16",
    "occupancy": { "adults": 2, "childrenAges": [] },
    "locale": "pt",
    "currency": "MXN"
  }'

Obtenha accessToken por POST /api/v1/b2c/access para o publicSiteId e a origem HTTPS verificados. Substitua site, propriedade e datas do exemplo; o token é efêmero e não é uma chave secreta de servidor.

Documentação v1

Suportada Indisponível

01 Suportada

Autenticação e chaves Chave publicável por site, token efêmero vinculado à origem HTTPS exata e segredo server-to-server guardado só como hash.

02 Suportada

Catálogo e ofertas Consulta de propriedades, unidades e cotação assinada: detalhamento por noite, descontos, cupom, extras e impostos, com vencimento. O checkout sempre cota de novo. catalog.read · offers.quote

03 Suportada

Checkout hospedado Retorna uma URL de pagamento idempotente a partir de uma cotação verificável. Não é uma reserva paga: só o webhook do provedor confirma. checkout.initiate

04 Suportada

Widget Instalação por CDN versionado e imutável, com integridade SRI e Shadow DOM. Preenchimento de datas e ocupação pela URL. Migração a partir do gestawidget.

05 Suportada

Contratos e vetores Cada contrato público tem seu JSON Schema versionado e vetores de teste: catálogo, oferta, cotação, referência, início do checkout e sessão. v1

06 Suportada

PMS Leitura do ARI publicado e reservas do GestaProp, por propriedade com cursor; sem pagamentos, documentos nem dados fiscais. pms.read

07 Indisponível

Webhooks Eventos assinados para o seu servidor.

Erros e cotas Códigos de erro estáveis, limites por credencial, chave de idempotência em cada escrita e novas tentativas seguras.

Changelog Mudanças por versão. Mudanças incompatíveis vão para /v2/.

Chaves de API

As chaves são criadas no console, não aqui.

Um Admin, Gerente ou titular do Solo Pago cria e revoga chaves pelo console do GestaProp, com escopo por propriedade.

Entrar no console

Visível uma única vezO segredo aparece na criação; depois você vê apenas o sufixo.

Escopos explícitosCada chave tem só as permissões de que precisa.

Revogação imediataSem expiração automática; revogue quando decidir.

Nunca no navegadorSegredos server-to-server não vão em snippets nem no widget.

Origem verificadaO widget só funciona em domínios cujo controle você comprovou, por registro TXT ou arquivo verificado.

Sem escrita de terceirosNenhuma chave cria uma reserva confirmada nem declara um total; não existe pms.write.

catalog.read offers.quote checkout.initiate pms.read

Vamos falar da sua operação

Escreva no WhatsApp ou deixe seus dados. Uma pessoa da equipe comercial vai responder.

Falar no WhatsApp Escreva para nós