Skip to main content
Raïs

Accept card payments in Algeria.

CIB and Edahabia cards, through SATIM. Send a payment link or call the API, and your customers pay on a secure checkout.

Create accountRead the docs

Business accounts start in the sandbox. Live payments are enabled once your business is verified.

Currency
Algerian dinars (DZD)
Checkout
English, French and Arabic
Webhooks
Signed with HMAC-SHA256
Pricing
0.3% + 0.7% per payment, excluding VAT
Sample data. A customer pays on the checkout, the payment appears in your dashboard and a signed webhook reaches your server.
Currency
Algerian dinars (DZD)
Checkout
English, French and Arabic
Webhooks
Signed with HMAC-SHA256
Pricing
0.3% + 0.7% per payment, excluding VAT

How a payment works

  1. 01

    Create a payment

    Create a payment link in the dashboard, or call the API from your server with an amount and your own reference.

  2. 02

    The customer pays

    They open the checkout, enter their card details and confirm with a one-time code from their bank.

  3. 03

    You get paid

    You receive a signed webhook, and the payment has a PDF receipt to download. Live payments are credited to your Raïs account, in dinars.

Accept, track and refund payments in one place

Use payment links when you do not want to write code, and the API when you do. Both end up in the same dashboard.

  • Payment links

    Create a link for an amount and a reference, then send it by message or email. No website or code needed.

  • Hosted checkout

    A secure payment page for phones and desktops, in English, French and Arabic. It shows your store name and logo.

  • API and webhooks

    Create payments from your server, read their status and receive signed webhooks. Sandbox and live keys for each store.

  • Dashboard and receipts

    Follow every payment and its status in one list, and download a PDF receipt for each paid payment.

  • Refunds

    Refund a payment in full or in part, from the dashboard or the API. The money goes back to the customer's card through SATIM.

Built for developers

A small REST API with predictable errors. Start with a sandbox key, and switch to a live key once your business is verified.

Read the docsAPI overview
amount
An integer in centimes: 12,500.00 DA is 1250000.
Idempotency-Key
A retried request returns the first answer, not a second payment, for 24 hours.
Rais-Signature
Every webhook is signed with HMAC-SHA256 and retried, up to 8 times, until your server answers with a 2xx.
rais_sk_test_ / rais_sk_live_
Sandbox and live are separate environments with separate keys.
curl https://api.rais.app/v1/payments \  -H "Authorization: Bearer $RAIS_SECRET_KEY" \  -H "Idempotency-Key: order-1042" \  -H "Content-Type: application/json" \  -d '{    "amount": 1250000,    "currency": "DZD",    "description": "Order #1042",    "reference": "order-1042",    "success_url": "https://shop.example.dz/thanks",    "cancel_url": "https://shop.example.dz/cart"  }'
# The answer contains a checkout_url: send the customer there
Response201 Created
{  "id": "5b1c2f4e-9d3a-4c61-8a7e-0f2d6b9e1a33",  "object": "payment",  "status": "pending",  "amount": 1250000,  "currency": "DZD",  "reference": "order-1042",  "livemode": false,  "checkout_url": "https://pay.rais.app/pay/5b1c2f4e-9d3a-4c61-8a7e-0f2d6b9e1a33",  "expires_at": 1793086400}

Card data, keys and access

What happens behind the payment page, and what you can switch on.

  • Cards

    Card details go to SATIM

    On the payment page, card details are sent to SATIM's gateway for authorisation. They never pass through your servers.

  • Payer

    The bank checks the payer

    Each payment is confirmed with a one-time code from the payer's bank. The card issuer checks it, not Raïs.

  • API keys

    API keys are stored hashed

    A secret key is shown once, when you create it. We keep only a hash. Each key belongs to one store and one environment.

  • Webhooks

    Webhooks are signed

    Every delivery carries an HMAC-SHA256 signature and a timestamp, so you can verify the sender and reject replays.

  • Environments

    Test and live stay apart

    A sandbox key only creates test payments. They never move real money and never appear next to live ones. Live payments are enabled only after we verify your business.

  • Sign-in

    Two-factor sign-in

    Protect your dashboard with an authenticator app, so a stolen password is not enough to get in.

Who it is for

  • Online shops

    Take cards at checkout with the hosted page, or collect by link.

  • Apps

    Create the payment from your backend and send the user to the checkout.

  • Associations

    Collect dues and donations with a link. No website needed.

  • Freelancers

    Send a link with an amount, and get a receipt when it is paid.

Personal accounts hold a balance and pay. Sending and requesting money is coming soon. Create a personal account

Questions

Cannot find yours? Read the help centre or write to salam@rais.app.

Which cards can my customers pay with?

CIB and Edahabia cards, through SATIM. Payments are in Algerian dinars.

How much does it cost?

A payment costs 0.3% of its amount for Raïs plus 0.7% for SATIM, with SATIM's part never less than 10 DA and never more than 300 DA. A refund costs 10 DA. There is no setup fee, no monthly fee and no other fee, and all prices exclude VAT. See the pricing page for examples and a calculator.

Can I use Raïs without writing code?

Yes. Create payment links in the dashboard and send them by message or email. Use the API when you want to automate.

Where does the money go?

When SATIM confirms a live payment, the amount is credited to your Raïs account, in dinars, and the fees of the payment are taken from your balance. Your balance and every movement are in the dashboard. Once your business is verified, you can ask to withdraw your balance to a bank or postal account from the dashboard. Withdrawals cost nothing.

Can I test before going live?

Yes. A business account starts in the sandbox with test API keys. Sandbox payments use SATIM's test cards, listed in the documentation, and never move real money.

Can I refund a payment?

Yes, in full or in part, from the dashboard or the API. The refund returns to the customer's card through SATIM and is taken from your Raïs balance together with its fee of 10 DA, so the balance must cover both. The fees of the original payment are not returned.

Who can create an account?

Business accounts are for companies and professionals who sell goods or services. They accept payments, create payment links and use the API. Personal accounts are for individuals: they hold a balance, and sending and requesting money is coming soon.

How does verification work?

A business account starts in the sandbox. For live payments, submit your company details and documents in the dashboard: commercial register, tax identifiers (NIF and NIS), the owners' identity documents, and an agrément if your activity requires one, then sign the merchant agreement online. Our team reviews your application, and live payments are enabled once you are approved. We do not promise a review time.

Create an account and take a test payment

Business accounts start in the sandbox. Live payments are enabled once your business is verified.

Create accountRead the docs