Criar um produto

POST /v1/products · Requer o escopo products:write

Um produto é algo que você vende. Todo produto tem uma ou mais ofertas — formas de comprá-lo, cada uma com um preço. Este endpoint cria o produto e a primeira oferta juntos; essa oferta vira a padrão.

Parâmetros do corpo

string

obrigatório

Nome do produto, de 1 a 160 caracteres.

string

Até 2000 caracteres. Padrão: string vazia.

object

Pares chave–valor livres para seu uso.

object

obrigatório

A primeira oferta do produto. Mesmo formato de Criar uma oferta, sem is_default.

Ocultar propriedades de default_offer

integer

obrigatório

Preço em unidades menores (centavos). De 1 a 99999999999.

string

obrigatório

ISO 4217 em maiúsculas, ex. BRL.

string

Rótulo da oferta, de 1 a 160 caracteres. Padrão: "Padrão".

integer

Um preço de referência riscado. Deve ser ≥ amount_minor.

string

padrão:"one_time"

one_time ou recurring.

string

day, week, month ou year. Obrigatório quando type é recurring; não permitido quando one_time.

integer

Intervalos entre cobranças, de 1 a 999. Só para recorrente; padrão 1.

Requisição

cURL

curl --request POST https://api.moneydev.com.br/v1/products \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "Plano Pro",
    "description": "Acesso completo por 12 meses",
    "default_offer": {
      "name": "Anual",
      "amount_minor": 49900,
      "currency": "BRL"
    }
  }'

Resposta

201 Created com o objeto de produto. default_offer é o objeto de oferta recém-criado.

{
  "id": "prod_4d5e6f7a-8b9c-4d0e-1f2a-3b4c5d6e7f8a",
  "object": "product",
  "name": "Plano Pro",
  "description": "Acesso completo por 12 meses",
  "status": "active",
  "metadata": {},
  "default_offer": {
    "id": "offer_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "object": "offer",
    "product_id": "prod_4d5e6f7a-8b9c-4d0e-1f2a-3b4c5d6e7f8a",
    "name": "Anual",
    "lookup_key": "offer_a1b2c3d4e5f64a7b8c9d0e1f2a3b4c5d",
    "amount_minor": 49900,
    "compare_at_amount_minor": null,
    "currency": "BRL",
    "type": "one_time",
    "billing_interval": null,
    "interval_count": null,
    "is_default": true,
    "active": true,
    "created_at": "2026-08-28T13:05:00.000Z",
    "updated_at": "2026-08-28T13:05:00.000Z"
  },
  "created_at": "2026-08-28T13:05:00.000Z",
  "updated_at": "2026-08-28T13:05:00.000Z"
}

Erros

Status	`code`	Causa
`400`	`invalid_request`	Validação falhou; `param` indica o campo
`400`	`invalid_product_name`	`name` ficou vazio após remover espaços
`400`	`invalid_compare_at_amount`	`default_offer.compare_at_amount_minor` é menor que `amount_minor`
`400`	`billing_interval_required`	`default_offer.type` é `recurring` sem `billing_interval`
`400`	`invalid_one_time_billing`	Uma oferta `one_time` informou `billing_interval` ou `interval_count`

Objeto de produto

string

ID do produto, com prefixo prod_.

string

Sempre "product".

string

Nome do produto.

string

Descrição, ou "".

string

active ou archived.

object

Seus metadados.

object | null

A oferta padrão atual, ou null se nenhuma estiver ativa.

string

Data/hora de criação em ISO 8601.

string

Data/hora da última alteração em ISO 8601.

Introdução

Conta

Clientes

Produtos

Ofertas

Checkouts

Parâmetros do corpo

Requisição

Resposta

Erros

Objeto de produto

​Parâmetros do corpo

​Requisição

​Resposta

​Erros

​Objeto de produto

Parâmetros do corpo

Requisição

Resposta

Erros

Objeto de produto