Settings
Marketplace
Browse the apps you can connect, and connect MyFatoorah or Moyasar so customers can pay for your digital products.
The Marketplace lists the apps you can connect to your Profily account. Today the apps you can connect are two payment gateways, MyFatoorah and Moyasar. Connecting one is what lets customers pay for your digital products: the money goes straight into your own gateway account, not through Profily.
Open Marketplace at the foot of the sidebar (it's also the last item in the App settings list). The page is called Available apps.
Only the account owner can connect, update or disconnect a gateway, because it decides where your customers' money goes. Team members can see the list, with the notice Only the account owner can connect or manage apps., but can't open the gateway pages.
Browse the apps
Each app card shows its name, what it does and its category (Payments or Notifications). The button in the corner tells you its state:
- Connect: the app is available and not connected yet.
- Manage: the app is connected. A green Connected badge appears next to its name.
- Coming soon: listed so you know it's on the way, but it can't be connected yet. This is the case for Tap Payments, Amazon Payment Services, HyperPay and Microsoft Teams.
Type in Search apps... to find an app by name or description, or select Filters and choose a Category.
Before you connect a gateway
You need your own merchant account with the gateway. Profily doesn't create one for you.
- MyFatoorah accepts cards and local payment methods across the GCC.
- Moyasar accepts payments in Saudi Arabia with mada, cards, Apple Pay and STC Pay.
You can connect both. When more than one gateway is connected, your customers choose how to pay at checkout. If none is connected, customers can't pay for paid products: checkout shows This seller has not connected a payment method yet. Free products still work.
Connect MyFatoorah
- On Available apps, select Connect on the MyFatoorah card. The page opens with a Not Connected banner.
- In your MyFatoorah dashboard, go to Settings › API Keys and copy your API key.
- Paste it into API Key. Use the eye button to show or hide what you pasted.
- Select Test Connection. If the key works, you see Connection successful. N payment methods available. If not, the error from MyFatoorah appears next to the button. The test doesn't save anything.
- Copy the address in Webhook URL (required) with Copy, and paste it into your MyFatoorah dashboard under Settings › Webhook. See Why the webhook matters.
- Optionally, enter a Webhook Secret. It lets Profily confirm that payment updates really come from MyFatoorah, and is recommended once you take real payments.
- Check the Settlement Currency.
- Turn on Test Mode if you pasted a sandbox (test) key, or off for your live key.
- Select Connect MyFatoorah. You return to the apps page with MyFatoorah connected.
Product currency must match
MyFatoorah pays out in your account's own currency. If some of your active products are priced in a different currency, Profily warns you after connecting (Your MyFatoorah account settles in …, so customers can't pay for products priced in …). Customers can't buy those products until you change their currency in Products.
Connect Moyasar
- On Available apps, select Connect on the Moyasar card.
- In your Moyasar dashboard, go to Settings › API Keys and copy your secret key.
- Paste it into Secret Key. A key starting with
sk_test_is for testing; one starting withsk_live_takes real payments. Moyasar reads the mode from the key itself, so there's no test switch on this page. - Select Test Connection. You see Connection successful. or the error from Moyasar.
- Copy the Webhook URL (required) and add it in your Moyasar dashboard under Settings › Webhooks, as an endpoint with all the
payment_*events turned on. - Optionally, enter a Webhook Secret. Set the same secret token here and in Moyasar's webhook settings.
- Check the Settlement Currency (SAR).
- Select Connect Moyasar.
Why the webhook matters
The webhook address is how the gateway tells Profily that a customer's payment went through. It's what marks the order as paid and gives the customer access to what they bought.
Important
If you skip the webhook step, customers can complete payment at the gateway but their order stays stuck as awaiting payment in Orders, and they don't get their product. Add the webhook address in the gateway's dashboard before you share your store.
The address is unique to your account. Copy it from the page rather than typing it.
Update your gateway details
- On Available apps, select Manage on the gateway's card. The banner shows Connected & Live and the date you connected it.
- Paste the key again. For security, the saved key isn't shown on the page, so the field is empty each time you open it.
- Change what you need (webhook secret, settlement currency, and for MyFatoorah Test Mode).
- Select Update Integration Details.
Tip
Every field is saved again when you update, so re-enter the webhook secret too if you use one, and for MyFatoorah check that Test Mode is set the way you want: it starts switched on when the page opens.
To move from testing to real payments, open the gateway, paste your live key (and for MyFatoorah turn Test Mode off), and select Update Integration Details.
Disconnect a gateway
- Open the gateway with Manage.
- Select Disconnect in the green banner.
- Confirm with Disconnect.
Customers can no longer pay with that gateway, and your saved key is removed from Profily. You can connect it again at any time.
Refunds go through the gateway
When you refund an order from Orders, Profily sends the refund through the gateway the customer paid with. Keep that gateway connected while you might still need to refund its orders.
Related pages
Screens captured from a demo account with sample data.