By the end of this guide, you’ll have created a sandbox payment using the Simiz API.

​
Prerequisites

1

Create your Simiz account

Sign up at simiz.io/register. You’ll get instant access to your dashboard and sandbox environment.Once signed in, navigate to Settings → API Keys to find your test credentials.
2

Get your API keys

You’ll have two types of API keys:
Key typeFormatPurpose
Test keysk_test_xxxxxxxxxxxxSandbox transactions — no real money
Live keysk_live_xxxxxxxxxxxxProduction transactions — real payments
Never expose your secret key in client-side code or public repositories. Use environment variables to store your keys securely.
3

Create your first payment

curl -X POST https://api.simiz.io/v1/transactions \
  -H "Authorization: Bearer sk_test_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000,
    "currency": "XAF",
    "payment_method": "ORANGE_MONEY",
    "payer": {
      "phone": "237690000001",
      "name": "John Doe"
    },
    "description": "Order #12345",
    "callback_url": "https://your-site.com/webhooks/simiz",
    "return_url": "https://your-site.com/success"
  }'
The response includes the transaction ID and status:
{
  "id": "tx_xxx",
  "status": "PENDING",
  "payment_url": "https://checkout.simiz.io/..."
}
4

Verify with a webhook

Once the customer completes the payment, Simiz sends a payment.succeeded webhook to your callback_url:
{
  "id": "evt_abc123",
  "type": "payment.succeeded",
  "created_at": "2024-03-15T10:30:00Z",
  "data": {
    "id": "tx_xxx",
    "amount": 5000,
    "currency": "XAF",
    "status": "COMPLETED"
  }
}
Always verify the webhook signature before processing. See the Signature Verification guide.

​
Sandbox test numbers

Use these numbers to simulate different payment outcomes:
NumberOperatorResult
237690000001Orange MoneySuccess
237670000001MTN MoMoSuccess
237690000002Orange MoneyInsufficient balance
237690000003Orange MoneyTimeout

Full sandbox documentation

See all test numbers and scenarios in the Sandbox guide.

​
Next steps

Configure Webhooks

Set up real-time notifications for payment events.

Explore the API

Browse the full API reference.