AxeDz

v1.0

  • Overview
  • Quickstart
  • SDK
  • Authentication
  • Payment
  • API Reference
  • Errors

Payment & Wallet

AxeDz uses a prepaid wallet in Algerian Dinars (DZD). Top up your balance, send messages, and track every transaction from your dashboard.

Your wallet

Every AxeDz account comes with a wallet. When you send messages in production mode, the cost is automatically deducted from your balance. In sandbox mode, nothing is charged.

  • Check your current balance anytime in the dashboard
  • Top up using SATIM Algeria's trusted payment gateway
  • View a full history of top-ups and message charges
  • Get notified when your balance is running low

What you pay

You are only charged for messages successfully sent in production mode:

ServicePrice (DZD)Unit
SMS2per message
Email0.4per email
Cloud Storage50per GB
AI Tokens0.005per token

Estimate your costs with our pricing calculator.

How billing works

  • You top up your wallet through SATIM in the dashboard
  • When you send a message in production, the cost is deducted automatically
  • If your balance is too low, the request is rejected — top up and try again
  • Every charge appears in your transaction history with the date and amount
  • Sandbox mode never charges your wallet, no matter how many tests you run

Topping up with SATIM

SATIM is Algeria national electronic payment system. You can top up your wallet securely from the dashboard using your bank card or SATIM account.

How to top up

Go to Dashboard → Wallet → Top Up, enter the amount in DZD, and complete payment through SATIM. Your balance updates as soon as the payment is confirmed.

Checking your balance via API

You can check your wallet balance programmatically:

Get wallet balance

bash
GET /v1/wallet
Response
1{
2 "success": true,
3 "data": {
4 "balance": 12500,
5 "currency": "DZD",
6 "mode": "production"
7 }
8}

Transaction history

View all your top-ups and message charges from the dashboard, or fetch them via the API:

Payment history

bash
GET /v1/payment/history

Returns your SATIM top-up history.

All transactions

bash
GET /v1/payment/transactions

Returns all wallet activity — top-ups and message charges.

Low balance

If your wallet balance is not enough to cover a message, the API returns an error and the message is not sent. Top up your wallet and try again — no message is partially charged.