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

​
Visão Geral

Este endpoint permite cadastrar um novo produto na plataforma KlivoPay. Produtos são itens que você vende e podem ser digitais ou físicos.

​
Endpoint

POST https://api.klivopay.com.br/api/public/v1/products

​
Parâmetros

​
api_token
string
required
Seu token de autenticação da API KlivoPay
​
title
string
required
Título/nome do produto
​
cover
string
required
URL da imagem de capa do produto
​
amount
integer
required
Valor do produto em centavos. Exemplo: R$ 299,00 = 29900
​
payment_type
integer
required
Tipo de pagamento: 1 = Pagamento único
​
product_type
string
required
Tipo do produto: digital ou fisico
​
id_category
integer
required
ID da categoria do produto (use o endpoint de categorias para consultar)
​
sale_page
string
URL da página de vendas do produto
​
delivery_type
string
Tipo de entrega para produtos digitais: email, download, etc.

​
Exemplo de Requisição

curl -X POST 'https://api.klivopay.com.br/api/public/v1/products' \
  -H 'Content-Type: application/json' \
  -d '{
    "api_token": "seu_token_aqui",
    "title": "Curso de Marketing Digital",
    "cover": "https://exemplo.com/capa.jpg",
    "sale_page": "https://meucurso.com.br/marketing",
    "payment_type": 1,
    "product_type": "digital",
    "delivery_type": "email",
    "id_category": 5,
    "amount": 29900
  }'

​
Resposta de Sucesso

201 Created
{
  "success": true,
  "data": {
    "hash": "prod123abc",
    "title": "Curso de Marketing Digital",
    "cover": "https://exemplo.com/capa.jpg",
    "sale_page": "https://meucurso.com.br/marketing",
    "product_type": "digital",
    "delivery_type": "email",
    "payment_type": 1,
    "amount": 29900,
    "category": {
      "id": 5,
      "name": "Educação"
    },
    "created_at": "2025-01-20T10:15:00Z"
  }
}

​
Códigos de Resposta

​
201
Created
Produto criado com sucesso
​
400
Bad Request
Dados inválidos na requisição
​
401
Unauthorized
Token de API inválido ou ausente
​
422
Unprocessable Entity
Erro de validação nos dados enviados
​
500
Internal Server Error
Erro interno do servidor