Skip to main content
Star-Pay is a payment gateway designed for Ethiopian developers and businesses. It lets you create payment orders, verify transactions, and handle webhook callbacks — all through a simple REST API.

Quickstart

Make your first payment request in minutes.

API Reference

Full endpoint documentation with request and response schemas.

Authentication

Learn how to authenticate your API requests with your API secret.

Webhook Security

Verify callback signatures to secure your integration.

​
How it works

1

Get your API secret

Obtain your x-api-secret from the Star-Pay merchant dashboard. This key authenticates every API request you make.
2

Create a payment order

Call POST /trdp/order with the customer’s details and amount. Star-Pay returns an order_id and a payment_url for the customer.
3

Customer completes payment

The customer is redirected to the payment page where they complete the USSD Push transaction via their mobile money account.
4

Verify or receive callback

Poll POST /trdp/verify with the order_id to check payment status, or configure a callbackURL to receive an automatic webhook when the payment completes.

​
Key features

USSD Push payments

Accept payments via Ethiotelecom mobile money using USSD Push — no app required for customers.

Payment verification

Query the status of any order at any time using its unique order ID.

Webhook callbacks

Receive real-time payment notifications at your endpoint with HMAC-SHA256 signature verification.

Sandbox environment

Test your integration end-to-end with dedicated sandbox credentials and test phone numbers.

Build docs developers (and LLMs) love

Get started for freeTalk to us