Skip to main content

Getting Started

This guide will help you get started with implementing recurring billing using Paysera Checkout API.

Prerequisites​

Before you begin, make sure you understand if this solution fits your requirements:

  1. Review the Overview to understand what recurring billing is
  2. Understand the payment flow and technical requirements
  3. Determine if your business case matches the recurring billing model

Implementation Steps​

Step 1: Create Paysera Account​

If you don't have a Paysera account yet, you need to register first.

Register here: https://bank.paysera.com/en/registration

Note

Recurring billing is available only in the Production environment. There is no separate test environment.

Step 2: Create Checkout Project​

After creating your Paysera account, set up a Checkout project:

  1. Log in to your Paysera account
  2. Navigate to "Projects and Activities" → "My projects"
  3. Click "Create New Project"
  4. Fill in the required information:
    • Project name
    • Business description
    • Website URL
    • Service details
tip

You don't need to activate the project immediately. You can configure all settings first and activate it later.

Step 3: Contact Paysera for Recurring Billing Access​

Recurring billing requires special approval from Paysera support.

Contact Information:

What to include in your request:

  1. Your project ID
  2. Business description and service details
  3. Use case for recurring billing (how you plan to use it)
  4. Expected transaction volume
  5. Implementation description

Step 4: Receive API Credentials​

Upon approval, Paysera will provide you with authentication credentials:

  • business_id - Your business identifier
  • mac_id - MAC authentication ID
  • mac_key - Secret key for signing requests (keep confidential!)
  • mac_algorithm - Algorithm for MAC calculation (typically hmac-sha-256)
Security Warning

Never expose your mac_key in:

  • Client-side code
  • Public repositories
  • Log files
  • API responses

Always store it securely on your server using environment variables or secure configuration management.

Step 5: Enable Real Payments​

After successful testing and approval:

  1. Contact Paysera support again
  2. Request to enable real payment collection
  3. Confirm your implementation is working correctly
  4. Wait for final approval

Testing Your Integration​

During development:

  1. Use your production credentials
  2. Test with small amounts
  3. Verify callback handling
  4. Test error scenarios
  5. Ensure proper notification processing
Next Steps

After completing the setup:

  1. Review API Fundamentals to understand authentication and requests
  2. Learn about Payment Collection
  3. Implement Recurring Billing flow
  4. Check Examples for code samples
  5. Review available Libraries for easier integration

Support​

Need help with complex integrations?

Contact: tech_support@paysera.com

Common Issues​

Project Not Approved​

If your project isn't approved for recurring billing:

  • Verify all business information is complete
  • Provide detailed use case description
  • Ensure your business model is compatible
  • Contact support for clarification

Can't Find Project ID​

  1. Log in to Paysera account
  2. Go to "Projects and Activities" → "My projects"
  3. Click on your project
  4. Project ID is displayed in project details

Credentials Not Working​

If API credentials aren't working:

  1. Verify you're using the correct mac_id and mac_key received from Paysera
  2. Check that you're using HTTPS
  3. Ensure MAC signature is calculated correctly using the proper algorithm
  4. Verify your project has been approved for recurring billing
  5. Check that timestamp (ts) is current