Network status: In development · No public token sale is currently active · View status
Developer Guide
eCoin Protocol · v0.1 Draft

Payment Processing

A payment integration must distinguish a payment request from a submitted transaction and a submitted transaction from a finalized payment.

Docs · Payment Processing
Protocol status: Draft architecture. eCoin is under development. These pages describe the Version 0.1 design direction and illustrative developer models, not a finalized wire protocol, production API, or live mainnet.

Merchant payment flow

  1. Create an order in the merchant system.
  2. Present the amount and a validated eCoin destination or payment request.
  3. Observe the submitted transaction through a trusted or independently verified network source.
  4. Match the transaction to the order.
  5. Wait for the protocol-defined finality state required by the merchant’s risk policy.
  6. Mark the order paid and store the transaction reference for reconciliation.

Payment requests

A production payment-request format has not been defined. A future standard should be versioned and able to communicate destination, amount, network, expiration when applicable, order metadata that does not compromise privacy, and integrity protection.

Do not treat observation as settlement

Seeing a transaction propagated is not the same as finalized settlement. Payment processors should consume an explicit transaction state and define the business action associated with each state.

Refunds

The base design should assume finalized peer-to-peer transactions are not silently reversed by a merchant. A refund should normally be represented as a new authorized transaction back to a validated destination. The final protocol specification will determine exact behavior.

Reconciliation

Store an internal order identifier alongside the network transaction identifier in the merchant database, not inside sensitive public data unless the protocol explicitly provides a privacy-safe metadata mechanism. Reconciliation systems should be able to re-derive payment status from network records.