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.
| Environment | Purpose | How to Obtain |
|---|---|---|
| Sandbox | Test integration | Provided when your sandbox account is created. |
| Live | Access production APIs | Provided when when integration is complete. |
Tip: Include your Bearer Token in the
Authorizationheader: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 .