Overview
Test phone numbers simulate mobile money accounts in the sandbox environment. When you include a test number as the customerPhoneNumber in a create order request, Star-Pay triggers a simulated payment flow instead of sending a real USSD Push to a customer’s device.
Available test numbers
| Network | Phone number |
|---|
| Ethiotelecom | 0900000000 |
Important notes
Test numbers only work in sandbox mode. Submitting them against the production API will not produce a simulated payment.
- Do not use real customer phone numbers in the sandbox.
- No real transactions are processed when using test numbers.
- The test number simulates a successful payment by default. Use the merchant dashboard to simulate failure scenarios.
How to use
Include the test number as customerPhoneNumber in your create order request body.
POST /trdp/order
Content-Type: application/json
x-api-secret: <your-test-api-secret>
{
"amount": 100,
"description": "Test order",
"currency": "ETB",
"customerName": "Test User",
"customerPhoneNumber": "0900000000",
"callbackURL": "https://example.com/callbacks/starpay",
"items": [
{
"productId": "6812220726f547936d6c1976",
"quantity": 1,
"item_name": "Test item",
"unit_price": 100
}
]
}
order_id and a payment_url you can use to simulate the payment in the sandbox dashboard.
{
"status": "success",
"message": "Order created successfully",
"data": {
"order_id": "5428255034",
"status": "PENDING",
"amount": 100,
"currency": "ETB",
"payment_url": "https://starpayqa.starpayethiopia.com/pay/5428255034"
}
}
callbackURL. See the sandbox environment page for the expected callback payload shape.