Developer Hub

Build with PayWall

Everything you need to integrate PayWall's payment processing into your applications. Start accepting payments in minutes with our developer-friendly APIs and SDKs.

Quick Start Guide

Get up and running with PayWall in just a few steps. Start processing payments in under 10 minutes.

1

Get API Keys

Sign up for a PayWall account and obtain your API keys from the dashboard.

PAYWALL_SECRET_KEY=sk_test_...
PAYWALL_PUBLIC_KEY=pk_test_...
2

Install SDK

Install the PayWall SDK for your preferred programming language.

npm install @paywall/node
# or
pip install paywall-python
3

Initialize Client

Initialize the PayWall client with your secret key.

const paywall = require('@paywall/node');
paywall.setApiKey(process.env.PAYWALL_SECRET_KEY);
4

Create Payment

Create your first payment and start accepting payments.

const payment = await paywall.payments.create({
  amount: 2000, // $20.00
  currency: 'usd',
  description: 'Test payment'
});

Official SDKs

Use our official SDKs to integrate PayWall into your applications quickly and securely.

🟢

Node.js

Official Node.js SDK with TypeScript support

npm install @paywall/node
View Documentation
🐍

Python

Official Python SDK with async support

pip install paywall-python
View Documentation
🐘

PHP

Official PHP SDK for Laravel and Symfony

composer require paywall/paywall-php
View Documentation
💎

Ruby

Official Ruby SDK with Rails integration

gem install paywall
View Documentation
⚛️

React

React components and hooks for web integration

npm install @paywall/react
View Documentation
📱

iOS

Native iOS SDK written in Swift

pod "PayWall"
View Documentation

Core API Endpoints

RESTful API endpoints for all your payment processing needs. All responses are JSON formatted.

POST/v1/payments

Create a new payment

{
  "amount": 2000,
  "currency": "usd",
  "description": "Product purchase"
}
GET/v1/payments/{id}

Retrieve payment details

GET https://api.paywall.app/v1/payments/pay_1234567890
POST/v1/refunds

Process a refund

{
  "payment_id": "pay_1234567890",
  "amount": 1000
}
GET/v1/webhooks

List webhook endpoints

GET https://api.paywall.app/v1/webhooks

Developer Resources

Comprehensive documentation, guides, and tools to help you build with PayWall.

API Reference

Complete API documentation with examples and response schemas.

Learn More

Developer Guides

Step-by-step tutorials and implementation guides.

Learn More

Code Examples

Ready-to-use code samples in multiple languages.

Learn More

Webhooks

Real-time event notifications for payment status updates.

Learn More

Testing

Test your integration with our sandbox environment.

Learn More

Support

Get help from our developer support team.

Learn More

Developer Tools

Testing tools and utilities to streamline your development workflow.

CLI Tool

Command-line interface for managing your PayWall account and testing.

npm install -g @paywall/cli
View CLI Docs

Sandbox Environment

Test your integration safely with our comprehensive sandbox.

  • Test card numbers
  • Webhook testing
  • Error simulation
Start Testing

Webhook Inspector

Debug and inspect webhook payloads in real-time.

  • Real-time monitoring
  • Payload validation
  • Retry failed events
Open Inspector

Need Developer Support?

Our developer support team is here to help you integrate PayWall successfully.