1. Integration Guide
Kapitale
  • Integration Guide
    • 📋 Introduction
    • 🔐 Authentication
    • 🚀 Integration Flow
    • 🔔 Webhooks
    • 🔄 Integration Flowchart
    • 🧪 Sandbox Environment
    • 📊 Status Map
    • ⚠️ Error Handling
    • 📝 Practical Examples
    • 💳 Receivable Consultation
    • 📞 Support
  • API
    • Retail
      • Fetch retail information by CNPJ
    • Orders
      • Create a new order
      • List orders
      • Fetch order by ID
      • Set payment invoice
      • Cancel order
    • Receivable
      • Fetch receivables by CNPJ
  • Schemas
    • CreateOrderRequest
    • RetailInfo
    • Acquirer
    • CancelOrderRequest
    • PurchaseItem
    • Order
    • FindReceivableResponse
    • OrderStatus
    • PaymentStatus
    • FindByIndustryCnpjResponse
    • OrderStatistics
    • Error
    • ReceivableItem
  1. Integration Guide

⚠️ Error Handling

The API returns standard HTTP codes and descriptive error messages:

Common HTTP Codes#

CodeMeaningRecommended Action
200SuccessProcess response normally
201CreatedOrder created successfully
400Bad RequestVerify submitted data
401UnauthorizedVerify JWT token
404Not FoundVerify resource ID
409ConflictResource already exists (e.g., duplicate order)
500Internal ErrorContact support

Error Example#

{
  "statusCode": 400,
  "message": "Invalid CNPJ. Please check and try again.",
  "error": "Bad Request"
}
Modified at 2026-03-13 16:43:36
Previous
📊 Status Map
Next
📝 Practical Examples
Built with