Getting API Credentials

Getting Your API Keys from Shaloz Portal

You need API credentials to connect WooCommerce to Shaloz. Here's how to get them!

__________________________________________________

What You Need

Two Things from Shaloz Portal:

1. Business ID - Your unique account identifier
2. API Key - Security credential for connecting

Where to Use Them:

• Both go into WooCommerce plugin settings
• Allows secure communication between your store and Shaloz

__________________________________________________

Step 1: Log Into Shaloz Portal

Go to Portal:

• Visit portal.shaloz.com
• Enter your phone number
• Verify with SMS code
• You're in!

Don't Have an Account Yet?

• Click "Sign Up"
• Create business account
• Takes 5-10 minutes
• See Article 2.1 for details

__________________________________________________

Step 2: Navigate to Settings

Find Settings:

• Left sidebar → Click "Settings"
• Settings page opens
• Scroll down to "API Credentials" section

__________________________________________________

Step 3: Copy Your Business ID

Find Business ID:

• Look for "Business ID" or "Business Token"
• Long string of letters and numbers

Copy It:

• Click the copy icon next to it
• Or select all and copy (Ctrl+C or Cmd+C)
• Save it somewhere - you'll need it for WooCommerce

__________________________________________________

Step 4: Create an API Key

Why Two Keys?

• Sandbox Key - For testing (fake orders)
• Production Key - For real orders

Start with Sandbox:

Create Sandbox Key:

1. Scroll to "API Keys" section
2. Click "Create API Key" button
3. Environment: Select "Sandbox"
4. Name (Optional): "WooCommerce Sandbox"
5. Click "Generate Key" or "Create"

Key Appears:

• Public Key: Starts with pk_sandbox_...
• Secret Key: Starts with sk_sandbox_...
• For WooCommerce, use Public Key

IMPORTANT:

• Copy the Public Key immediately
• You won't see it again after you close this screen
• Save it in a safe place (password manager or secure note)

__________________________________________________

Step 5: Save Your Credentials

You Should Now Have:

• Business ID (copied)
• Sandbox Public API Key (copied)

Where to Save:

• Password manager (LastPass, 1Password, etc.)
• Secure note on your computer
• Not in an email or public document

Label Them:

Shaloz Business ID: [Your Business ID]
Shaloz API Key: pk_live_abc123...

__________________________________________________

Step 6: Enter in WooCommerce

Go Back to WooCommerce:

• WordPress → WooCommerce → Settings → Shipping
• Click your shipping zone
• Click "Shaloz Shipping"

Enter Credentials:

• API Key field: Paste your Sandbox Public Key
• Business ID field (if present): Paste Business ID
• API Environment: Select "Sandbox"
• Click "Test Connection"
• Should show Success!

Save Settings:

• Click "Save changes" at bottom
• All set!

__________________________________________________

Creating Production Key (Later)

When You're Ready to Go Live:

Same Process, Different Environment:

1. Shaloz Portal → Settings
2. API Keys section
3. Click "Create API Key"
4. Environment: Select "Production"
5. Name: "WooCommerce Production"
6. Click "Generate"
7. Copy Production Public Key
8. Save securely

Then Update WooCommerce:

• Change API Environment to "Production"
• Replace Sandbox key with Production key
• Test connection
• Save
• You're live!

__________________________________________________

Security Tips

Keep Keys Safe:

• Don't share publicly
• Don't commit to GitHub
• Don't email them
• Store in password manager
• Only share with trusted developers
• Rotate keys periodically

If Key is Compromised:

1. Go to Shaloz Portal → Settings
2. Find the compromised key
3. Click "Delete"
4. Create new key
5. Update WooCommerce with new key

__________________________________________________

Troubleshooting

Problem: Can't Find Settings in Portal

Fix:

• Look for gear icon or "Settings" in left sidebar
• Scroll down page to find "API Credentials"
• If still can't find, contact help.shaloz.com

Problem: "Create API Key" Button Not Working

Fixes:

• Refresh the page
• Try different browser
• Log out and back in
• Contact help.shaloz.com

Problem: Key Not Copying

Fixes:

• Try manual select-all and copy
• Check clipboard (paste in notepad to verify)
• Screenshot as backup
• If lost, delete and create new key

Problem: Test Connection Fails in WooCommerce

Check:

• Copied entire key (no spaces)
• Using PUBLIC key (starts with pk\_)
• Environment matches (Sandbox key = Sandbox environment)
• Pasted in correct field
• Try creating fresh key

__________________________________________________

Need Help?

Can't Access Portal?

• Request new SMS code
• help.shaloz.com

Key Issues?

• Delete old key, create new one
• help.shaloz.com with screenshots