SofizPay Logo

SofizPay

SofizPay Logo
SofizPay
Technical Documentation
API Reference

SofizPay API Reference

Welcome to the SofizPay API documentation. Our comprehensive API allows you to integrate payment services, recharge mobile phones, pay bills, and much more into your applications.

Authentication & API Keys

SofizPay uses two types of keys to authenticate your integration. The Public Key is used for receiving payments via CIB/Edahabiya, while the Secret Key is used for services that send funds from your account.

Public Key

Used to receive CIB/Edahabiya payments. Required as the account parameter in the CIB/Edahabiya payment endpoint.

CIB/Edahabiya Payment endpoint

Secret Key

Used for services that send from your account. Keep this key private and secure at all times.

Services endpoints (recharge, bills, etc.)

Getting Your Public Key

Your Public Key is your SofizPay account address. It is required as the account parameter when creating a CIB/Edahabiya payment request. Customers pay into this address when they complete a CIB/Edahabiya transaction.

How to obtain your Public Key:

1
Open the SofizPay mobile app or visit app.sofizpay.com in your browser.
2
Sign in to your existing account or create a new one.
3
Tap Receive — you will see your QR code and, below it, your Public Key.
4
Copy the Public Key by tapping it — paste it as the account value in your integration.

GDNS27ISCGOIJFXC6CM4O5SVHVJPSWR42QEBWUFF24N5VVHGW73ZSJNQ

Example Public Key (account address)

Getting Your Secret Key

Your Secret Key authenticates requests that operate on your account, such as phone recharge, internet recharge, bill payments, and game top-ups. It must be kept confidential and never exposed in client-side code.

How to obtain your Secret Key:

1
Open the SofizPay mobile app or visit app.sofizpay.com in your browser.
2
In the top bar, click the wallet selector to open your wallet panel.
3
Click the Settings icon next to your wallet.
4
Select View Secret Key, then tap to reveal it and copy it.

Where to use each key

EndpointKey Required
Make CIB/Edahabiya TransactionPublic Key
Phone RechargeSecret Key
Internet RechargeSecret Key
Game RechargeSecret Key
Bill PaymentSecret Key
Operation HistorySecret Key
Operation DetailsSecret Key

Payments & Operations

Make CIB/EDAHABIYA Transaction

Process secure CIB/EDAHABIYA transactions

CIB/EDAHABIYA Transaction Check

Verify and check CIB/EDAHABIYA transaction status

Service Endpoints

Phone Recharge

Recharge mobile phones for all Algerian operators

Game Recharge

Top up popular mobile games like PUBG and Free Fire

Internet Recharge logo

Internet Recharge

Recharge IDOOM 4G and ADSL internet packages

Bill Payments

Pay utility bills for ADE, Sonelgaz, and Algérie Télécom

Operation History

Access complete history of all operations