Getting Started

Overview

This guide helps you set up your Paypercut account, obtain API credentials, and perform your first test transaction.
You’ll learn how to:

• Create and verify your merchant account
• Generate API keys
• Test your first payment
• Set up webhooks for real-time updates

Create a Merchant Account

Before you can process payments, you need a Paypercut Merchant Account.

To activate payments:

• Log in to your Merchant Dashboard using your credentials
• Complete your business and financial details
• Submit the required verification documents
• Once verified, you can start accepting payments in live mode

Obtain API Keys

• Log in to your Merchant Dashboard
• Navigate to Developers → API Keys → Create New Key
• Choose the environment:
  • Sandbox Key – for testing
  • Production Key – for live payments (available after onboarding approval)

⚠️ Security Tip:
Keep your API keys secure and never expose production keys in client-side code.

Make Your First Test Payment

Once your sandbox keys are ready, you can create your first checkout session.

Example request (cURL):

curl https://api.paypercut.io/v1/checkouts \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SECRET_TOKEN" \
  -d '{
    "amount": 100,
    "currency": "EUR",
    "mode": "payment",
    "success_url": "https://merchant.example.com/success",
    "cancel_url": "https://merchant.example.com/cancel",
    "line_items": [
      {
        "name": "Product A",
        "quantity": 2,
        "unit_price": 100
      }
    ]
  }'

Example response:

{
  "id": "chk_01K755J9SY55CS04SQ3JX1NX36",
  "amount_total": 100,
  "currency": "EUR",
  "status": "pending",
  "url": "https://checkout.paypercut.io/session/01K755J9SY55CS04SQ3JX1NX36"
}

Redirect the customer to the url to complete the payment.

Set Up Webhooks

Webhooks allow your system to receive real-time notifications (e.g., payment succeeded, failed, or refunded). To configure webhooks:

• Go to Dashboard → Developers → Webhooks
• Add your endpoint URL (e.g., https://merchant.example.com/webhooks/payments)
• Copy and store your webhook signing secret
• Validate the signature header in every webhook event

You can also test webhook events in Sandbox Mode using the API or Dashboard simulator.

For detailed webhook payloads and validation examples, refer to the Webhook Reference.

Developer Resources

• API Reference – Complete endpoint documentation and schema definitions
• Integration Guide – Step-by-step setup for Hosted and Embedded Checkout
• Webhooks Guide – Learn to handle and verify webhook events
• Testing Guide – Use test cards, failure scenarios, and sandbox use cases

Ready to get started?
Log in to your Merchant Dashboard and begin your integration today!