> ## Documentation Index
> Fetch the complete documentation index at: https://developer.starpayethiopia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> A comprehensive guide to integrating and operating the Star-Pay payment gateway within your systems.

## 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](../index)

## 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):

```http theme={null}
x-api-secret: X/2uxXAjJqaai5gRzXHzcFPcx9E6B3pibBbVSoce1U23q5hR2Sr5pxlh6WLQZBep
```

API base URLs

* Sandbox: `https://sandbox-api.starpayethiopia.com/v1/starpay-api/`