# GenesisPay API

**Canonical:** https://apis.io/apis/genesispay-finance/genesispay-finance-api/  
**Provider:** GenesisPay — https://apis.io/providers/genesispay-finance/  
**Documentation:** https://genesispay.finance/docs/api

GenesisPay API is published by [GenesisPay](https://apis.io/providers/genesispay-finance/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

GenesisPay API as documented publicly: 53 operations. Contract generated from the documentation by API Evangelist (2026-11-09); not the provider's own document.

## Operations (53)

| Method | Path | Summary |
|---|---|---|
| GET | `/{publicid}` | GET lists invoices, GET /:publicId retrieves one. |
| PATCH | `/{publicid}` | PATCH /:publicId replaces a draft. |
| GET | `/api/v1/agent/account` | Read the account, policy, and spend totals. |
| POST | `/api/v1/agent/pay` | Legacy agent payment API; idempotencyKey required. |
| GET | `/api/v1/agent/payments/{id}` | Poll a payment's status. |
| POST | `/api/v1/agent/payments/{id}/execute` | Execute an approved payment. |
| GET | `/api/v1/checkout-documents` | List immutable documents generated by hosted human checkout. |
| GET | `/api/v1/checkout-documents/{publicid}` | Retrieve one seller‑owned hosted checkout document. |
| GET | `/api/v1/checkout-documents/{publicid}/pdf` | Download the immutable checkout document as a verified PDF. |
| POST | `/api/v1/checkout/reconcile-submitted` | Internal receipt-only recovery of submitted payments. |
| GET | `/api/v1/customers` | List active customers. |
| POST | `/api/v1/customers` | Create a reusable invoice customer. |
| GET | `/api/v1/discovery` | Discovery (public) |
| GET | `/api/v1/discovery/shops` | Discovery (public) – List the listed shops in the public directory. |
| GET | `/api/v1/discovery/trending` | Discovery (public) – What is trending: listed products ranked by distinct buyers of paid orders in the last 7 days. |
| POST | `/api/v1/facilitator/settle` | Settle a signed x402 payment on-chain. |
| GET | `/api/v1/fulfillment/attempts` | Discover confirmed attempts for recovery; this is not payment authority. |
| POST | `/api/v1/fulfillment/verify` | Verify immutable seller-scoped payment authority. |
| GET | `/api/v1/invoices` | List your invoices (newest 100 full invoice responses). |
| POST | `/api/v1/invoices` | Create an editable invoice draft. |
| GET | `/api/v1/invoices/{publicid}` | Read full invoice detail. |
| POST | `/api/v1/invoices/{publicid}/finalize` | Freeze a draft and open it for payment. |
| POST | `/api/v1/invoices/{publicid}/send` | Email a finalized invoice and its PDF. |
| POST | `/api/v1/invoices/{publicid}/void` | Stop collecting an unpaid invoice. |
| GET | `/api/v1/kyb/purge-expired` | Internal retention routes – GET reports the due count. |
| POST | `/api/v1/kyb/purge-expired` | Internal retention routes – POST runs the five-year KYB cleanup. |
| GET | `/api/v1/links` | List your links with payment counts. |
| POST | `/api/v1/links` | Create a single-use payment request. |
| GET | `/api/v1/links/{publicid}` | Link detail including payment attempts. |
| POST | `/api/v1/links/{publicid}/simulate-payment` | Test the whole leg with simulated payment. |
| GET | `/api/v1/mandates` | List your mandates, newest first. |
| GET | `/api/v1/mandates/{id}/charges/{chargeid}` | Check confirmation of a mandate charge. |
| POST | `/api/v1/mandates/{id}/charges/propose` | Propose a charge for a mandate. |
| GET | `/api/v1/plans` | List your plans. |
| POST | `/api/v1/plans` | Create a subscription plan. |
| GET | `/api/v1/plans/{publicid}` | Read one plan. |
| POST | `/api/v1/plans/{publicid}/archive` | Archive a plan. |
| GET | `/api/v1/products` | List your products. |
| POST | `/api/v1/products` | Create a catalogue product. |
| PATCH | `/api/v1/products/{publicid}` | Set or clear the fulfilment URL. |
| POST | `/api/v1/products/{publicid}/archive` | Archive a product. |
| POST | `/api/v1/products/{publicid}/checkouts` | Create one strict product-backed single-use payment link. |
| GET | `/api/v1/products/{publicid}/contract` | Read the current strict product contract for readiness checks. |
| POST | `/api/v1/products/{publicid}/payment-link` | Mint the product's canonical payment link. |
| POST | `/api/v1/webhooks/reconcile-fulfillment` | Internal recovery of confirmed-payment notifications and URL entitlements. |
| POST | `/api/v1/webhooks/run-deliveries` | Internal durable outbox publication and delivery tick. |
| POST | `/api/v2/agent/pay` | Pay or recover one saved agent purchase. |
| POST | `/archive` | Remove a customer from future lists without changing finalized invoice snapshots. |
| POST | `/mark-uncollectible` | Accounting write‑off sibling of invoice void. |
| GET | `/pay/{linkid}` | The payment endpoint itself – Every link is payable directly over HTTP without any GenesisPay key. |
| GET | `/pay/p/{productpublicid}` | The permanent product checkout URL (public — no key). |
| GET | `/v1/openapi.json` | The index service publishes its complete contract at GET /v1/openapi.json. |
| GET | `/v1/stores/{host}` | Merchant reputation in the index API – GET /v1/stores/:host adds merchantReviews. |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/genesispay-finance/openapi/_ae-authored/genesispay-finance-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/genesispay-finance/json-schema/genesispay-finance-post-api-v1-links-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/genesispay-finance/json-schema/genesispay-finance-post-api-v1-invoices-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/genesispay-finance/json-schema/genesispay-finance-post-api-v1-plans-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/genesispay-finance/json-schema/genesispay-finance-get-api-v1-agent-account-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/genesispay-finance/json-schema/genesispay-finance-post-api-v1-facilitator-settle-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/genesispay-finance/json-schema/genesispay-finance-post-api-v1-mandates-id-charges-propose-request-schema.json
- **APIsJSON** — https://artifacts.apis.io/genesispay-finance/apis.yml

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/genesispay-finance/genesispay-finance-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/genesispay-finance/.
