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

๐Ÿงช Sandbox Environment

This document describes sandbox-specific peculiarities for testing the Order API. For general integration flow and endpoints, see Introduction and Integration Flow.

Base URLs#

Order API: https://partners-sandbox.kapitale.com.br
Auth API: https://partners-auth-sandbox.kapitale.com.br

Test Data#

Company (GET /company/cnpj/:cnpj)#

Registered company: Use CNPJ 33727890000197 (pre-registered in sandbox database). Returns registered_retail: true with data from Kapitale's database.
Non-registered company: Use any valid 14-digit CNPJ (numbers only) other than the one above. Returns registered_retail: false with data fetched from the credit bureau (Procob).

Order Listing (GET /order)#

Use retail_cnpj=33727890000197 to filter orders for the registered test company.
The industry context (whose orders are returned) comes from the JWT token. Sandbox credentials are already associated with an industry that has test data.
Modified atย 2026-03-16 17:39:20
Previous
๐Ÿ”„ Integration Flowchart
Next
๐Ÿ“Š Status Map
Built with