How to connect payment merchants with task session: complete integration guide

Payment Integration Overview

Task Session supports three major payment gateways:

• Stripe – Credit/debit cards, digital wallets, international payments
• PayPal – PayPal accounts, credit cards, PayPal Credit
• 2Checkout – Global payment processing, multiple currencies

Benefits of Payment Integration

• Automated Invoicing – Generate and send invoices automatically
• Online Payments – Accept payments directly through the system
• Payment Tracking – Monitor payment status and history
• Client Convenience – Easy payment options for clients
• Financial Reporting – Track revenue and payment analytics

Stripe Integration

Stripe is one of the most popular payment processors, supporting credit cards, digital wallets, and international payments.

Step 1: Create Stripe Account

1. Visit Stripe.com
2. Click “Start now” to create your account
3. Complete the business verification process
4. Verify your email address and phone number
5. Add your business information and bank account details

Step 2: Get API Keys

1. Log in to your Stripe Dashboard
2. Navigate to Developers > API keys
3. Copy your Publishable key (starts with pk_live_ or pk_test_)
4. Copy your Secret key (starts with sk_live_ or sk_test_)
5. Keep these keys secure – never share them publicly

Step 3: Configure Stripe in Task Session

1. Log in to your Task Session admin panel
2. Navigate to System Settings > Payment Settings
3. Find the Stripe section and click “Configure”
4. Enter your Stripe credentials:
   • Live Secret Key: Your Stripe secret key
   • Live Publishable Key: Your Stripe publishable key
5. Click “Update Settings”
6. Click “Verify Stripe Connection” to test the integration

Stripe Features

• Credit/Debit Cards: Visa, Mastercard, American Express, Discover
• Digital Wallets: Apple Pay, Google Pay, Microsoft Pay
• International: Support for 135+ currencies
• Security: PCI DSS compliant, fraud protection
• Mobile: Mobile-optimized payment forms

PayPal Integration

PayPal is a trusted payment method that allows customers to pay using their PayPal account or credit cards.

Step 1: Create PayPal Business Account

1. Visit PayPal Business
2. Click “Sign Up” to create your business account
3. Choose “Business Account” during registration
4. Complete the business verification process
5. Verify your email address and phone number
6. Add your business information and bank account

Step 2: Get PayPal Email

1. Log in to your PayPal Business account
2. Navigate to Account Settings > Email address
3. Copy your Business Email address
4. This is the email that will receive payments

Step 3: Configure PayPal in Task Session

1. Go to System Settings > Payment Settings
2. Find the PayPal section and click “Configure”
3. Enter your PayPal business email address
4. Click “Update Settings”
5. Click “Verify PayPal Connection” to test the integration

PayPal Features

• PayPal Accounts: Customers can pay with their PayPal balance
• Credit Cards: Accept Visa, Mastercard, American Express, Discover
• PayPal Credit: Customers can use PayPal’s credit service
• Buyer Protection: PayPal’s buyer protection program
• Mobile Payments: Mobile-optimized checkout

2Checkout Integration

2Checkout (now Verifone) is a global payment processor supporting multiple payment methods and currencies.

Step 1: Create 2Checkout Account

1. Visit 2Checkout.com
2. Click “Get Started” to create your account
3. Complete the merchant application process
4. Provide business documentation and verification
5. Wait for account approval (usually 1-3 business days)

Step 2: Get API Credentials

1. Log in to your 2Checkout Control Panel
2. Navigate to Integrations > Webhooks & API
3. Find your Seller ID (6-digit number)
4. Generate your Private Key (API key)
5. Copy both credentials securely

Step 3: Configure 2Checkout in Task Session

1. Go to System Settings > Payment Settings
2. Find the 2Checkout section and click “Configure”
3. Enter your 2Checkout credentials:
   • Seller ID: Your 6-digit seller ID
   • Private Key: Your API private key
4. Click “Update Settings”
5. Click “Verify 2Checkout Connection” to test the integration

2Checkout Features

• Global Reach: Support for 200+ countries
• Multiple Currencies: 100+ supported currencies
• Payment Methods: Credit cards, PayPal, bank transfers
• Fraud Protection: Advanced fraud detection
• Mobile Commerce: Mobile-optimized checkout

Task Session Configuration

Accessing Payment Settings

1. Log in to your Task Session admin panel
2. Navigate to System Settings
3. Click on Payment Settings
4. You’ll see three payment gateway sections

Payment Gateway Setup Process

1. Choose Gateway: Select which payment methods to enable
2. Enter Credentials: Add your API keys and account details
3. Test Connection: Verify the integration works correctly
4. Save Settings: Store the configuration securely
5. Enable Payments: Activate payment processing

Multiple Payment Methods

You can enable multiple payment gateways simultaneously:

• Primary Method: Set your preferred payment gateway
• Backup Methods: Enable additional payment options
• Client Choice: Let clients choose their preferred payment method
• Geographic Optimization: Different gateways for different regions

Testing Payments

Test Mode vs Live Mode

• Test Mode: Use test API keys for development and testing
• Live Mode: Use live API keys for production payments
• Switch Between Modes: Change API keys to switch modes

Testing Stripe Payments

1. Use Stripe’s test card numbers:
   • Success: 4242 4242 4242 4242
   • Declined: 4000 0000 0000 0002
   • Requires Authentication: 4000 0025 0000 3155
2. Use any future expiry date (e.g., 12/25)
3. Use any 3-digit CVC
4. Test different scenarios (success, failure, authentication)

Testing PayPal Payments

1. Use PayPal’s Sandbox accounts
2. Create test buyer and seller accounts
3. Test with different payment methods
4. Verify webhook notifications

Testing 2Checkout Payments

1. Use 2Checkout’s test mode
2. Use test card numbers provided by 2Checkout
3. Test different payment scenarios
4. Verify API responses

Troubleshooting

Common Stripe Issues

“Invalid API Key” Error

Problem: Stripe API keys are incorrect or invalid

Solutions:

• Verify you’re using the correct API keys from your Stripe dashboard
• Check that keys match your environment (test vs live)
• Ensure keys are copied completely without extra spaces
• Regenerate API keys if necessary

“Card Declined” Error

Problem: Payment is being declined

Solutions:

• Check if the card has sufficient funds
• Verify the card details are correct
• Check if the card is enabled for online payments
• Contact the card issuer if issues persist

Common PayPal Issues

“Invalid Email” Error

Problem: PayPal email address is incorrect

Solutions:

• Verify the email address is correct in PayPal settings
• Ensure the email is associated with a business account
• Check that the account is verified and active

“Payment Failed” Error

Problem: PayPal payment processing fails

Solutions:

• Check PayPal account status and verification
• Verify webhook URLs are configured correctly
• Check PayPal account limits and restrictions

Common 2Checkout Issues

“Invalid Seller ID” Error

Problem: 2Checkout seller ID is incorrect

Solutions:

• Verify the seller ID from your 2Checkout control panel
• Check that the account is approved and active
• Ensure you’re using the correct seller ID format

“API Authentication Failed” Error

Problem: 2Checkout API authentication fails

Solutions:

• Verify the private key is correct and active
• Check that API access is enabled in your account
• Ensure the private key has the necessary permissions

General Troubleshooting Steps

1. Check API Keys: Verify all credentials are correct
2. Test Connection: Use the verify buttons in Task Session
3. Check Logs: Review error logs for specific issues
4. Contact Support: Reach out to payment gateway support
5. Update Integration: Ensure you’re using the latest API version

Security Best Practices

API Key Security

• Never Share Keys: Keep API keys confidential
• Use Environment Variables: Store keys securely
• Regular Rotation: Change keys periodically
• Monitor Usage: Track API key usage and access

Payment Data Security

• PCI Compliance: Ensure your system is PCI compliant
• Encryption: Use HTTPS for all payment communications
• Data Storage: Never store sensitive payment data
• Access Control: Limit access to payment settings

Account Security

• Strong Passwords: Use complex passwords for all accounts
• Two-Factor Authentication: Enable 2FA where available
• Regular Audits: Review account access regularly
• Monitor Transactions: Watch for suspicious activity

Payment Processing Workflow

Invoice Creation

1. Create invoice in Task Session
2. Add line items and amounts
3. Set due date and payment terms
4. Send invoice to client

Payment Processing

1. Client receives invoice with payment link
2. Client selects preferred payment method
3. Client enters payment details securely
4. Payment is processed by the gateway
5. Payment status is updated in Task Session

Payment Confirmation

1. Client receives payment confirmation
2. Admin receives payment notification
3. Invoice status updates to “Paid”
4. Payment is recorded in financial reports

Advanced Configuration

Webhook Setup

Configure webhooks to receive real-time payment notifications:

• Stripe Webhooks: Set up webhook endpoints in Stripe dashboard
• PayPal Webhooks: Configure webhook URLs in PayPal developer console
• 2Checkout Webhooks: Set up webhook notifications in control panel

Currency Configuration

• Default Currency: Set your primary currency
• Multi-Currency: Support multiple currencies
• Exchange Rates: Configure automatic rate updates
• Localization: Format amounts according to locale

Tax Configuration

• Tax Rates: Set up applicable tax rates
• Tax Calculation: Configure automatic tax calculation
• Tax Reporting: Generate tax reports
• Compliance: Ensure tax compliance in your jurisdiction

Monitoring and Analytics

Payment Analytics

• Transaction Volume: Track payment volume over time
• Success Rates: Monitor payment success rates
• Revenue Reports: Generate financial reports
• Client Payment History: Track client payment patterns

Performance Monitoring

• Response Times: Monitor payment processing speed
• Error Rates: Track and analyze payment failures
• Uptime: Ensure payment systems are always available
• Alerts: Set up notifications for payment issues

Conclusion

Integrating payment gateways with Task Session provides numerous benefits:

• Streamlined Payments – Accept payments directly through the system
• Improved Cash Flow – Faster payment processing and collection
• Client Convenience – Multiple payment options for clients
• Automated Invoicing – Reduce manual payment processing
• Financial Tracking – Better visibility into revenue and payments

Next Steps

1. Choose Payment Gateways – Select the best options for your business
2. Set Up Accounts – Create accounts with chosen payment processors
3. Configure Integration – Add API keys and test connections
4. Test Payments – Verify everything works correctly
5. Go Live – Start accepting real payments from clients