}

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	✓
`description`	string	✓	Payment description shown to the customer
`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

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": 999,
    "currency": "EUR"
  },
  "description": "Monthly subscription - First payment",
  "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": 999,
    "currency": "EUR"
  },
  "description": "Monthly subscription",
  "created_at": "2025-12-15T10:30:00Z"
}

AUTHORIZATION: HTTP

REQUEST

Base URL

https://checkout-eu-a.paysera.com

Body REQUIRED

{
  "business_id": "Opb2XVb-gEh4aGcR09Ko5Wb8V_6vueDM",
  "order_id": "SUB_12345",
  "price": {
    "amount": 999,
    "currency": "EUR"
  },
  "description": "Monthly subscription - First payment",
  "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

Payment request created successfully

{
  "id": "abc123payment",
  "status": "new",
  "authorization_url": "https://checkout-eu-a.paysera.com/pay/abc123payment",
  "order_id": "SUB_12345",
  "price": {
    "amount": 999,
    "currency": "EUR"
  },
  "description": "Monthly subscription",
  "created_at": "2025-12-15T10:30:00Z"
}

Authorization​

Request Body​

Example​

Request​

Response​