TEROCARBON
  1. Integration Workflow
TEROCARBON
  • Introduction
    • Welcome to Tero Carbon
    • Benefits of Integrating with Tero Carbon
  • Getting Started
    • Authentication
    • Base URLs
    • Rate Limiting
    • Webhooks
  • Core Concepts
    • Core Concepts Overview
    • Assets (Verified Carbon Units - VCUs)
    • OpenSea & CAD Trust Publication
    • Smart Contracts
  • Integration Workflow
    • 1. Onboarding & Setup
    • 2. Listing VCUs on the Marketplace (User Journey)
    • 3. Handling Internal Marketplace Transactions (Transfers & Retirements)
    • 4. Returning VCUs to Tero Carbon (Detokenization/Retokenization)
    • 5. Querying Public Data (CAD Trust)
  • API Endpoints
    • Marketplace Data
      • getProjectData
      • getIssuanceData
      • getUnitsData
    • Notifications
      • reportTransaction
    • CAD Trust Data
      • getProjectList
      • getIssuanceList
      • getUnitList
  • Policies & Legal
    • Legal Disclaimer
    • Privacy Policy
    • Asset Integrity Policy (Summary)
  • Resources
    • FAQ
    • Glossary
    • Support
    • Useful Links
  • Resources
  1. Integration Workflow

3. Handling Internal Marketplace Transactions (Transfers & Retirements)

Internal Transfer:
1.
Marketplace Action: User A sells/transfers their internally tokenized VCU representation to User B within the Marketplace platform. The Marketplace updates its internal ledger.
2.
Notification to Tero: The Marketplace calls reportTransaction with operation: Transfer, detailing the quantity, units (tCO2e or kgCO2e), source issuance, internal sender/receiver IDs.
3.
Tero Action: Receives notification (202 Accepted). Admin reviews. If approved, Tero updates its internal records/metadata associated with the externalized VCU (e.g., noting the last known internal movement via the reporting marketplace), potentially updating the original operational NFT's metadata (set token URI). Sends confirmation/rejection [Webhook].
Internal Retirement:
1.
Marketplace Action: A user requests to retire VCUs purchased on the Marketplace. The Marketplace executes this retirement within its system (e.g., burns its internal token representation, records the retirement details).
2.
Notification to Tero: The Marketplace calls reportTransaction with operation: Retire, detailing the quantity, units (tCO2e or kgCO2e), source issuance, retirement reason/beneficiary.
3.
Tero Action: Receives notification (202 Accepted). Admin reviews. If approved, Tero:
Updates the status of the corresponding native VCU in its registry to "Retired".
May update the original operational NFT's metadata (set token URI).
Reports the retirement to CAD Trust.
Sends confirmation/rejection [Webhook].
Modified at 2025-04-29 12:12:50
Previous
2. Listing VCUs on the Marketplace (User Journey)
Next
4. Returning VCUs to Tero Carbon (Detokenization/Retokenization)
Built with