API Reference

Base URL

https://api.plexospay.com

All requests require a Bearer token:

Authorization: Bearer sk_test_YOUR_API_KEY

Successful responses return the resource directly as JSON. Error responses use this format:

{
  "error": {
    "message": "Payment not found",
    "code": "NOT_FOUND"
  }
}

Code	Description
`200`	Success
`204`	No content
`400`	Validation error
`401`	Invalid API key
`403`	Insufficient permissions
`404`	Resource not found
`409`	Conflict (duplicate, state error)
`429`	Rate limit exceeded
`500`	Server error

List endpoints use cursor-based pagination:

GET /v1/payments?limit=20&starting_after=pi_abc123

Parameter	Description
`limit`	Max items per page (1-100, default 20)
`starting_after`	ID of the last item from the previous page

Responses include:

{
  "data": [...],
  "hasMore": true
}

Payment and refund creation support idempotency:

POST /v1/payments
Idempotency-Key: unique-request-id-123

If you retry with the same key, you’ll get the original response.