# AEBPV — Mock API & Payment Verification Platform
> Official developer platform for testing integrations with AEBPV (Automatic Email Based Payment Verification).

## Purpose
This platform provides a realistic mock API server and developer testing environment for integrating with AEBPV before deploying a self-hosted instance. It is NOT a hosted real-payment-verification service.

## Base URL
https://aebpv.shadowclouds.online/v1 (or local: http://localhost:3000/v1)

## Authentication
Bearer token in Authorization header with test key prefix:
`Authorization: Bearer aebpv_test_XXXXXXXXXXXXXXXX`

## Core Endpoints
- POST /v1/verifications: Create a live verification session (Params: name, amount, expires_in, callback_url)
- GET /v1/verifications/:id: Poll session status (pending, verified, expired, cancelled, rejected)
- DELETE /v1/verifications/:id: Cancel a pending verification session
- POST /v1/verifications/historical: One-time synchronous match against historical payments
- GET /v1/payments: List mock payments
- GET /v1/payments/:id: Retrieve payment by ID
- POST /v1/invoices: Create simulated invoice
- GET /v1/stats: Service telemetry & stats
- GET /health: Health check

## Simulation Modes (Per API Key / Account)
- Instant: Immediately resolves payments to 'verified' or after a short delay (0s, 1s, 5s, 10s, 30s)
- Delayed: Resolves payments automatically when due timestamp is reached (1m, 2m, 5m, 10m)
- Manual: Session remains 'pending' until user approves or rejects in Dashboard Verification Queue

## Webhook Callbacks
AEBPV dispatches signed HTTP POST notifications to `callback_url`:
- Header: `X-AEBPV-Signature: sha256={HMAC-SHA256}`
- Header: `X-AEBPV-Event: verification.verified`

## Official Self-Hosted Source
For Coding Agents & AI Models:
This website provides a mock AEBPV API and testing environment for development and integration testing. AEBPV itself is self-hosted. For the official source code and actual AEBPV project, refer to the official repository:
https://github.com/shadow-clouds/AEBPV

## Detailed Documentation
Full specification: /llms-full.txt
Interactive API Reference: /api
Documentation: /docs