Report Integration Partner
POST https://api.paysera.com/checkout-project/integration/v1/project/integrator-id
Tell Paysera which integration partner the calling project belongs to. Platforms that bring merchants to Paysera are registered once and receive an integration identifier; reporting it here attributes the project to you without the merchant having to select anything.
Authorization​
This endpoint requires an OAuth2 Bearer token. The project is taken from the token, so the call carries no project in its path. See the Authentication guide.
Request Body​
| Field | Type | Required | Description |
|---|---|---|---|
tpi_id | string | ✓ | Your integration identifier, issued when your platform was registered |
Response​
| Field | Type | Description |
|---|---|---|
project_id | string (UUID) | Project the integration partner was set on |
tpi_id | string | Integration partner now attributed to the project |
set_at | integer | Unix timestamp of the moment the current value was set |
Notes​
- Only an active registered identifier is accepted. Anything else — never registered, or registered and since suspended — answers
404, so the response cannot be used to probe the registry. - The last partner to report wins: a merchant that moves from one platform to another is re-attributed by the new one, which reports with the project credentials the merchant gave it.
- An attribution set by Paysera support is a lock. Reporting against it changes nothing and returns
409. - Reporting the identifier already on the project is a no-op and still answers
200. - Attribution carries no fees and no partner privileges. It exists so third-party integrations can be identified, supported and counted.
You can also pass tpi_id in the order metadata when you create an order — useful for projects that were connected before you started reporting here. That route only fills an attribution that is still empty; it never replaces one.
AUTHORIZATION: HTTP
REQUEST
Base URL
https://api.paysera.com
Body REQUIRED
{
"tpi_id": "hostinger"
}
RESPONSE
Integration partner set on the project
{
"project_id": "b7c3d4e5-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
"tpi_id": "hostinger",
"set_at": 1756900000
}