Stripe is for Yalla Souk stores priced in euros, US dollars, pounds sterling, Canadian dollars or Swiss francs, with a Stripe account opened by a business registered in a country Stripe supports (Tunisia is not one of them). Create a restricted key with two permissions, paste it in Integrations › Payment › Stripe, then turn on card payments.
Behaviour checked in the product and Stripe documentation read on 22 October 2026.
Stripe in Yalla Souk at a glance
| Where to connect it | Integrations › Payment › Stripe › Connect |
|---|---|
| What you enter | A restricted key (it starts with rk_). Secret keys starting with sk_ are refused. |
| Key permissions | Checkout Sessions: Write and Webhook Endpoints: Write. |
| Currencies | EUR, USD, GBP, CAD and CHF. Not the Tunisian dinar: a TND store uses Flouci. |
| Where the money goes | To your Stripe account. Yalla Souk never holds it. |
| Yalla Souk commission | 0%. You pay only per order received; Stripe’s fees are those of your Stripe account. |
Who can use Stripe with Yalla Souk?
There are two conditions, one at Stripe and one at Yalla Souk. At Stripe, the account must belong to a business registered in a country where Stripe is available: Stripe’s published list does not include Tunisia, so a Tunisian company cannot open a Stripe account. At Yalla Souk, the store currency must be one the integration collects: euro, US dollar, pound sterling, Canadian dollar or Swiss franc.
The typical case is a brand with a company in France, Canada or the UK selling with Yalla Souk in that currency. For a store priced in dinars, online payment goes through Flouci. If your store currency is not supported, the Stripe card shows as disabled with the reason.
How do I create the Stripe restricted key?
- In your Stripe dashboard, in live mode, open the API keys page.
- Create a restricted key for Yalla Souk.
- Give it exactly two permissions: Checkout Sessions: Write and Webhook Endpoints: Write.
- Copy the key, which starts with
rk_live_. Stripe does not show it again once you leave: copy it straight away.
Why a restricted key and not the secret key? Stripe itself recommends restricted keys, whose rights you limit, over the secret key that opens the whole API. Yalla Souk refuses sk_ keys for the same reason.
How do I connect Stripe to Yalla Souk?
- Open Integrations, Payment category, and click Connect on the Stripe card.
- Paste the restricted key and confirm.
- Yalla Souk checks the key and itself creates, on your Stripe account, the webhook endpoint that tells it about payments. It appears in Stripe as “Yalla Souk order payments”.
- Once the status reads “Connected”, turn on Accept Stripe card payments on my store.
Error messages say what to fix: a secret key instead of a restricted one, a deleted or badly copied key, a missing permission, or a Stripe account that cannot collect the store currency.
How does a Stripe payment work?
- At checkout the customer picks card payment and places the order.
- They are redirected to the payment page hosted by Stripe (Stripe Checkout), in your store currency, where they enter their card or use a wallet offered by your Stripe account.
- The payment session stays open for at least 30 minutes and at most 24 hours, within the lifetime of the order.
- Stripe confirms the payment to Yalla Souk through the webhook; the order is marked paid automatically.
- The funds land in your Stripe account, then in your bank account on your Stripe payout schedule.
What are the limits and responsibilities?
- Refunds and disputes: handled in your Stripe dashboard. Yalla Souk does not process refunds, disputes or chargebacks.
- Minimum amount: if a total is below Stripe’s minimum for the currency, that order cannot be paid by card; the connection itself stays valid.
- Disconnecting: disconnecting Stripe deletes your key from Yalla Souk and removes the webhook created on your Stripe account.
- Cash: cash on delivery or pickup stays available unless you turn it off.