Projects are used to organize and track incoming payments within an Operation Company (Opco). Every project has to be linked to an Opco, and every payment is linked to both a project and a user — so you always know which payment belongs to which project and who made it.
For example, if you have 3 projects under the same Opco, each incoming payment is attributed to the specific project and user it belongs to, giving you full visibility over your payment activity.
Use these endpoints to create and manage projects. All endpoints use the /api/v1/projects base path.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
POST | /api/v1/projects/create | Create a new project linked to an operation company |
GET | /api/v1/projects | List all projects for the current client |
GET | /api/v1/projects/{project_id} | Retrieve details of a specific project |
PUT | /api/v1/projects/{project_id} | Update a project's configuration (name, callback URLs, settings) |
Key Concepts
- Project ↔ Opco — Each project is associated with an active operation company (Sub-TPP). The Opco must be in active status before a project can be created under it.
- Freeze control — Projects can be frozen to temporarily disable payment processing. Freeze status changes trigger the
project.frozen_changedwebhook event. - Callback URLs — Each project defines its own
payment_return_urlfor redirecting users after checkout completion.
Required roles
OWNER or OPERATIONS — DEVELOPER role cannot manage projects. See Roles and Permissions.
Related guides
- Core Concepts — How projects organize payments under OpCos
- Getting Started — Create your first project
- Error Reference — Project-related errors