Sandbox Environment

Sandbox Env

A dedicated testing environment for configuring sandbox API requests, selecting prepared test scenarios, and generating valid request payloads for AfroPays APIs.

View Recent Transactions

Request Builder

Sandbox request builder

Configure only the editable values. Fixed fields stay preset, and merchant order id can be manual or auto-generated.

Sandbox API key

Sandbox API key is required.

API endpoint

Hosted checkout for Multi-provider.

Amount

Merchant order id

Use a unique value for each payment simulation.

ManualAuto

Auto mode prepares a fresh merchant order id and rotates it automatically after each send.

Callback URL

Active endpoint

Endpoint and expected scenario

The selected route and the outcome tied to the prepared phone number.

POST/api/v1/Transaction/CreateTransaction

Expected scenario

Success251999999999

This number returns a successful sandbox payment result.

Prepared test phones

Pick one prepared number. The available set changes with the endpoint family.

Live request preview

Generated JSON and cURL output from the current sandbox configuration.

Complete required fields first

API key, phone number, callback URL, API endpoint, amount, and generated order id must all be present and valid before you can send a request.

{
  "description": "Checkout API sandbox simulation",
  "imageUrl": "https://merchant.sandbox.afropays.co/assets/test-logo.png",
  "amount": 1,
  "currency": "ETB",
  "phone": "251999999999",
  "MerchantOrderId": "AFSBX-1775133681446-220",
  "cancelRedirectUrl": "https://merchant.sandbox.afropays.co/testing/cancel",
  "callbackUrl": "https://yourapp.com/payment/callback",
  "failedRedirectUrl": "https://merchant.sandbox.afropays.co/testing/failed",
  "complitedUrl": "https://merchant.sandbox.afropays.co/testing/success",
  "order": {
    "items": [
      {
        "itemName": "Sandbox Test Item",
        "price": 1,
        "quantity": 1
      }
    ]
  }
}

Response

Inspect the latest response returned by the sandbox API for the current request.

HTTP statusNot sent yet

{
  "message": "Send a sandbox request to inspect the live response here."
}

Recent transactions

Load the latest sandbox transactions for the API key currently entered above.

No recent transactions

No sandbox transactions were returned for the current API key yet.

Search routes