Welcome to Zuora Product Documentation

Explore our rich library of product information

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 Kintsugi connection is active.

  • The transaction is included in the configured integration flow.

  • Required customer and address fields are populated.

  • The product or charge has the expected tax configuration.

  • The transaction was not excluded by a tax or billing rule.

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.