url retornada: domínio e caminho podem variar. O ID chk_ identifica a oferta dentro da Hubfy.
Por exemplo, publique um curso de R$ 99 com Pix e cartão e envie a URL retornada ao comprador. Concluir a página de Pix não confirma o pagamento: a entrega depende da confirmação financeira recebida pela Hubfy.
Objeto completo
Campos
string
Identificador público estável, com prefixo chk_. É o mesmo ID do checkout no painel. Use a URL retornada; não construa o endereço a partir do ID.
boolean
Permite informar códigos de desconto na página.
integer
Subtotal em centavos, calculado com os preços atuais dos itens. Somente leitura.
string
Destino HTTPS ao cancelar a compra. null remove.
object
Apresentação, banner, dados exigidos e mensagem final. Campos visuais null herdam o padrão.
string
Data e hora da criação, em ISO 8601 com fuso horário. Somente leitura.
string
Sempre BRL.
string
Desconto disponível na conta de pagamentos. null remove o desconto automático.
boolean
Repassa tarifas ao comprador. Apenas compras avulsas.
string
Quem absorve os juros do parcelamento: comprador ou conta.
array
Itens vendidos pelo link, na ordem de exibição.
integer
Máximo de parcelas no cartão. Assinaturas não parcelam.
object
Objeto JSON livre para referências da integração, limitado a 16 KB.
string
Informação retornada pela oferta.
array
Até três ofertas adicionais avulsas, de produtos diferentes dos itens principais.
string
Coleta do cartão nas assinaturas: sempre ou apenas quando houver pagamento imediato.
array
Meios de pagamento. Assinaturas recorrentes usam credit_card.
object,null
Período de renovação quando os itens são assinaturas; null em compras avulsas. Somente leitura.
string
draft não abre compras; active está publicado; inactive foi desativado.
object
Condições da assinatura. O link aceita período grátis em dias; data final absoluta de trial pertence a sessões individuais.
string,null
Destino HTTPS após concluir a página; não confirma pagamento. Aceita .
string
Layout da página. null usa o padrão da conta.
string
Título exibido na página.
integer
Compras confirmadas por este link. Somente leitura.
string
Data e hora da última alteração, em ISO 8601 com fuso horário. Somente leitura.
string
URL confirmada do checkout hospedado. Pode usar o domínio configurado. Não construa a URL a partir do ID.
Escrita
A criação exigetitle, line_items e o cabeçalho Idempotency-Key. Reutilize a mesma chave apenas para repetir a mesma solicitação. Para alterações, envie uma chave diferente. Um rascunho pode ter url: null; publicar exige ativação aprovada. Produtos e preços precisam pertencer à conta. Compras avulsas e assinaturas não se misturam nos itens principais.
checkout_experience é mesclado por campo nas atualizações. As listas line_items e optional_items são substituídas por inteiro. Itens adicionais usam preço avulso positivo e geram seus próprios acessos. O título, a capa e a descrição dos produtos vêm do catálogo.
Não há campos appearance, cover_url, description, collect_phone, collect_address, confirmation_message ou expires_at no nível principal. Use checkout_experience para a coleta de dados e a mensagem final. Links reutilizáveis não expiram por data; desative a oferta para encerrar vendas.
Cores, fontes, tema e cantos da conta são administrados em Configurações → Branding. Logos completos, rodapé, domínio e padrões da plataforma são configuração operacional.