Build with PortalPay

Trustless, permissionless payment infrastructure for accepting cryptocurrency payments with automatic payment splitting.

Quick Start Guide API Reference

Why Build with PortalPay?

Trustless & Permissionless

No intermediaries, no gatekeeping. Direct blockchain transactions with full transparency.

Subscription-Based Auth

Secure APIM subscription keys linked to your wallet. Manage keys through the developer dashboard.

Automatic Splitting

Configure payment distribution via smart contracts. All splits happen on-chain.

Documentation

Start Here

Quick Start Guide

Get up and running in 5 minutes. Make your first API call and accept your first payment.

• Configure split contract
• Create your first product
• Generate orders
• Accept payments

Authentication & Security

Learn how APIM subscription authentication works and critical security practices.

• APIM subscription keys
• Security best practices
• Gateway architecture
• Incident response

API Reference

Complete reference for all PortalPay API endpoints with examples.

• Split Contract APIs
• Inventory Management
• Order Generation
• Receipt APIs

Code Examples

Ready-to-use code examples in multiple languages for common workflows.

• JavaScript/TypeScript
• Python
• cURL commands
• Complete integrations

Quick Example

Create Your First OrdercURL

# 1. Create a product
curl -X POST https://pay.ledger1.ai/api/inventory \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: $APIM_SUBSCRIPTION_KEY" \
  -d '{
    "sku": "ITEM-001",
    "name": "Sample Product",
    "priceUsd": 25.00,
    "stockQty": 100,
    "taxable": true
  }'

# 2. Generate an order
curl -X POST https://pay.ledger1.ai/api/orders \
  -H "Content-Type: application/json" \
  -H "Ocp-Apim-Subscription-Key: $APIM_SUBSCRIPTION_KEY" \
  -d '{
    "items": [{"sku": "ITEM-001", "qty": 1}],
    "jurisdictionCode": "US-CA"
  }'

# 3. Payment URL
# https://pay.ledger1.ai/pay/{receiptId}