Quick Start Guide
Accept your first payment in about 10 minutes. This guide walks you through everything step by step.
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.
- Go to clappay.com/signup
- Enter your email and create a password
- Verify your email address (check your inbox)
- 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.
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/sdkPython
pip install clappayFlutter
flutter pub add clappay_sdkiOS (Swift)
pod 'ClapPay'4Create a Payment
Here's the basic flow to accept a payment:
- Your server creates a PaymentIntent - This tells ClapPay how much money you want to collect and what currency to use.
- Your website shows the payment form - We give you a ready-made form that securely collects card details.
- Customer enters their card - The card details go straight to ClapPay. You never touch the actual card numbers.
- 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 frontend5Test Your Integration
Before you accept real payments, test everything with our test card numbers:
| Card Number | What It Does |
|---|---|
| 4242 4242 4242 4242 | Payment succeeds |
| 4000 0000 0000 9995 | Card declined (insufficient funds) |
| 4000 0025 0000 3155 | Requires 3D Secure |
Use any future expiry date, any 3-digit CVC, and any ZIP code.
6Go Live
When you're ready to accept real payments:
- Complete your business verification in the Dashboard
- Add your bank account for payouts
- Switch from test API keys to live API keys
- 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.