Build an Integration for Your Platform

If you build or maintain an e-commerce platform, a CMS, a marketplace, or a hosting product that lets your merchants accept payments through Paysera, you can register as a platform partner and receive an integration ID.

Checkout Modern only

Registration and the integration ID apply to Checkout Modern. If your integration runs on the legacy Paysera Checkout API, see Checkout Classic plugins and platforms.

Why Register

The integration ID marks every project and order that reaches Paysera through your platform. That gives you:

• Recognition in support. When one of your merchants opens a ticket, our support team can see the integration they came through and route the question without asking them to explain your product.
• One technical contact. You give us a support address for your merchants and a technical address for us. We use them instead of chasing individual merchants.
• Visibility of your footprint. We can tell how many projects and orders come through your platform, so your integration is a known quantity to us rather than a scattering of unrelated merchants.
• A ready onboarding link. You get a link that takes your merchants straight to project creation with your platform already selected.

Registration is about identification and support. The integration ID carries no fees, no pricing changes, and no special permissions – your merchants pay the standard published Paysera rates, and each of them contracts with Paysera directly.

How It Works

1. You submit the application form below.
2. Our support team reviews it and registers your platform.
3. You receive your integration ID and a create project link by email.
4. You pass the integration ID to us using one or more of the methods below.

Your integration ID is assigned by Paysera, is unique to your platform, and does not change. Treat it as a constant in your integration.

Passing Your Integration ID

You can use any of the three methods. They complement each other: the link covers merchants who start from your product, the project endpoint covers merchants who connected before you had the link in place, and the order parameter covers everything else.

Create Project Link

The simplest method. Point your merchants at the link we send you instead of at the Paysera website:

https://bank.paysera.com/shell/en/checkout/create?tpi_id=your-integration-id

Put it behind a Connect Paysera button in your admin panel or in your setup instructions. The merchant lands on project creation with your platform already selected and does not have to know or type anything.

Project Endpoint

If a merchant already created their project, report the integration from your server:

POST https://api.paysera.com/checkout-project/integration/v1/project/integrator-id
Authorization: Bearer <integration token>
Content-Type: application/json

{
  "tpi_id": "your-integration-id"
}

The project is taken from the project_id claim of your integration token, so the request carries no project in the path or the body. The last partner to report wins, which is what re-attributes a merchant who moves from one platform to another. A value set by our support team is a lock and is never overwritten here.

Order Parameter

You can also send the integration ID when you create an order, as a tpi_id key inside the order metadata:

POST https://api.paysera.com/merchant-order/integration/v1/orders
Authorization: Bearer <integration token>
Content-Type: application/json

{
  "purchase": {
    "reference": "ORDER-001",
    "amount": 1000,
    "currency": "EUR"
  },
  "metadata": {
    "platform": "your-platform",
    "tpi_id": "your-integration-id"
  }
}

Order metadata holds at most ten keys, and tpi_id takes one of them – leave room for it if you already fill the map. The identifier is optional, and an order is never rejected because of it: an unrecognised value is ignored and the order is created as usual.

What the Application Form Asks

Have these ready before you open the form:

• Platform name.
• Website.
• What your platform does and how it will use Paysera.
• Technical contact name (optional).
• Technical contact email – you can give several.
• Support contact for your merchants.
• Whether you are moving an existing Checkout Classic integration.
• Anything else you want us to know.

Apply

Open the application form

We reply to the technical contact address you give us with your integration ID and your create project link. Nothing about your platform is published anywhere.

While You Wait

Registration is not a gate. Everything in the Checkout Modern API works without an integration ID, so build and test your integration now and add the identifier once it arrives – the three methods above can all be fitted to a finished integration without reworking it.

If you are moving an existing Checkout Classic integration, say so on the form. Classic and Modern are separate APIs and the move is a rebuild rather than an upgrade, so we would rather walk you through it than have you find that out halfway.