Skip to main content

Base URL

https://api-paygate.getaether.xyz

Authentication

All API requests require an API key in the X-API-Key header:
curl -X GET "https://api-paygate.getaether.xyz/public/products" \
  -H "X-API-Key: pk_your_api_key_here" \
  -H "Content-Type: application/json"
Get your API key from the PayGate Dashboard.

Endpoints Overview

Products

MethodEndpointDescription
GET/public/productsList all products
GET/public/products/:idGet product by ID

Access

MethodEndpointDescription
POST/public/access/checkCheck wallet access
GET/public/verify/:txHashVerify transaction

Features

MethodEndpointDescription
POST/public/feature/verifyVerify access token
GET/public/feature/tokensList access tokens
POST/public/feature/revokeRevoke access token

Stats

MethodEndpointDescription
GET/public/statsGet payment statistics

Response Format

Success Response

{
  "success": true,
  "data": { ... }
}

Error Response

{
  "success": false,
  "error": "Error message",
  "code": "ERROR_CODE"
}

Error Codes

CodeHTTP StatusDescription
INVALID_API_KEY401Invalid or missing API key
NOT_FOUND404Resource not found
VALIDATION_ERROR400Invalid request parameters
RATE_LIMITED429Too many requests
SERVER_ERROR500Internal server error

Rate Limits

TierRequests/minRequests/day
Free6010,000
Pro300100,000
Rate limit headers:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
X-RateLimit-Reset: 1704067260

SDKs

TypeScript/JavaScript

// Using fetch
const response = await fetch(
  'https://api-paygate.getaether.xyz/public/products',
  {
    headers: {
      'X-API-Key': process.env.PAYGATE_API_KEY,
      'Content-Type': 'application/json'
    }
  }
);

const data = await response.json();

Python

import requests

headers = {
    'X-API-Key': 'pk_your_api_key',
    'Content-Type': 'application/json'
}

response = requests.get(
    'https://api-paygate.getaether.xyz/public/products',
    headers=headers
)

data = response.json()

cURL

curl -X GET "https://api-paygate.getaether.xyz/public/products" \
  -H "X-API-Key: pk_your_api_key" \
  -H "Content-Type: application/json"