Checkout Integration Guide

This guide explains how to integrate the Paypercut Checkout API to securely accept payments with minimal PCI compliance requirements.
Whether you need a fast, ready-to-use checkout or a plug-and-play solution for your website or e-commerce platform, this guide covers every step.

By the end of this guide, you will be able to:

Obtain API credentials
Create and manage checkout sessions
Render a secure payment page for customers (hosted or embedded)
Handle webhooks and transaction notifications
Understand pricing and supported platforms

What is the Checkout API

The Checkout API enables merchants to accept payments through a secure Paypercut payment page that handles all sensitive information on PCI-compliant infrastructure. It provides a simple, flexible way to integrate payments without exposing your systems to card data.

Rendering Options

Paypercut Checkout supports two rendering modes, both using the same secure checkout session: Hosted Checkout – Redirect customers to the Paypercut-hosted payment page. Embedded Checkout – Display the same payment page securely within your website or app using an iframe.

Both modes are powered by the same Checkout API and share identical functionality, security, and PCI compliance level. You simply choose how to render the checkout experience to best fit your website design or user flow.

Key Features:

Secure payment processing on a PCI-compliant page
Multiple payment methods: credit/debit cards, digital wallets
Real-time notifications via webhooks

Note:
Custom branding for checkout pages is available upon request.

For full API details, see the Checkout API Documentation.

How Checkout Works

Create a checkout session via the API.
Render the payment page:
- Redirect: Redirect the customer to the checkout URL returned by the API.
- Embedded: Use the same checkout URL as the src of an <iframe> on your site.
Customer completes payment securely on the Paypercut page.
Receive real-time notifications via webhooks for transaction status.
Redirect customer back to your site after payment (success/cancel) via your success_url or cancel_url.

Integration Steps

1. Obtain API Credentials

Log in to your Merchant Dashboard.
Go to API Keys and create new keys for sandbox (testing) and production (live).

2. Create a Checkout Session

Send a POST request to /v1/checkouts with required parameters.

Example request:

{
  "amount": 1000,
  "currency": "EUR",
  "success_url": "https://yourdomain.com/checkout/success",
  "cancel_url": "https://yourdomain.com/checkout/cancel",
  "line_items": [
    { "name": "Product", "amount": 1000, "quantity": 1 }
  ]
}

The response will include a checkout URL.

3. Render the Checkout

Redirect:
Redirect the customer to the checkout URL.

Embedded:
Place an <iframe src="checkout_url"> on your checkout page.

<iframe src="https://checkout.paypercut.io/session/abc123" width="400" height="600" frameborder="0"></iframe>

4. Handle Webhooks

Configure a webhook endpoint in your dashboard to receive payment status updates.
See Webhooks Guide for payloads and validation.

Use Cases

Merchant Type	Scenario	Benefit
Online Store	Accepting payments for products	Fast checkout, PCI-light, easy integration
SaaS Platform	Subscription or one-time payments	Seamless user experience, recurring billing
Event Organizer	Selling tickets online	Streamlined sales, instant confirmation
Utility Provider	Online bill payments	Convenient for customers, reduces manual processing
Membership Club	Collecting membership fees	Easy renewal and signup, supports recurring payments

Test Payments & Error Handling

Use sandbox API keys and test cards to simulate payment flows.
For test scenarios and error codes, see API Reference.

Supported Platforms

WooCommerce
PrestaShop
Custom integrations via API

Fees

Transaction fee per successful payment
No setup or monthly fees
Currency conversion fees may apply

Support & Resources

Ready to get started?
Log in to your Merchant Dashboard and create your first checkout session!