Kintsugi Integration: Diagnosis and Resolution
Use this reference to understand common Kintsugi integration issues, including missing tax results, rejected transactions, unexpected tax amounts, and timeouts.
Issue | Workaround |
|---|---|
The tax result is missing | Ensure the following:
|
The transaction is rejected | Review the Kintsugi response and Zuora tax integration logs. Check for missing required fields, invalid addresses, unsupported transaction types, invalid credentials, or configuration mismatches between Zuora and Kintsugi. |
The tax amount is unexpected | Verify the taxable address, product tax code, transaction date, exemption status, currency, and taxability settings. Confirm that the same transaction was not submitted more than once and that the Kintsugi configuration reflects the intended jurisdictions and products. |
The integration times out | Check the connection status, endpoint availability, timeout settings, and retry behavior. If the issue continues, collect the Zuora tenant, transaction identifier, timestamp, request identifier, and Kintsugi error details before contacting support. |