Getting Started

Quick Start Guide

Accept your first payment in about 10 minutes. This guide walks you through everything step by step.

10 min readLast updated: January 2025

What you'll learn

  • How to create a ClapPay account
  • Where to find your API keys
  • How to accept your first payment
  • How to test payments before going live

1Create Your ClapPay Account

First, you need a ClapPay account. This is where you'll manage payments, see reports, and get your API keys.

  1. Go to clappay.com/signup
  2. Enter your email and create a password
  3. Verify your email address (check your inbox)
  4. Fill in your business details

Don't worry about having all your business documents ready. You can start testing right away and add documents later when you want to accept real payments.

2Get Your API Keys

API keys let your website or app talk to ClapPay. Think of them like passwords that prove who you are.

You'll have two types of keys:

  • Publishable key (starts with pk_) - Safe to use in your website's JavaScript code. Anyone can see this key.
  • Secret key (starts with sk_) - Keep this private! Only use it on your server. Never put it in JavaScript that runs in a browser.

Important: You'll see test keys and live keys. Start with test keys. Test keys let you practice without using real money.

Learn more about API keys →

3Install the SDK

An SDK is a set of tools that make it easier to use ClapPay. Pick the one that matches the programming language you're using:

JavaScript/Node.js

npm install @clappay/sdk

Python

pip install clappay

Flutter

flutter pub add clappay_sdk

iOS (Swift)

pod 'ClapPay'

See all SDKs and libraries →

4Create a Payment

Here's the basic flow to accept a payment:

  1. Your server creates a PaymentIntent - This tells ClapPay how much money you want to collect and what currency to use.
  2. Your website shows the payment form - We give you a ready-made form that securely collects card details.
  3. Customer enters their card - The card details go straight to ClapPay. You never touch the actual card numbers.
  4. Confirm the payment - ClapPay charges the card and tells you if it worked.

Example: Create a PaymentIntent (Node.js)

const clappay = require('@clappay/sdk')('sk_test_...');

const payment = await clappay.paymentIntents.create({
  amount: 2000,  // Amount in cents ($20.00)
  currency: 'usd',
  payment_method_types: ['card'],
});

// Send payment.client_secret to your frontend

5Test Your Integration

Before you accept real payments, test everything with our test card numbers:

Card NumberWhat It Does
4242 4242 4242 4242Payment succeeds
4000 0000 0000 9995Card declined (insufficient funds)
4000 0025 0000 3155Requires 3D Secure

Use any future expiry date, any 3-digit CVC, and any ZIP code.

Learn more about test mode →

6Go Live

When you're ready to accept real payments:

  1. Complete your business verification in the Dashboard
  2. Add your bank account for payouts
  3. Switch from test API keys to live API keys
  4. Set up webhooks to get notified about payments

Tip: Set up webhooks before going live. They tell your server when a payment succeeds, so you can fulfill orders automatically.

What's Next?