Supported Payment Gateways and Payment Types

​

Concepts

• Payment Gateway (Gateway): A payment service provider that processes payments (e.g., Stripe, PayPal, Payssion, Alipay, Alipay+, Changelly, Unitpay, FireKassa, MulenPay, Blockonomics, Wire Transfer)
• Gateway Type (Payment Type Category): The category of payment method - Bank Card (1), Cryptocurrency (2), or Wire Transfer (3)
• Gateway Payment Types: Specific payment methods supported by each gateway (e.g., Visa, Mastercard, Alipay, WeChat Pay)

​

Gateway Types

​

Supported Payment Gateways

​

1. Stripe

• Gateway Name: stripe
• Gateway Type: Bank Card (1)
• Features:
  • Auto-charge support for subscriptions
  • PCI DSS compliant
  • Global coverage
• Use Cases: Global SaaS products, subscription services

💡 Note: This is a partial list. The complete list of supported payment types can be found in the gateway setup interface or via API.

⚠️ Important: Before you can enable and configure payment types in UniBee, you must first enable the corresponding payment methods in your Stripe Dashboard:

1. Log in to Stripe Dashboard
2. Navigate to Settings → Payment methods
3. Enable the payment methods you want to offer to your customers
4. Only payment methods enabled in Stripe will appear and be available for configuration in UniBee

​

2. PayPal

• Gateway Name: paypal
• Gateway Type: Bank Card (1)
• Features:
  • Secure account-based payments
  • Supports PayPal account payments and linked cards
  • Supports 200+ countries and regions
• Use Cases: International e-commerce, subscription services

​

3. Payssion

• Gateway Name: payssion
• Gateway Type: Bank Card (1)
• Features:
  • Extensive coverage of localized payment methods
  • Supports multiple countries and regions
• Use Cases: Multi-region businesses requiring localized payment options

💡 Note: This is a partial list. The complete list of supported payment types can be found in the gateway setup interface or via API. Payssion supports 100+ payment methods across different countries.

⚠️ Important: To enable Payssion payment types, you need to contact Payssion’s business team:

1. Visit Payssion website and contact their business team
2. Provide your business information (company name, website, expected transaction volume, etc.)
3. Request activation for the specific payment types you need
4. After Payssion enables the payment types for your account, they will become available for configuration in UniBee

​

4. Alipay

• Gateway Name: alipay
• Gateway Type: Bank Card (1)
• Features:
  • Popular in China and Asian markets
  • Supports multiple Alipay payment types
• Use Cases: Businesses targeting Chinese and Asian markets

💡 Note: This is a partial list. The complete list of supported payment types can be found in the gateway setup interface or via API.

⚠️ Important: To use Alipay payment types, you need to:

1. Register an Alipay merchant account: Visit Alipay Global Merchant Services or contact Alipay’s merchant services team
2. Complete merchant verification: Submit required business and company documentation for account verification
3. Apply for payment types: Request activation for the specific Alipay payment types you need based on your business requirements
4. Once your Alipay merchant account is approved and payment types are activated, they will be available for configuration in UniBee

Note: The application process may vary depending on your region and business type. Contact Alipay support for the latest requirements.

​

5. Changelly

• Gateway Name: changelly
• Gateway Type: Cryptocurrency (2)
• Features:
  • Cryptocurrency payment processing
  • Real-time exchange rate conversion
  • Supports various cryptocurrencies
• Use Cases: Cryptocurrency-focused businesses

​

6. Unitpay

• Gateway Name: unitpay
• Gateway Type: Bank Card (1)
• Features:
  • Payment gateway for Russia and CIS markets
  • Supports various payment methods for the region
• Use Cases: Businesses targeting users in Russia and CIS countries

​

7. Wire Transfer

• Gateway Name: wire_transfer
• Gateway Type: Wire Transfer (3)
• Features:
  • Bank wire transfer payments
  • Suitable for large-amount payments
  • Manual confirmation required
  • May require minimum payment amount
• Use Cases: B2B subscriptions, enterprise customers, large transactions

​

8. Alipay+

• Gateway Name: alipay+
• Gateway Type: Bank Card (1)
• Features:
  • Enhanced Alipay payment solutions
  • Supports multiple Alipay payment types
  • Popular in China and Asian markets
• Use Cases: Businesses targeting Chinese and Asian markets with advanced Alipay features

​

9. FireKassa

• Gateway Name: firekassa
• Gateway Type: Bank Card (1)
• Features:
  • Payment gateway services
  • Supports various payment methods
• Use Cases: E-commerce and online businesses

​

10. MulenPay

• Gateway Name: mulenpay
• Gateway Type: Bank Card (1)
• Features:
  • Payment processing services
  • Supports various payment methods
• Use Cases: Online payment processing

​

11. Blockonomics

• Gateway Name: blockonomics
• Gateway Type: Cryptocurrency (2)
• Features:
  • Bitcoin payment processing
  • Direct Bitcoin payments
  • No intermediaries
• Use Cases: Cryptocurrency-focused businesses, Bitcoin payment acceptance

​

Gateway Payment Type Structure

​

How to Query Gateway Payment Types

curl --location --request GET "$UniBee_API_Host/merchant/gateway/list" \
  --header "Authorization: Bearer $UNIBEE_API_KEY" \
  --header 'Content-Type: application/json'

{
  "code": 0,
  "data": {
    "gateways": [
      {
        "gatewayId": 25,
        "gatewayName": "stripe",
        "gatewayType": 1,
        "setupGatewayPaymentTypes": [
          {
            "name": "Visa",
            "paymentType": "visa",
            "category": "card",
            "countryName": "Global",
            "autoCharge": true
          },
          {
            "name": "Mastercard",
            "paymentType": "mastercard",
            "category": "card",
            "countryName": "Global",
            "autoCharge": true
          }
          // ... more payment types
        ]
      }
      // ... more gateways
    ]
  }
}

​

Configuring Payment Gateways and Payment Types

​

Accessing Gateway Configuration

1. Navigate to Configuration → Payment Gateways in the UniBee Admin Portal
2. You’ll see a list of all available payment gateways with their current status:
   • Ready (green badge): Gateway is fully configured and ready to use
   • Not Set (gray badge): Gateway needs to be configured

​

Gateway Configuration Features

​

1. Gateway List Management

• See all available payment gateways in a list view
• Each gateway shows its logo, name, display name, and description
• Status indicator shows whether the gateway is ready or needs setup

• Reorder gateways by dragging and dropping items in the list
• The order determines how payment options appear to customers
• Changes are saved automatically

• Click “Set up” button for new gateways to configure them
• Click “Edit” button for configured gateways to modify settings
• Gateway logos can be clicked to visit the gateway’s official website (if available)

​

2. Essentials Configuration Tab

• Set a custom display name that customers will see
• This name appears in the payment selection interface

• Upload gateway icons/logos (up to 5 icons)
• Supported formats: .png, .jpg, .jpeg, .svg
• Maximum file size: 2MB per icon
• Drag and drop to reorder icons
• Icons are displayed in the customer-facing payment selector

• Configure exchange rates for different currency pairs
• Set conversion rates from base currency to target currency
• Add multiple exchange rate configurations
• Useful when gateway supports different currencies than your base currency

​

3. Public/Private Keys Configuration Tab

• Enter your gateway’s public key (also called API key or publishable key)
• Keys are automatically desensitized (masked) after saving for security
• Required for most payment gateways

• Enter your gateway’s private/secret key
• This is sensitive information and will be masked after saving
• Required for payment processing

• Select which specific payment types to enable for this gateway
• Use multi-select dropdown to choose from available payment types
• Each payment type shows:
  • Display name
  • Payment type identifier
  • Supported country/region
• Only selected payment types will be available to customers

• Stripe (stripe): Supports various card types and payment methods
• Payssion (payssion): Supports numerous localized payment methods across different regions
• Alipay (alipay): Supports various Alipay payment types and methods

​

4. Webhook Keys Configuration Tab

• View the webhook endpoint URL provided by UniBee
• This URL needs to be configured in your gateway’s dashboard
• Copy the URL using the copy button

• Enter the webhook secret/key from your gateway
• Used to verify webhook requests from the gateway
• Some gateways provide integration links for easy setup

• You must configure Public/Private Keys first before setting up webhooks
• Follow the gateway’s documentation link (if provided) to complete webhook setup

​

5. Wire Transfer Configuration

• Set the minimum payment amount for wire transfers
• Amount is specified in your selected currency

• Account Holder: Name of the account holder
• BIC (Bank Identifier Code): 8 or 11 characters
• IBAN (International Bank Account Number): Up to 34 characters
• Address: Bank address

​

6. Advanced Configuration Options

• Archive gateways that are no longer needed
• Archived gateways won’t appear in customer payment options
• Can be restored later if needed
• Available via API: Payment Gateway Archive API

• Configure gateway availability by country
• Enable or disable gateways for specific countries
• Available via API: Payment Gateway Country Config Edit API

​

Configuration Workflow

1. Initial Setup:
   • Click “Set up” on a gateway
   • Start with Essentials tab to configure display name and icons
   • Move to Public/Private Keys tab to enter API credentials
   • Select payment types (if gateway supports multiple types)
   • Configure Webhook Keys (if required by the gateway)
2. Verification:
   • After saving, check if gateway status changes to “Ready”
   • Test payments using sandbox/test mode before going live
3. Ongoing Management:
   • Use “Edit” button to update any configuration
   • Drag and drop to reorder gateways for better customer experience
   • Monitor gateway status and update credentials as needed

​

API Configuration

• Payment Gateway Setup API: Create or update gateway configuration
• Get Payment Gateway List API: Retrieve all configured gateways
• Get Payment Gateway Setup List API: Get detailed configuration list
• Edit Payment Gateway Sort API: Update gateway display order
• Payment Gateway Archive API: Archive/unarchive gateways
• Payment Gateway Country Config Edit API: Configure country-specific settings
• Wire Transfer Setup API: Configure wire transfer accounts
• Wire Transfer Edit API: Update wire transfer configuration