​
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.

​
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

​
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

Was this page helpful?