Payment Gateways Setup

Payment Gateways Overview

Your marketplace supports 28 payment gateways covering global and regional payment methods. Each gateway has step-by-step setup instructions to minimize support requests.

Quick Gateway Navigation

Global: PayPal | Stripe | Mollie | NowPayments
Middle East & Africa: Paytabs | Paymob EG | YouCanPay | CamPay | Paystack | Flutterwave
Asia Pacific: Razorpay | Cashfree | Xendit | Duitku | VNPay | Ecpay | Paymob PK | Jazzcash | Genie Business
Europe & CIS: Iyzico | PayTR | Robokassa | Freekassa | Epoint.az | cPay
Latin America: Mercadopago | Asaas | Fast Pay

1. PayPal Setup

Coverage: 200+ countries | Currency: USD | Fees: 2.9% + $0.30

Getting API Credentials:

1. Create account at paypal.com/business
2. Go to developer.paypal.com
3. Click My Apps & Credentials → Create App
4. Copy Client ID and Client Secret

Configuration:

Admin → Services → Payment → PayPal
- Client ID: Your_Client_ID
- Client Secret: Your_Secret
- Environment: Sandbox/Production

Testing:

• Use sandbox accounts from developer dashboard
• Test mode automatically enabled in sandbox

2. Stripe Setup

Coverage: 46 countries | Currency: 135+ | Fees: 2.9% + $0.30

Getting API Credentials:

1. Sign up at stripe.com
2. Dashboard → Developers → API Keys
3. Copy Publishable Key and Secret Key

Configuration:

Admin → Services → Payment → Stripe
- Public Key: pk_test_xxx or pk_live_xxx
- Secret Key: sk_test_xxx or sk_live_xxx

Test Cards:

• Success: 4242 4242 4242 4242
• Decline: 4000 0000 0000 0002

3. Mollie Setup

Coverage: EU | Currency: EUR/USD | Fees: €0.29 + var

Getting API Credentials:

1. Register at mollie.com
2. Dashboard → Developers → API Keys
3. Copy API Key

Configuration:

Admin → Services → Payment → Mollie
- API Key: test_xxx or live_xxx

4. NowPayments Setup

Type: Cryptocurrency | Currency: USDT ERC20

Getting API Credentials:

1. Sign up at nowpayments.io
2. Dashboard → API Settings
3. Generate API Key and set IPN Secret

Configuration:

Admin → Services → Payment → NowPayments
- API Key: Your_API_Key
- IPN Secret: Your_IPN_Secret
- Environment: Sandbox/Production

5. Paytabs Setup

Countries: Saudi, UAE, Egypt | Currency: SAR | Rate: 3.8

Getting API Credentials:

1. Apply at paytabs.com
2. Merchant Dashboard → API Keys
3. Copy Profile ID and Server Key

Configuration:

Admin → Services → Payment → Paytabs
- Profile ID: Your_Profile_ID
- Server Key: Your_Server_Key
- Region: GLOBAL/ARE/SAU/OMN/JOR/EGY

6. Paymob EG Setup

Country: Egypt | Currency: EGP | Rate: 32.0

Getting API Credentials:

1. Register at accept.paymob.com
2. Dashboard → Developers
3. Copy all required IDs

Configuration:

Admin → Services → Payment → Paymob EG
- API Key: Your_API_Key
- HMAC Hash: Your_HMAC
- Merchant ID: Your_Merchant_ID
- iFrame ID: Your_iFrame_ID
- Integration ID: Your_Integration_ID

7. YouCanPay Setup

Country: Morocco | Currency: MAD | Rate: 10.0

Getting API Credentials:

1. Sign up at youcanpay.com
2. Dashboard → API Keys
3. Copy Public and Private Keys

Configuration:

Admin → Services → Payment → YouCanPay
- Public Key: Your_Public_Key
- Private Key: Your_Private_Key

8. CamPay Setup

Country: Cameroon | Currency: XAF | Rate: 605.0

Getting API Credentials:

1. Register at campay.net
2. Dashboard → API Settings
3. Get Username and Password

Configuration:

Admin → Services → Payment → CamPay
- App Username: Your_Username
- App Password: Your_Password
- Environment: Sandbox/Production

9. Paystack Setup

Countries: Nigeria, Ghana | Currency: NGN | Rate: 755.0

Getting API Credentials:

1. Sign up at paystack.com
2. Settings → API Keys
3. Copy Public and Secret Keys

Configuration:

Admin → Services → Payment → Paystack
- Public Key: pk_test_xxx or pk_live_xxx
- Secret Key: sk_test_xxx or sk_live_xxx

10. Flutterwave Setup

Coverage: 30+ African countries | Currency: NGN | Rate: 755.0

Getting API Credentials:

1. Register at flutterwave.com
2. Settings → API
3. Copy all three keys

Configuration:

Admin → Services → Payment → Flutterwave
- Public Key: Your_Public_Key
- Secret Key: Your_Secret_Key
- Encryption Key: Your_Encryption_Key
- Environment: Sandbox/Production

11. Razorpay Setup

Country: India | Currency: INR | Rate: 83.0

Getting API Credentials:

1. Sign up at razorpay.com
2. Settings → API Keys
3. Generate and copy keys

Configuration:

Admin → Services → Payment → Razorpay
- Key ID: rzp_test_xxx or rzp_live_xxx
- Key Secret: Your_Key_Secret

12. Cashfree Setup

Country: India | Currency: INR | Rate: 83.0

Getting API Credentials:

1. Register at cashfree.com
2. Dashboard → Credentials
3. Copy App ID and Secret

Configuration:

Admin → Services → Payment → Cashfree
- App ID: Your_App_ID
- Secret Key: Your_Secret_Key
- Environment: Sandbox/Production

13. Xendit Setup

Countries: Indonesia, Philippines | Currency: IDR | Rate: 15,100

Getting API Credentials:

1. Sign up at xendit.co
2. Settings → API Keys
3. Copy keys

Configuration:

Admin → Services → Payment → Xendit
- Public Key: xnd_public_xxx
- Secret Key: xnd_xxx

14. Duitku Setup

Country: Indonesia | Currency: IDR | Rate: 14,900

Getting API Credentials:

1. Register at duitku.com
2. Project Settings
3. Get API Key and Merchant Code

Configuration:

Admin → Services → Payment → Duitku
- API Key: Your_API_Key
- Merchant Code: Your_Merchant_Code
- Environment: Sandbox/Production

15. VNPay Setup

Country: Vietnam | Currency: VND | Rate: 23,600

Getting API Credentials:

1. Apply at vnpay.vn
2. Merchant Portal → API Info
3. Copy credentials

Configuration:

Admin → Services → Payment → VNPay
- TMN Code: Your_TMN_Code
- Hash Secret: Your_Hash_Secret
- Environment: Sandbox/Production

16. Ecpay Setup

Country: Taiwan | Currency: TWD | Rate: 62.0

Getting API Credentials:

1. Register at ecpay.com.tw
2. Merchant Backend → System Development
3. Copy all three values

Configuration:

Admin → Services → Payment → Ecpay
- Merchant ID: Your_Merchant_ID
- Hash Key: Your_Hash_Key
- Hash IV: Your_Hash_IV
- Environment: Sandbox/Production

17. Paymob PK Setup

Country: Pakistan | Currency: PKR | Rate: 290.0

Getting API Credentials:

1. Register at pakistan.paymob.com
2. Same process as Paymob EG

Configuration:

Admin → Services → Payment → Paymob PK
- API Key: Your_API_Key
- HMAC Hash: Your_HMAC
- Merchant ID: Your_Merchant_ID
- iFrame ID: Your_iFrame_ID
- Integration ID: Your_Integration_ID

18. Jazzcash Setup

Country: Pakistan | Currency: PKR | Rate: 287.0

Getting API Credentials:

1. Apply at jazzcash.com.pk
2. Merchant Portal → Integration
3. Get credentials

Configuration:

Admin → Services → Payment → Jazzcash
- Merchant ID: Your_Merchant_ID
- Password: Your_Password
- Integrity Salt: Your_Salt
- Environment: Sandbox/Production

19. Genie Business Setup

Country: Sri Lanka | Currency: LKR | Rate: 297.0

Getting API Credentials:

1. Register at geniebiz.lk
2. Dashboard → API Management
3. Generate App Key

Configuration:

Admin → Services → Payment → Genie Business
- App Key: Your_App_Key
- Environment: Sandbox/Production

20. Iyzico Setup

Country: Turkey | Currency: TRY | Rate: 24.0

Getting API Credentials:

1. Sign up at iyzico.com
2. Merchant Panel → Settings
3. Copy API and Secret Keys

Configuration:

Admin → Services → Payment → Iyzico
- API Key: Your_API_Key
- Secret Key: Your_Secret_Key
- Environment: Sandbox/Production

21. PayTR Setup

Country: Turkey | Currency: TRY | Rate: 27.0

Getting API Credentials:

1. Apply at paytr.com
2. Merchant Panel → Information
3. Copy all three values

Configuration:

Admin → Services → Payment → PayTR
- Merchant ID: Your_Merchant_ID
- Merchant Key: Your_Merchant_Key
- Merchant Salt: Your_Merchant_Salt

22. Robokassa Setup

Country: Russia | Currency: RUB | Rate: 84.0

Getting API Credentials:

1. Register at robokassa.com
2. Technical Settings
3. Set up passwords

Configuration:

Admin → Services → Payment → Robokassa
- MRH Login: Your_Merchant_Login
- MRH Pass1: Your_Password_1
- MRH Pass2: Your_Password_2

23. Freekassa Setup

Country: Russia | Currency: RUB | Rate: 84.0

Getting API Credentials:

1. Sign up at freekassa.ru
2. Merchant Cabinet → Shop Settings
3. Copy credentials

Configuration:

Admin → Services → Payment → Freekassa
- Shop ID: Your_Shop_ID
- Merchant API Key: Your_API_Key
- Merchant Secret: Your_Secret

24. Epoint.az Setup

Country: Azerbaijan | Currency: AZN | Rate: 1.7

Getting API Credentials:

1. Register at epoint.az
2. Merchant Panel → API Settings
3. Get keys

Configuration:

Admin → Services → Payment → Epoint.az
- Public Key: Your_Public_Key
- Private Key: Your_Private_Key

25. cPay Setup

Country: Macedonia | Currency: MKD | Rate: 58.0

Getting API Credentials:

1. Apply at cpay.com.mk
2. Merchant Portal
3. Get credentials

Configuration:

Admin → Services → Payment → cPay
- Merchant ID: Your_Merchant_ID
- Merchant Name: Your_Merchant_Name
- Password: Your_Password

26. Mercadopago Setup

Countries: Latin America | Currency: BRL | Rate: 4.8

Getting API Credentials:

1. Sign up at mercadopago.com
2. Your Business → Credentials
3. Copy keys

Configuration:

Admin → Services → Payment → Mercadopago
- Public Key: Your_Public_Key
- Access Token: Your_Access_Token
- Environment: Sandbox/Production

27. Asaas Setup

Country: Brazil | Currency: BRL | Rate: 5.0

Getting API Credentials:

1. Register at asaas.com
2. My Account → Integrations
3. Generate API Key

Configuration:

Admin → Services → Payment → Asaas
- API Key: Your_API_Key
- Access Token: Optional
- Environment: Sandbox/Production

28. Fast Pay Setup

Country: Iraq | Currency: IQD | Rate: 1,310

Getting API Credentials:

1. Register at fast-pay.cash
2. Merchant Dashboard
3. Get credentials

Configuration:

Admin → Services → Payment → Fast Pay
- Merchant Mobile Number: Your_Mobile
- Store Password: Your_Password
- Environment: Sandbox/Production

Webhook Configuration

Most gateways require webhook URLs for real-time updates.

Webhook URL Format:

https://yourdomain.com/callback/[gateway-slug]

Examples:

• PayPal: https://yourdomain.com/callback/paypal
• Stripe: https://yourdomain.com/callback/stripe
• Razorpay: https://yourdomain.com/callback/razorpay

Testing Guidelines

Before Going Live:

1. Enable Test Mode - Start with sandbox/test environment
2. Test Transactions - Make small test payments
3. Verify Webhooks - Check webhook delivery
4. Test Refunds - Process test refunds
5. Switch to Production - Only after successful testing

Common Test Credentials:

• Stripe Test Card: 4242 4242 4242 4242
• PayPal Sandbox: Create test accounts in developer dashboard
• Other Gateways: Check their documentation for test credentials

Troubleshooting Common Issues

"Gateway not configured"

• Gateway is disabled in admin panel
• Missing required API credentials
• Invalid credentials format

"Currency not supported"

• Gateway doesn't support your currency
• Exchange rate not configured
• Update exchange rate in settings

"Transaction failed"

• Wrong environment (sandbox vs production)
• Invalid API credentials
• Insufficient account permissions
• Gateway account not activated

"Webhook not received"

• URL not publicly accessible
• HTTPS certificate issues
• Firewall blocking gateway IPs
• Incorrect webhook secret

Security Best Practices

1. Protect API Credentials

   • Never share or expose API keys
   • Use environment variables
   • Rotate keys periodically

2. HTTPS Required

   • SSL certificate mandatory
   • Use TLS 1.2 or higher
   • Keep certificates updated

3. Monitor Transactions

   • Review failed payments
   • Set up fraud alerts
   • Track unusual patterns

4. PCI Compliance

   • Never store card details
   • Use gateway tokenization
   • Follow PCI DSS standards

Getting Support

Gateway Support Channels:

• Check gateway documentation first
• Use gateway support tickets
• Join developer forums
• Watch tutorial videos

Before Contacting Support:

1. Test in sandbox mode
2. Check error logs
3. Verify all credentials
4. Review webhook logs
5. Check gateway status page

Information to Provide:

• Transaction/Order ID
• Error messages
• API request/response
• Timestamp of issue
• Environment (test/live)