Skip to main content

Base URL

https://api.plexospay.com

Authentication

All requests require a Bearer token:
Authorization: Bearer sk_test_YOUR_API_KEY

Response Format

Successful responses return the resource directly as JSON. Error responses use this format:
{
  "error": {
    "message": "Payment not found",
    "code": "NOT_FOUND"
  }
}

HTTP Status Codes

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

Pagination

List endpoints use cursor-based pagination:
GET /v1/payments?limit=20&starting_after=pi_abc123
ParameterDescription
limitMax items per page (1-100, default 20)
starting_afterID of the last item from the previous page
Responses include:
{
  "data": [...],
  "hasMore": true
}

Idempotency

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.