Register Split Beneficiary

POST https://api.paysera.com/checkout-project/integration/v1/split-beneficiaries

Register a recipient that order splits can reference by id. The returned id is the beneficiary_id you pass in an order's splits[].

The integration surface accepts Paysera EVP accounts only — the account must already exist as a Paysera account and must not be the project owner's own account.

Authorization

This endpoint requires an OAuth2 Bearer token. The project is taken from the token, so you do not pass a project id. See the Authentication guide.

Request Body

Field	Type	Required	Description
account_number	string	✓	Recipient's Paysera EVP account (EVP followed by digits)
name	string	✓	Display name for the beneficiary

Notes

• A duplicate account for the project returns 409 conflict.
• If split beneficiaries aren't enabled, the account isn't a valid EVP account, or it belongs to the project owner, the API returns 422 unprocessable_entity with the reason in error_description.

See Split Payments for the full flow.

AUTHORIZATION: HTTP

REQUEST

Base URL

https://api.paysera.com

RESPONSE

Beneficiary registered

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "account_number": "EVP5210018145214",
  "name": "Marketplace Seller 42",
  "created_at": 1716200000
}