# API reference

Endpoint definitions published by the Veyqo API, shared with the dashboard console.

## Server API · /api/v1

Use your Veyqo secret key from a trusted server. These endpoint pages include every documented field, headers, query filters, request languages, success responses and endpoint-specific errors.

- [Create a payment](https://veyqo.org/docs/api-payments-create): POST /payments

- [List payments](https://veyqo.org/docs/api-payments-list): GET /payments

- [Retrieve a payment](https://veyqo.org/docs/api-payments-show): GET /payments/{id}

- [Verify a payment](https://veyqo.org/docs/api-payments-verify): POST /payments/{id}/verify

- [Refund a payment](https://veyqo.org/docs/api-refunds-create): POST /payments/{id}/refunds

- [Retrieve a refund](https://veyqo.org/docs/api-refunds-show): GET /refunds/{id}

- [List events](https://veyqo.org/docs/api-events-list): GET /events

- [Retrieve an event](https://veyqo.org/docs/api-events-show): GET /events/{id}

- [Create a checkout session](https://veyqo.org/docs/api-checkout-sessions-create): POST /checkout/sessions

- [Retrieve a checkout session](https://veyqo.org/docs/api-checkout-sessions-show): GET /checkout/sessions/{id}

- [List connected providers](https://veyqo.org/docs/api-providers-list): GET /providers

## Download the contract

The reference, OpenAPI document, Postman collection and AI-readable pages are generated from the same versioned integration contract. JSON examples are illustrative, not real transactions.

- [OpenAPI 3.1](/openapi.json): Import paths, scopes, schemas and examples into compatible API tools.

- [Postman collection](/postman.json): Configure your own environment values; leave secrets out of shared collections.

- [JSON reference](/api-reference.json): Complete endpoint and error metadata.

- [Browser checkout API](https://veyqo.org/docs/browser-checkout): Separate publishable-key and session-ID surface.

Download the complete OpenAPI contract at https://veyqo.org/openapi.json, JSON reference at https://veyqo.org/api-reference.json, or live definitions at https://api.veyqo.org/docs/reference.
