Payment Indexing - EarnProof

Payment indexing turns Stellar payment operations into EarnProof payment records.

Flow

Worker authenticates.
Worker triggers payment sync.
Backend queries Horizon for incoming payments.
Backend normalizes operations.
Backend checks supported asset configuration.
Backend encrypts payment amounts with AES-256-GCM.
Backend upserts payments by operation ID.

Sync Endpoint

POST /api/v1/payments/sync
Authorization: Bearer <token>

Normalized Fields

Field	Description
`operationId`	Stellar operation ID
`stellarTransactionHash`	Transaction hash
`sourceAddress`	Sender address
`destinationAddress`	Worker wallet
`assetCode`	XLM or issued asset code
`assetIssuer`	Issuer for non-native assets
`occurredAt`	Operation timestamp

Exact payment amounts are stored as authenticated ciphertext using PAYMENT_ENCRYPTION_KEY. Legacy redacted: values can still be decoded for compatibility, but new synced payments use the enc:v1: format.

Classification

Workers can classify payments as:

income,
reimbursement,
personal transfer,
unknown,
excluded.

Only supported assets that are also classified as income should be used by income proof evaluators. User classification does not make an unsupported asset eligible.