Create Payment Link

POST https://api.paysera.com/checkout-payment-link/integration/v1/payment-links

Creates a payment link for an existing order. The payment link provides a URL where customers can complete the payment process.

Authorization

This endpoint requires OAuth2 Bearer token authentication.

Authorization Header Format:

Authorization: Bearer YOUR_ACCESS_TOKEN

For more details, see the Authentication section.

Request Body

Field	Type	Required	Description
order_id	string (UUID)	✓	Reference ID for the associated order
name	string	✓	Descriptive name for the payment link (max 255 chars)
experience.language	string	✓	Language code for the payment link (ISO 639-1, e.g., en, lt)
experience.payment_flow	string		Payment flow type (default: paysera_checkout)
purchase.amount	integer	✓	Amount in minor currency units (e.g., cents)
lifetime	integer		Link validity in seconds (default: 259200 = 3 days, 0 = never expires)
payment_details.key	string		Preferred payment method key
payment_details.purpose	string		Payment purpose description (max 255 chars)
payment_details.country_code	string		Country code (ISO 3166-1 alpha-2) for filtering payment methods
payer_information.name	string		Payer name (max 150 chars)
payer_information.email	string		Payer email
metadata	object		Additional key-value metadata pairs

Amount Format

All amounts use minor currency units (e.g., cents for EUR). The amount "2500" represents €25.00.

Response

Field	Type	Description
link_id	string (UUID)	Unique payment link identifier
order_id	string (UUID)	Associated order ID
payment_URL	string	Payment URL - redirect customer here to complete payment
experience.language	string	Language of the payment link
experience.payment_flow	string	Payment flow type
payment_details.key	string	Payment method key
payment_details.purpose	string	Payment purpose
payment_details.country_code	string	Country code (ISO 3166-1 alpha-2)
purchase.amount	integer	Amount in minor currency units
payer_information.name	string	Payer name
payer_information.email	string	Payer email
expired_at	integer	Unix timestamp when link expires
created_at	integer	Unix timestamp of creation

Example

Request

POST https://api.paysera.com/checkout-payment-link/integration/v1/payment-links
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...

{
  "order_id": "a6f2b8e3-5e5f-47d9-b13f-87ed2db2938a",
  "name": "Order #12345",
  "experience": {
    "language": "en",
    "payment_flow": "paysera_checkout"
  },
  "purchase": {
    "amount": 2500
  },
  "lifetime": 3600,
  "payment_details": {
    "key": "credit_card",
    "purpose": "Order #12345 - Leather Wallet",
    "country_code": "LT"
  },
  "payer_information": {
    "name": "John Doe",
    "email": "john@example.com"
  }
}

Response

{
  "link_id": "c8d9e0f1-2a3b-4c5d-6e7f-8a9b0c1d2e3f",
  "order_id": "a6f2b8e3-5e5f-47d9-b13f-87ed2db2938a",
  "payment_URL": "https://api.paysera.com/checkout-payment-link/payment-collection/v1/payment-links/abc123def456GhiJkl_mNOpQrStUvWxYz0123456",
  "experience": {
    "language": "en",
    "payment_flow": "paysera_checkout"
  },
  "payment_details": {
    "key": "credit_card",
    "purpose": "Order #12345 - Leather Wallet",
    "country_code": "LT"
  },
  "purchase": {
    "amount": 2500
  },
  "payer_information": {
    "name": "John Doe",
    "email": "john@example.com"
  },
  "expired_at": 1736436870,
  "created_at": 1736433270
}

Pre-selecting Payment Method

To skip the payment method selection screen and redirect directly to a specific bank or payment provider:

{
  "order_id": "a6f2b8e3-5e5f-47d9-b13f-87ed2db2938a",
  "name": "Order #12345",
  "experience": {
    "language": "en"
  },
  "purchase": {
    "amount": 2500
  },
  "payment_details": {
    "key": "swedbank",
    "country_code": "LT"
  }
}

Use the Get Payment Methods endpoint to retrieve available method keys.

Next Steps

After creating a payment link:

1. Redirect the customer to the payment_URL
2. Set up webhook handling to receive payment notifications

AUTHORIZATION: HTTP

REQUEST

Base URL

https://api.paysera.com

RESPONSE

Payment link created successfully

{}