Skip to main content

​
About this API Reference

This section documents Star-Pay’s HTTP APIs: resources and endpoints, request and response examples, authentication requirements, error codes, and webhook verification. It’s focused on the technical integration details engineering teams need to implement payment flows such as creating transactions, handling callbacks, and querying transaction status. For merchant onboarding, sandbox setup, and Dashboard tasks, see the Get Started guide: Get Started

​
Authentication

Authentication requirements depend on the endpoint. Merchant-facing endpoints commonly require the x-api-secret header, while other endpoints in the OpenAPI specification may use Bearer authentication. Check each endpoint’s documentation for exact requirements. Example header (merchant API secret):
API base URLs
  • Sandbox: https://sandbox-api.starpayethiopia.com/v1/starpay-api/