Skip to main content
POST
Criar Oferta

Visão Geral

Ofertas são configurações específicas de preço e condições para um produto. Um produto pode ter múltiplas ofertas com valores e promoções diferentes.

Endpoint

Parâmetros

hash
string
required
Hash identificador único do produto
api_token
string
required
Seu token de autenticação da API KlivoPay
title
string
required
Título da oferta (ex: “Promoção de Lançamento”, “Black Friday”)
amount
integer
required
Valor da oferta em centavos. Exemplo: R$ 199,00 = 19900
cover
string
URL da imagem de capa da oferta

Exemplo de Requisição

Resposta de Sucesso

201 Created

Códigos de Resposta

201
Created
Oferta criada com sucesso
400
Bad Request
Dados inválidos na requisição
401
Unauthorized
Token de API inválido ou ausente
404
Not Found
Produto não encontrado
422
Unprocessable Entity
Erro de validação nos dados enviados
500
Internal Server Error
Erro interno do servidor
Use o hash da oferta criada no parâmetro offer_hash ao criar transações.