Register Split Beneficiary by Phone

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

Register a tip recipient by the phone number of their Paysera individual account. The returned id is the beneficiary_id you pass in an order's splits[] as a tip entry.

The person must already have a Paysera individual account registered to that phone number. Available only on projects with payer tips enabled.

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
phone	string	✓	Phone number of the recipient's Paysera individual account, in international format (e.g. +37060000000)

Notes

• For Lithuanian merchants the returned account_number is null: the recipient's payout account is assigned later, when they give tax-agent consent. For other merchants the recipient's Paysera account is assigned immediately.
• Duplicates are detected by the Paysera user the phone number resolves to — a repeat registration returns 409 conflict.
• If payer tips aren't enabled, or no Paysera individual account is found for the phone number, 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",
  "name": "John D.",
  "account_number": null,
  "created_at": 1716200000
}