Skip to main content
POST
/
products
/
{hash}
/
offers
Criar Oferta
curl --request POST \
  --url https://api.example.com/products/{hash}/offers \
  --header 'Content-Type: application/json' \
  --data '
{
  "api_token": "<string>",
  "title": "<string>",
  "amount": 123,
  "cover": "<string>"
}
'
{
  "201": {},
  "400": {},
  "401": {},
  "404": {},
  "422": {},
  "500": {}
}

​
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

POST https://api.klivopay.com.br/api/public/v1/products/{hash}/offers

​
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

curl -X POST 'https://api.klivopay.com.br/api/public/v1/products/prod123abc/offers' \
  -H 'Content-Type: application/json' \
  -d '{
    "api_token": "seu_token_aqui",
    "title": "Promoção de Lançamento",
    "amount": 19900,
    "cover": "https://exemplo.com/oferta.jpg"
  }'

​
Resposta de Sucesso

201 Created
{
  "success": true,
  "data": {
    "hash": "offer123",
    "title": "Promoção de Lançamento",
    "amount": 19900,
    "cover": "https://exemplo.com/oferta.jpg",
    "product_hash": "prod123abc",
    "created_at": "2025-01-20T10:15:00Z"
  }
}

​
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.