> ## Documentation Index > Fetch the complete documentation index at: https://dev.valorapayments.com.br/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Valora Payments API (Brazil: Pix, card, boleto). Base URL https://api.valorapayments.com.br, Authorization: Bearer sk_vl_... used only on the server. Request amounts are reais as strings ("149.90"); response amounts are integer cents (14990). Use POST /v1/checkouts for card and boleto; POST /v1/payments only creates Pix and should send an Idempotency-Key. Confirm payments only through the payment.succeeded webhook after verifying X-Valora-Signature (hex HMAC-SHA256 of "."), dedupe by event.id and check livemode. Never invent endpoints or fields: check /llms.txt and /openapi.json. # Criar um produto > Cadastra um produto. O preço do produto é a base de checkouts e de cobranças com `product_id`. Escopo: `products:write`. ## OpenAPI ````yaml /openapi.json post /v1/products openapi: 3.1.0 info: title: Valora Payments API version: 1.0.0 description: >- API REST da Valora Payments. Valores na entrada em reais (texto, ex.: "149.90"); nas respostas, em centavos inteiros. servers: - url: https://api.valorapayments.com.br description: Teste e produção (o ambiente vem da chave) security: - bearerAuth: [] tags: - name: Pagamentos - name: Checkouts - name: Clientes - name: Produtos - name: Saldo - name: Webhooks paths: /v1/products: post: tags: - Produtos summary: Criar um produto description: >- Cadastra um produto. O preço do produto é a base de checkouts e de cobranças com `product_id`. Escopo: `products:write`. operationId: criarProduto requestBody: required: true content: application/json: schema: type: object required: - name - price additionalProperties: false properties: name: type: string description: Nome (até 120). maxLength: 120 description: type: string description: Descrição (até 2000). maxLength: 2000 type: type: string description: Tipo. enum: - physical - digital - service default: physical status: type: string description: Status. enum: - draft - active - archived default: active images: type: array maxItems: 8 items: type: string format: uri description: Até 8 URLs HTTPS. price: oneOf: - type: string pattern: ^\d{1,9}(\.\d{1,2})?$ - type: number description: >- Preço. Em reais, com até 2 casas e ponto decimal (ex.: "149.90"). Mínimo 0.01. examples: - '149.90' external_reference: type: string description: O seu identificador (SKU). Único por negócio. maxLength: 100 statement_description: type: string description: Texto que o pagador vê no Pix (até 140). maxLength: 140 metadata: type: object additionalProperties: type: string maxLength: 500 maxProperties: 20 description: >- Até 20 pares chave/valor em texto (chave até 40, valor até 500 caracteres). Volta igual nas respostas e nos webhooks. examples: - order_id: '1001' examples: exemplo: summary: Exemplo value: name: Mentoria individual description: Uma hora de mentoria por videochamada. type: service price: '149.90' external_reference: sku-mentoria-1h responses: '201': description: Produto criado. content: application/json: schema: $ref: '#/components/schemas/Product' '401': description: Chave ausente, inválida ou revogada. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: invalid_api_key message: Chave de API inválida ou revogada. '403': description: >- A chave não tem o escopo da rota, ou a empresa ainda não opera em produção. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: missing_scope message: A chave não tem o escopo necessário. '409': description: Já existe produto com este `external_reference`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: external_reference_in_use message: external_reference já usado. '422': description: Dados inválidos. Veja `details`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: invalid_request message: Corpo inválido. details: amount: - Valor inválido. '429': description: Limite de requisições. Veja o header `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: rate_limited message: Muitas requisições. Tente novamente em instantes. '503': description: Indisponibilidade temporária. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: service_unavailable message: Serviço temporariamente indisponível. security: - bearerAuth: [] components: schemas: Product: type: object properties: id: type: string description: Id do produto. pattern: ^prod_[A-Za-z0-9_-]{16}$ examples: - prod_Xk2v9QeR7tLmN3bA object: type: string description: Sempre `product`. enum: - product name: type: string description: Nome. description: type: - string - 'null' description: Descrição. type: type: string description: Tipo. enum: - physical - digital - service status: type: string description: Status. enum: - draft - active - archived images: type: array items: type: string format: uri description: URLs das imagens. price: type: object properties: amount: type: integer description: Preço em centavos. examples: - 14990 currency: type: string description: Moeda. enum: - BRL external_reference: type: - string - 'null' description: O seu identificador (SKU). statement_description: type: - string - 'null' description: Texto que o pagador vê no Pix. metadata: type: object additionalProperties: type: string maxLength: 500 maxProperties: 20 description: >- Até 20 pares chave/valor em texto (chave até 40, valor até 500 caracteres). Volta igual nas respostas e nos webhooks. examples: - order_id: '1001' created_at: type: string description: Criação. format: date-time updated_at: type: string description: Última alteração. format: date-time archived_at: type: - string - 'null' description: Quando foi arquivado. format: date-time Error: type: object required: - error properties: error: type: object required: - type - message properties: type: type: string description: Código estável do erro. Veja a página Erros. examples: - invalid_request message: type: string description: Explicação em português. Não compare o texto. examples: - Corpo inválido. details: type: object additionalProperties: type: array items: type: string description: 'Só em erros de validação: problemas por campo.' securitySchemes: bearerAuth: type: http scheme: bearer description: >- Chave de API `sk_vl_...` criada no painel em Desenvolvedores → Chaves de API. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.