docs: document Products module and refactored Payment Links

[mintlify]

Summary

Adds documentation for the new Products catalog and the refactored Payment Link model (multi-item, freight, price override) introduced in fastsoftbrasil/global-whitelabel-payment-gateway#623.

Changes

• New guide Produtos (guias/produtos.mdx) covering the /v1/products CRUD: price/currency, SKU, stock, weight/dimensions, archive/reactivate, image and digital-file upload.
• New guide Link de Pagamento (guias/link-de-pagamento.mdx) covering the new items[] model with productId + quantity, priceOverride, the three freight modes (none / fixed / checkout), the freight-availability endpoint, the updated GET /v1/payment-links/:id response (each item with signed imageUrl, plus freight and priceOverride), and the new buyer checkout layout (multi-product summary, Subtotal · Frete · Total, physical vs. digital derived from items).
• api-reference/openapi.yaml updated:
  • New paths: /v1/products (POST/GET), /v1/products/summary, /v1/products/{id} (GET/PUT), /v1/products/{id}/status, /v1/products/{id}/image, /v1/products/{id}/file, /v1/payment-links/freight-availability, /v1/payment-links/{id}.
  • New schemas: NewProduct, UpdateProduct, Product, PaginatedProductList, ProductSummary, PaymentLinkItem, PaymentLinkItemDetail, Freight, PaymentLink.
  • Added freightAmount to NewCharge.
• Registered both new pages under the Recursos group in docs.json.

Context

Source PR: fastsoftbrasil/global-whitelabel-payment-gateway#623 — "feat: módulo de Produtos + refactor do Link de Pagamento + redesign do Checkout".

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
fastpay	🟢 Ready	View Preview	Jun 23, 2026, 12:26 PM