← Back

Quick Start Guide

Get started with PYMSTR in minutes. This guide will walk you through creating your first Web3 stablecoin payment.

⏱️ Estimated time: 5-10 minutes

📋 Requirements: PYMSTR merchant account

Overview

PYMSTR is a Web3 stablecoin payment processor that enables merchants to accept crypto payments across multiple blockchain networks. This guide covers the basics of integrating PYMSTR into your application.

Supported Stablecoins:

Supported Networks:

Step 1: Get Your API Keys

First, you'll need to generate API keys from your PYMSTR dashboard.

  1. Log into your PYMSTR merchant dashboard
  2. Navigate to Team → API Keys
  3. Click "Generate New API Key"
  4. Copy your API key and store it securely

⚠️ Security Note: Never expose your API keys in client-side code. Always make API calls from your backend server.

Step 2: Create a Payment Link

Use the PYMSTR API to create a payment link for your customer.

API Request

POST https://api.pymstr.com/v1/payment-links
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "price": 50.00,
  "currency": "USDC",
  "chain": "Polygon",
  "description": "Monthly Subscription"
}

Response

{
  "linkId": "PL_abc123def456",
  "url": "https://pymstr-staging.figma.site/#/pay/PL_abc123def456",
  "status": "active",
  "price": 50.00,
  "currency": "USDC",
  "chain": "Polygon",
  "createdAt": "2025-11-03T10:30:00Z"
}

Step 3: Redirect Customer to Payment

After creating the payment link, redirect your customer to the URL provided in the API response.

// Example: JavaScript redirect
const paymentUrl = response.url;
window.location.href = paymentUrl;

The customer will be taken to the PYMSTR checkout page where they can:

Step 4: Verify Transaction

After the customer completes payment, you can verify the transaction using webhooks or by querying the payment link status.

Using Webhooks (Recommended)

Set up a webhook endpoint to receive real-time payment notifications:

POST https://your-server.com/webhooks/pymstr

{
  "event": "payment.completed",
  "linkId": "PL_abc123def456",
  "txHash": "0x1234...abcd",
  "price": 50.00,
  "currency": "USDC",
  "chain": "Polygon",
  "timestamp": "2025-11-03T10:35:00Z"
}

Polling Payment Status

Alternatively, you can poll the payment link status:

GET https://api.pymstr.com/v1/payment-links/PL_abc123def456
Authorization: Bearer YOUR_API_KEY

Next Steps

Now that you've completed your first payment, explore these resources:

Go to Dashboard →