​
Overview

Digital vouchers enable households to receive benefits for verified emission reductions through a secure blockchain-based system. These vouchers (CARBON credit tokens) can be used to purchase approved products from authorized suppliers.
Digital vouchers are issued as CARBON credit tokens using the EIP1155 standard, with embedded attributes linking them to verified emission reduction certificates.
Hero Light

​
Key Actors

Household Beneficiaries

Receive and spend CARBON credit tokens for emission reductions

Suppliers

Accept vouchers and submit verifiable claims

Implementers

Manage emission reduction projects and ITMO conversions

Regulators

Monitor and approve mitigation activities

​
Voucher Lifecycle

​
1. Issuance

curl -X POST https://api.emerging.eco/v1/vouchers/issue \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "recipientDid": "did:ixo:household/123",
    "emissionCertificateId": "CERT-456",
    "value": 100.00,
    "attributes": {
      "batchId": "BATCH-789",
      "issuanceDate": "2024-03-15",
      "expiryDate": "2024-12-31"
    }
  }'

​
2. Redemption

curl -X POST https://api.emerging.eco/v1/vouchers/redeem \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "voucherId": "VCHR-123",
    "supplierDid": "did:ixo:supplier/456",
    "amount": 50.00,
    "productId": "PROD-789"
  }'

​
3. Claim Submission

curl -X POST https://api.emerging.eco/v1/claims \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "redemptionId": "REDM-123",
    "verifiableCredential": {
      "type": "ProductDeliveryCredential",
      "proof": "..."
    }
  }'

​
Token Conversion Flow

1

CARBON → USDC

Suppliers make claims to convert received CARBON tokens to USDC through the liquidity pool
2

USDC → Local Currency

Suppliers convert USDC to local currency via payment processors
3

USDC → CARBON

Implementers swap USDC for CARBON tokens through the liquidity pool
4

CARBON → ITMO

Implementers convert CARBON tokens to ITMO claims with on-chain transfer proofs
5

ITMO → Fiat

Implementers convert ITMO claims and transfer prooofs to ITMO Certificates through National Registy Implementers receive fiat payments for ITMO certificates through Mitigation Outcome Purchase Agreements (MOPA)
6

Fiat → USDC

Implementers convert fiat payments to USDC through a regulated exchange operator (Circle)

​
Validation Rules

  • Must have valid emission reduction certificate
  • Recipient must be registered household
  • Value must match verified reduction amount
  • Voucher must be active and non-expired
  • Supplier must be authorized
  • Amount must not exceed available balance
  • Product must be approved for scheme
  • Must include verifiable delivery proof
  • Must align with monitoring plan
  • Must be submitted within time limit

​
Response Format

{
  "id": "VCHR-123",
  "status": "active",
  "recipientDid": "did:ixo:household/123",
  "emissionCertificateId": "CERT-456",
  "value": 100.00,
  "remainingBalance": 50.00,
  "attributes": {
    "batchId": "BATCH-789",
    "issuanceDate": "2024-03-15",
    "expiryDate": "2024-12-31"
  }
}

​
Error Codes

​
400
error
Invalid parameters or validation failure
​
401
error
Unauthorized access or invalid credentials
​
403
error
Forbidden operation (e.g., unauthorized supplier)
​
404
error
Resource not found
​
409
error
Conflict with existing state

​
Security Considerations

Never expose API keys or private keys in client-side code. Always use secure server-side implementations for token conversions and claims processing.
  • All transactions are recorded on the Impact Hub blockchain
  • Multi-party controls govern the liquidity pool
  • Strong authentication required for supplier applications
  • Compliance with Article 6.2 ITMO regulations

​
Next Steps

Supplier Integration

Set up merchant integration

Monitoring Guide

Learn about verification and monitoring

API Reference

View complete API documentation