> ## 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.

# Test Numbers

> Use these test phone numbers to simulate transactions in the Star-Pay sandbox environment.

## Overview

Use the following **test phone numbers** when testing the **Star-Pay API** in sandbox mode.

***

## 📱 Test Phone Numbers

<table className="w-full border rounded-lg overflow-hidden">
  <thead>
    <tr className="bg-muted/50 border-b">
      <th className="text-left p-3 w-[300px]">Ethiotelecom</th>
      <th className="text-left p-3 w-[300px]">Safaricom</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td className="p-3">
        <div className="flex items-center justify-between">
          <span className="font-mono text-xl">0900000000</span>

          <CopyButton value="0900000000" />
        </div>
      </td>

      <td className="p-3 text-muted-foreground">
        —
      </td>
    </tr>
  </tbody>
</table>

***

## Sandbox Payment Behavior

In the StarPay sandbox environment, only **USSD Push** payments are simulated. This allows developers to test the complete payment flow without requiring access to real payment networks or customer accounts.

When using the sandbox test phone numbers, the payment is processed automatically by the sandbox system. No USSD prompt will be sent to the device, and no user action is required to complete the payment. The transaction will automatically transition to a successful payment status, allowing you to test your integration, callbacks, redirects, and payment status handling.

Although the sandbox environment simulates only the USSD Push payment method, the integration flow is the same for all StarPay payment methods available in production, including:

* USSD Push
* Pay by OTP
* Card Payments (MPGS)
* Other supported payment methods

Once your integration works successfully in the sandbox environment, no additional integration changes are required when moving to production. The same API endpoints, request formats, callback handling, and status verification processes apply to all payment methods.

> **Note:** Sandbox payments are simulated for testing purposes only. No real funds are transferred, and no payment requests are sent to actual customer devices.

***

## ⚠️ Important Notes

* Works **only in sandbox mode**
* Do **not** use real customer numbers
* No real transactions are processed