}
Create payment request
POST https://checkout-eu-a.paysera.com/checkout/rest/v1/payment-requests
Create a new payment request for initial or recurring payments.
accept_url, cancel_url, and callback_url are required by the API. For initial payments the customer is redirected to accept_url / cancel_url after completing payment on the Paysera page; for recurring (token-authorised) payments the customer is never redirected, but the fields are still required when creating the request.
After a successful initial payment, an issued_token will be available on the Payment Request resource and delivered in the notification at data.payment_request.issued_token. Use it for future recurring charges.
Authorization​
This endpoint requires MAC (Message Authentication Code) authentication.
Authorization Header Format:
Authorization: MAC id="CLIENT_ID", ts="TIMESTAMP", nonce="RANDOM_STRING", mac="MAC_HASH", ext="body_hash=BODY_HASH"
Example:
Authorization: MAC id="a9b8c7d6e5f4g3h2", ts="1234567890", nonce="xyz123abc456def", mac="dGhpcyBpcyBhIHJhbmRvbSBtYWMgaGFzaCB2YWx1ZQ==", ext="body_hash=cmFuZG9tQm9keUhhc2hWYWx1ZQ%3D%3D"
For more details, see the Authentication section.
Request Body​
| Field | Type | Required | Description |
|---|---|---|---|
business_id | string | ✓ | Your unique business identifier from Paysera |
order_id | string | ✓ | Unique order reference (must be unique for each payment) |
price | object | ✓ | amount is a decimal string in the currency's main unit, e.g. "9.99". A JSON number is rejected, and "999" means 999 EUR |
description | string | Payment description shown to the customer. Must contain [order_nr] and [site_name] or [owner_name], otherwise Paysera replaces it with its default text. See Description below | |
method_key | string | Preferred payment method (optional) | |
payer | object | ✓ | |
locale | string | Language preference for payment page | |
accept_url | string | ✓ | Success redirect URL (used after user-interaction payments) |
cancel_url | string | ✓ | Cancel redirect URL (used after user-interaction payments) |
callback_url | string | ✓ | Notification callback URL (must be HTTPS, publicly accessible) |
token_strategy | string | Token generation strategy - use "required" to obtain a token for recurring billing | |
parameters.refund_on_capture | boolean | With token_strategy: "required", issues a token and returns the amount to the payer automatically. See Obtaining a Token Without Charging the Customer |
Description​
The description is shown to the customer on the payment page. Paysera keeps your text only if it contains the placeholder [order_nr] and at least one of [site_name] or [owner_name]. Any other text, and an omitted field, is replaced with the default text Payment for order #[order_nr] at [site_name]. Placeholders must be written exactly as shown: lowercase, in square brackets, with no spaces inside the brackets. [ORDER_NR], [Order_Nr] or [order_nr ] is not recognised and your text is silently replaced with the default.
The placeholders are filled in when the payment request is created:
| Placeholder | Replaced with |
|---|---|
[order_nr] | Your order_id |
[site_name] | The website address from your project's contact information |
[owner_name] | Your business name |
The text you send can be at most 255 characters; longer values are rejected with an invalid_parameters error, not cut. The payment number (RC...) is then added to the start of the text automatically and the result is cut to 255 characters. The description returned by the API, in notifications and in the public payment information is this final text, not the text you sent.
sent: "Monthly subscription, order [order_nr], [site_name]"
returned: "RC12345678 Monthly subscription, order SUB_12345, https://yoursite.com"
sent: "Monthly subscription"
returned: "RC12345678 Payment for order #SUB_12345 at https://yoursite.com"
Example​
Request​
POST https://checkout-eu-a.paysera.com/checkout/rest/v1/payment-requests
Content-Type: application/json
Authorization: MAC id="CLIENT_ID", ts="TIMESTAMP", nonce="RANDOM_STRING", mac="MAC_HASH", ext="body_hash=BODY_HASH"
{
"business_id": "Opb2XVb-gEh4aGcR09Ko5Wb8V_6vueDM",
"order_id": "SUB_12345",
"price": {
"amount": "9.99",
"currency": "EUR"
},
"description": "Monthly subscription, order [order_nr], [site_name]",
"method_key": "card",
"payer": {
"email": "customer@example.com"
},
"locale": "en",
"accept_url": "https://yoursite.com/payment/success",
"cancel_url": "https://yoursite.com/payment/cancel",
"callback_url": "https://yoursite.com/payment/callback",
"token_strategy": "required"
}
Response​
{
"id": "abc123payment",
"status": "new",
"authorization_url": "https://checkout-eu-a.paysera.com/pay/abc123payment",
"order_id": "SUB_12345",
"price": {
"amount": "9.99",
"currency": "EUR"
},
"description": "RC12345678 Monthly subscription, order SUB_12345, https://yoursite.com",
"created_at": "2025-12-15T10:30:00Z"
}
AUTHORIZATION: HTTP
REQUEST
{
"business_id": "Opb2XVb-gEh4aGcR09Ko5Wb8V_6vueDM",
"order_id": "SUB_12345",
"price": {
"amount": "9.99",
"currency": "EUR"
},
"description": "Monthly subscription, order [order_nr], [site_name]",
"method_key": "card",
"payer": {
"email": "customer@example.com"
},
"locale": "en",
"accept_url": "https://yoursite.com/payment/success",
"cancel_url": "https://yoursite.com/payment/cancel",
"callback_url": "https://yoursite.com/payment/callback",
"token_strategy": "required"
}
RESPONSE
{
"id": "abc123payment",
"status": "new",
"authorization_url": "https://checkout-eu-a.paysera.com/pay/abc123payment",
"order_id": "SUB_12345",
"price": {
"amount": "9.99",
"currency": "EUR"
},
"description": "RC12345678 Monthly subscription, order SUB_12345, https://yoursite.com",
"created_at": "2025-12-15T10:30:00Z"
}