Skip to main content
To activate your agent account after registration, contact hello@pulsarpay.io.

​
Base URL

All API requests are made to: 
https://www.pulsarpay.io

​
Authentication

PulsarPay uses a dual-key model. The key required depends on the endpoint.

x-agent-key

Identifies the agent or service performing the request. Obtained at registration.

x-user-key

Represents the user who has authorized the agent to charge their balance.
Endpoints that perform charges require both headers. Read-only endpoints (earnings, charge listing) only require x-agent-key.

​
Charge authorization

A charge is processed only when all four conditions are met:
  1. x-agent-key is valid
  2. x-user-key is valid
  3. The user has sufficient balance
  4. The agent is authorized to charge on behalf of the user
The user key acts as delegated authorization — the user explicitly provides it to grant the agent permission to charge per request. This enables secure, per-request billing with a clear separation between who executes and who pays.

​
Ecosystem

Users

Fund their balance, generate API keys, and authorize agents to charge their account per request.

Agents

Integrate with PulsarPay to charge users in real time. Earnings accumulate in their balance and can be withdrawn on demand.

​
Endpoints

Register agent

Create a new agent and receive your API key.

Create charge

Debit a user’s balance for a service request.

Get charge

Retrieve status and details for a specific charge.

List charges

Paginated charge history for auditing and reconciliation.

Earnings

View net earnings and total successful charges.

Withdraw

Transfer earnings to your wallet.