FAQ - TEROCARBON

Q1: What happens if I don't report an internal transaction using reportTransaction?

A: Tero Carbon's master registry will become inconsistent with the actual status of VCUs managed on your platform. This can lead to audit discrepancies, reconciliation problems, and potential issues if users try to move assets back to Tero Carbon. Accurate and timely reporting is mandatory.

Q2: How do I handle fractional units (kgCO2e) if Tero Carbon only re-tokenizes whole tonnes (tCO2e)?

A: Your marketplace can manage and trade VCUs internally in kgCO2e for flexibility. When reporting internal Transfer or Retire operations via reportTransaction, you can specify the quantity in kgCO2e using the unit parameter. However, when using reportTransaction with operation: Detokenization to return VCUs to the Tero ecosystem, you must specify the quantity in whole tCO2e units (unit: "tCO2e"). Tero will only re-tokenize that whole number. Your platform is responsible for managing any residual kgCO2e fractions that cannot form a full tonne for return.

Q3: What's the difference between Tero's tokenization and my marketplace's tokenization?

A: Tero Carbon's tokenization represents the official VCU registration on the public Polygon blockchain – the source of truth. When VCUs enter your custody, Tero marks its token as "externalized". Your marketplace's internal tokenization is a representation of that VCU specifically for trading within your platform. It must be accurately backed 1:1 by the VCUs Tero has marked as externalized to your custody.

Q4: Why does my marketplace need its own Tero Carbon account/wallet?

A: This account acts as the designated custody location within the Tero Carbon system. VCUs must reside in this account for your API key to access their data and for Tero to track which assets are under your platform's management.

Q5: Can I list projects or issuances I see using the /getProjectData or /getIssuanceData (CAD Trust data) endpoints?

A: No. These endpoints provide access to public data reported by Tero Carbon for transparency and analysis. You can only list VCUs on your platform that have been explicitly transferred into your Marketplace's Tero Carbon custody account. Listing assets not in your custody is a violation of the terms.

Q6: What is the Staging environment for?

A: It's a dedicated testing environment (http://stage.api.terocarbon.com:3000/integration) allowing you to develop and test your API integration thoroughly without affecting live data or real assets. Use the specific Staging API keys here.

Q7: How do I know if my reportTransaction notification was approved or rejected by Tero Carbon?

A: The API call itself will likely return a 202 Accepted if the notification format is valid and received. The actual approval or rejection (after potential manual review by Tero administrators) will be communicated asynchronously via a Webhook sent to the endpoint you configured during onboarding. You must implement a listener for these webhooks.