SDK Quick Start Ready to integrate? This guide will get you up and running with Kintsugi SDKs in just a few minutes.
Prerequisites Before you begin, make sure you have:
Choose Your SDK from kintsugi_tax import KintsugiClient # Initialize the client client = KintsugiClient( api_key = "your-api-key" , organization_id = "your-org-id" ) # Calculate tax for a transaction tax_result = client.tax.estimate({ "line_items" : [ { "quantity" : 1 , "price" : 100.00 , "product_tax_code" : "A_GEN_TAX" } ], "ship_to" : { "street_1" : "123 Main St" , "city" : "San Francisco" , "state" : "CA" , "postal_code" : "94105" , "country" : "US" } }) print ( f "Tax amount: $ { tax_result.total_tax } " )
npm install @kintsugi-tax/sdk
import { KintsugiClient } from '@kintsugi-tax/sdk' ; // Initialize the client const client = new KintsugiClient ({ apiKey: 'your-api-key' , organizationId: 'your-org-id' }); // Calculate tax for a transaction const taxResult = await client . tax . estimate ({ lineItems: [ { quantity: 1 , price: 100.00 , productTaxCode: 'A_GEN_TAX' } ], shipTo: { street1: '123 Main St' , city: 'San Francisco' , state: 'CA' , postalCode: '94105' , country: 'US' } }); console . log ( `Tax amount: $ ${ taxResult . totalTax } ` );
< dependency > < groupId > com.kintsugi.taxplatform </ groupId > < artifactId > kintsugi-tax-java-sdk </ artifactId > < version > 0.14.0 </ version > </ dependency >
import com.kintsugi.taxplatform.SDK; public class Application { public static void main ( String [] args ) { // Initialize the SDK SDK sdk = SDK . builder () . apiKey ( "your-api-key" ) . organizationId ( "your-org-id" ) . build (); // Calculate tax for a transaction TaxEstimateRequest request = TaxEstimateRequest . builder () . lineItems ( Arrays . asList ( LineItem . builder () . quantity ( 1 ) . price ( 100.00 ) . productTaxCode ( "A_GEN_TAX" ) . build () )) . shipTo ( Address . builder () . street1 ( "123 Main St" ) . city ( "San Francisco" ) . state ( "CA" ) . postalCode ( "94105" ) . country ( CountryCodeEnum . US ) . build ()) . build (); try { TaxEstimateResponse response = sdk . tax (). estimate (request); System . out . println ( "Tax amount: $" + response . getTotalTax ()); } catch ( Exception e ) { System . err . println ( "Error: " + e . getMessage ()); } } }
Authentication All SDKs use API key authentication. You can get your API key from the Kintsugi Platform . Partners manage keys in the Partner Experience under Settings → API Keys .
Keep your API key secure - Never commit API keys to version control. Use environment variables or secure configuration management.
Environment Variables Set your API key as an environment variable:
export KINTSUGI_API_KEY = "your-api-key" export KINTSUGI_ORGANIZATION_ID = "your-org-id"
Then initialize the SDK without hardcoding credentials:
import os from kintsugi import KintsugiClient client = KintsugiClient( api_key = os.getenv( "KINTSUGI_API_KEY" ), organization_id = os.getenv( "KINTSUGI_ORGANIZATION_ID" ) )
import { KintsugiClient } from '@kintsugi/sdk' ; const client = new KintsugiClient ({ apiKey: process . env . KINTSUGI_API_KEY ! , organizationId: process . env . KINTSUGI_ORGANIZATION_ID ! });
Next Steps
API Reference Browse the complete API documentation
Error Handling Learn about error handling patterns
Best Practices Follow our recommended practices
