API overview

All PPRO API endpoints support JSON payloads and follow standard HTTP methods (GET, POST, etc.) to enable smooth customer interactions. This section highlights key concepts to help you use our APIs effectively.

Common API functionality

API authentication

All requests to PPRO APIs require a Bearer Token.

EnvironmentPurposeHow to Obtain
SandboxTest integrationProvided when your sandbox account is created.
LiveAccess production APIsProvided when when integration is complete.

Tip: Include your Bearer Token in the Authorization header: Authorization: Bearer {YOUR_API_KEY}

For detailed instructions, see API Authentication.

Idempotency & tracing

Error representation

PPRO’s RESTful APIs return standard HTTP error codes:

Category HTTP Codes Description Client Errors 4xx Issues with the request (invalid data, unauthorized access, etc.) Server Errors 5xx Issues on PPRO’s side (service unavailable, internal errors, etc.)

All error responses include a standard error envelope with extra context to help debug the issue.

API rate limits

To maintain stable service for all customers, PPRO enforces request limits:

Environment Read Requests / sec Write Requests / sec Live 200 200 Sandbox 5 5

Note: Higher rate limits can be configured upon request for production environments.

For more details, see Rate Limiting Guide .