PonponPay

SDK Documentation

Official PonponPay SDKs for multiple programming languages. Choose the SDK that fits your tech stack.

Available SDKs

Architecture Overview

PonponPay SDKs are designed with security in mind. The architecture separates server-side and client-side operations:

  • Server SDK: Handles API Key authentication, order creation, and webhook verification. Must run on your backend.
  • Browser SDK: Handles payment UI (redirect/modal) and status polling. No API Key required.

Quick Start

The typical integration flow:

  1. Install the SDK for your language
  2. Initialize the client with your API Key (server-side)
  3. Create a payment order
  4. Redirect user to the payment URL or open in modal
  5. Handle webhook notifications for payment confirmation

Error Handling

All SDKs throw specific exceptions for different error types:

Error TypeDescription
AuthenticationErrorInvalid API Key
ValidationErrorInvalid request parameters
NetworkErrorNetwork connection issues
ApiErrorAPI returned an error