Payment Methods
Setup

Overview

Nexus Donate supports multiple payment gateways to accept donations from your players. This guide will help you set up the most popular payment methods.

Setting Up PayPal

PayPal is one of the most popular payment methods for online donations.

1. Create a PayPal Developer Account

1. Go to https://developer.paypal.com
2. Sign in with your PayPal account or create a new one
3. Navigate to "My Apps & Credentials"
4. Click "Create App"

2. Configure Your PayPal App

1. Choose "Default Application" or create a new app
2. Select "Sandbox" for testing or "Live" for production
3. Note down your Client ID and Client Secret
4. Configure the return URL to your store

3. Add PayPal to Your Store

1. Go to your admin dashboard
2. Navigate to Settings → Payment Methods
3. Enable PayPal and enter your credentials
4. Set up webhook URL for payment notifications

Setting Up Stripe

Stripe provides a modern payment processing solution with support for credit cards and other payment methods.

1. Create a Stripe Account

1. Go to https://stripe.com
2. Sign up for a Stripe account
3. Complete the account verification process
4. Access your Stripe dashboard

2. Get Your API Keys

1. In your Stripe dashboard, go to "Developers" → "API keys"
2. Copy your Publishable key and Secret key
3. Use test keys for development, live keys for production

3. Configure Stripe in Your Store

1. Go to your admin dashboard
2. Navigate to Settings → Payment Methods
3. Enable Stripe and enter your API keys
4. Configure webhook endpoints for payment events

Webhook Configuration

Webhooks are essential for real-time payment processing and order fulfillment.

PayPal Webhooks

1. In your PayPal developer dashboard, go to your app
2. Add webhook URL:
   Code

   Copy

   https://yourstore.com/webhook/paypal

3. Select the following events:
   • PAYMENT.SALE.COMPLETED
   • PAYMENT.SALE.DENIED
   • PAYMENT.SALE.REFUNDED

Stripe Webhooks

1. In your Stripe dashboard, go to "Developers" → "Webhooks"
2. Add endpoint:
   Code

   Copy

   https://yourstore.com/webhook/stripe

3. Select the following events:
   • payment_intent.succeeded
   • payment_intent.payment_failed
   • charge.dispute.created

Testing Payment Methods

Always test your payment methods before going live.

PayPal Testing

• Use PayPal's sandbox environment for testing
• Create test buyer and seller accounts
• Test successful payments, failed payments, and refunds
• Verify webhook notifications are received

Stripe Testing

• Use Stripe's test mode for development
• Use test card numbers provided by Stripe
• Test various payment scenarios
• Verify webhook events are processed correctly

Security Best Practices

• Use HTTPS: Always use SSL certificates for your store
• Keep Keys Secure: Never expose your API keys in client-side code
• Validate Webhooks: Always verify webhook signatures
• Monitor Transactions: Regularly review payment logs
• Update Regularly: Keep your payment integrations updated