The Add a Zainbox page allows merchants to create and configure a Zainbox account for receiving payments through Zainpay. Each Zainbox has its own prefix, callback URL, settlement type, and settlement account(s).

This guide will show you how to add a Zainbox from your ZainPay dashboard.

Open the Add a Zainbox Page

Navigate to your Zainpay dashboard, click on ZainBoxes in the left navigation pane, and click on Add a Zainbox.

Fill in Basic Zainbox Details

1. Zainbox Prefix – Enter a short, unique code to identify this Zainbox.
   • Example: SHOP1
2. Zainbox Name – A descriptive name for your Zainbox.
   • Example: Main Store Payments
3. Callback URL – Paste the callback URL you copied from the ZainPay WooCommerce settings page. Eg: https://yoursite.com/wc-api/wc_gateway_zainpay/
   • Must be an active HTTPS link.
4. Transaction Notification Email – Enter the email that should receive alerts for each transaction.
5. Description – Add any notes about this Zainbox (optional).
6. Tags – Add keywords to categorize the Zainbox (e.g., ecommerce, subscriptions).

Choose a Settlement Type

Under Add Settlement Type, select how often funds will be sent to your bank account:

• T+1 → Settlement occurs 1 day after the transaction.
• T+7 → Settlement occurs 7 days after the transaction.
  • You can pick the exact day (e.g., Monday, Tuesday).
• T+30 → Settlement occurs 30 days after the transaction.
  • You can pick the exact date of the month (e.g., 5th, 15th, 30th).

Add a Settlement Account

1. Select your Bank (e.g., Zain Microfinance Bank).
2. Enter your Account Number.
3. Set the Percentage Split for funds.
   • Example: 100% If all funds should be deposited into one account.
   • You can add multiple accounts and split funds (e.g., 70% / 30%).
4. Use the + button to add more accounts.

Save Your Zainbox

Once all details are complete, click the Create button. Your new Zainbox will now be active and ready to receive payments.

Done!

You’ve successfully created your Zainbox. Payments processed through this Zainbox will be routed to your settlement account(s) based on the settlement period you selected.