API Overview

The Plirin API is a GraphQL API that lets you programmatically manage payments, invoices, products, customers, and more.

Endpoint

All API requests go to a single GraphQL endpoint:

POST https://api.plirin.com/graphql

Request format

Send GraphQL queries as JSON POST requests:

{
  "query": "query { me { email businessName } }",
  "variables": {}
}

Required headers

Header	Value	Description
Content-Type	application/json	Always required
Authorization	Bearer <access_token>	Required for authenticated endpoints

Rate limiting

API requests are rate-limited to protect service stability. Current limits:

• 100 requests per minute per merchant
• Rate-limited responses return HTTP 429 Too Many Requests

Tip

Use the Authorization header with a valid JWT token for all authenticated operations. See Authentication for how to obtain tokens.

SDKs Official TypeScript and Python client libraries.

Authentication Obtain and refresh access tokens.

GraphQL Schema Types, queries, and mutations reference.

Webhook Events Receive real-time event notifications.

Error Codes Standard error codes and handling.