Download the PHP package ponponpay/php-sdk without Composer

PolyPay PHP SDK

Accept cryptocurrency payments (USDT, USDC, etc.) on any PHP website via PolyPay.

中文

Features

• 🔑 Simple Setup — Just provide your API Key
• 🌐 Framework Agnostic — Works with any PHP project (Laravel, WordPress, custom, etc.)
• 📦 Zero Dependencies — Pure PHP with cURL, no external packages required
• 🔒 Webhook Verification — Built-in HMAC-SHA256 signature validation with replay protection
• 🤖 Agent Payments — x402 helper for API/resource payments by agents
• 💰 Multi-Currency — Support USDT, USDC on Tron, Ethereum, BSC, Polygon, Solana

Requirements

• PHP >= 7.4
• ext-curl
• ext-json

Installation

Via Composer (Recommended)

Manual Installation

Download the SDK and include the autoloader:

Quick Start

1. Initialize

Sandbox Testing

Use a sandbox API key that starts with sk_sandbox_ to create sandbox orders:

The API base URL stays the same. PolyPay separates production and sandbox data by the API key environment. Sandbox orders use SB... trade IDs and virtual payment addresses, and you can simulate payment states from the merchant dashboard.

2. Redirect to Hosted Checkout with API Key Mode

PolyPay returns a signed hosted checkout URL such as:

PolyPay displays the payment method selection page. If your site already has a confirmed payment method, pass currency and network to skip selection and go directly to the payment page:

Use PolyPay::buildCheckoutUrl() only when you already manage Public Key hosted checkout parameters yourself:

3. Create an Order with API Key Mode

For normal merchant checkout, prefer hosted checkout so PolyPay owns payment method selection.

4. Query Order

5. Handle Webhook Callback

6. Protect an API with x402 Agent Payments

API Reference

PolyPay Class

x402 Resource Options

x402 verification binds the payment to resource and method. If your application is behind a proxy, pass the canonical public URL to verifyAndSettle($headers, $method, $url) so it matches the URL advertised in the 402 requirement.

Supported standard x402 networks:

Only standard EVM exact payments with Circle USDC transferWithAuthorization are supported. BSC, Tron, Solana, TON, and BTC are not part of this standard exact flow.

createOrder Parameters

Order Model Properties

Webhook Callback Status Codes

Configuration Options

Custom Nonce Storage

By default, the webhook handler uses file-based nonce storage. For high-traffic scenarios, implement NonceStorageInterface with Redis:

Error Handling

Examples

See the examples/ directory for complete, runnable examples:

• create_order.php — Create a payment order
• query_order.php — Query order status
• webhook.php — Handle payment callback
• payment_methods.php — List available methods
• hosted_checkout.php — Redirect to hosted checkout
• payment_page.php — Hosted checkout redirect example

License

MIT License. See LICENSE for details.

安装

通过 Composer（推荐）

手动安装

下载 SDK 并引入自动加载文件：

快速开始

更多示例请参考 examples/ 目录。