# ePayDo

> ePayDo is a crypto payment gateway that accepts TRX and USDT (TRC-20) on the TRON network. Merchants integrate a single JSON API, a hosted checkout page, or a drop-in widget.

ePayDo exposes a REST API under `https://epaydo.com/api/v1/`. Authentication is per-request HMAC-SHA256 (no OAuth / no cookies). All monetary amounts are decimal strings to preserve precision; all timestamps are ISO 8601 UTC.

## Docs

- [Full API Reference (single-file markdown)](https://epaydo.com/llms-full.txt): Every endpoint, request, response, error code, and webhook payload in one file. Preferred context for LLMs.
- [OpenAPI 3.1 Spec (JSON)](https://epaydo.com/openapi.json): Machine-readable schema for SDK codegen and MCP tool generation.
- [OpenAPI 3.1 Spec (YAML)](https://epaydo.com/openapi.yaml): Same spec, YAML encoding.
- [Postman Collection](https://epaydo.com/postman.json): Import-ready Postman/Insomnia collection with example requests.

## Packages

- [@epaydo/mcp](https://www.npmjs.com/package/@epaydo/mcp): Model Context Protocol server. Lets Claude Desktop / Cursor / Windsurf call ePayDo tools directly. `npx @epaydo/mcp`.
- [@epaydo/node](https://www.npmjs.com/package/@epaydo/node): Official Node.js / TypeScript SDK. `npm install @epaydo/node`.
- [epaydo/php](https://packagist.org/packages/epaydo/php): Official PHP SDK (Composer). `composer require epaydo/php`.

## Core concepts

- [Authentication & HMAC signing](https://epaydo.com/docs#auth): How to sign every request.
- [Payment lifecycle](https://epaydo.com/docs#payments): Pending → confirming → completed/expired/failed.
- [Webhooks & signature verification](https://epaydo.com/docs#webhooks): HMAC format, retry schedule, idempotency.
- [Test mode](https://epaydo.com/docs#testing): `pk_test_*` keys, simulate-complete endpoint, test payments never touch real balances.

## Optional

- [Widget (drop-in checkout)](https://epaydo.com/widget.js): One-line JS embed.
- [Merchant dashboard](https://epaydo.com/dashboard): Live payments, payouts, analytics.
- [Status page](https://epaydo.com/status): Uptime and incident history.