Keep your API key secure. Never share it in public repositories or client-side code.

EnvironmentBase URL
Productionhttps://agent.payman.ai/api

​
Authentication

All API requests require authentication using the x-payman-api-secret header. Get your Access key from the Payman Dashboard.

x-payman-api-secret: YWd0LTFm...

​
Quick Start

curl https://agent.payman.ai/api/payments/send-payment \
  -H "x-payman-api-secret: YWd0LTFm..." \
  -H "Accept: application/vnd.payman.v1+json" \
  -H "Content-Type: application/json" \
  -d '{
    "payeeId": "pd-1f001934-7abc",
    "amountDecimal": 50.00,
    "memo": "Service payment"
  }'

​
Response Format

All responses use standard HTTP status codes and return JSON in the following format:

{
	"status": 200,
	"data": {
		// Response data specific to each endpoint
	}
}

​
Core Endpoints

Send Payment

Send funds to payees

Create Payee

Add payees

Search Payees

Find existing payees

Check Balance

View available funds