Stores and Connected Apps Integration

The Stores module integrates with Connected Apps to enable credit card payment processing through third-party payment gateways. When configuring storefronts with Credit Card checkout, administrators must first establish gateway credentials in Connected Apps, which provide the secure API connection between Magentrix storefronts and payment processing providers. This integration enables real-time payment authorization, transaction processing, and secure handling of customer payment information.

Integration Overview

Stores and Connected Apps integration enables storefronts to process credit card payments securely through established payment gateway providers, authorize transactions in real-time during customer checkout, capture payment information without storing sensitive card data in Magentrix, and generate transaction records for order tracking and reconciliation.

Integration benefits:

For customers:

• Complete purchases using major credit cards directly within the storefront
• Experience seamless checkout without redirecting to external payment pages
• Receive immediate order confirmation upon successful payment
• Trust secure payment handling through established payment providers

For administrators:

• Configure payment processing without custom development
• Select from multiple supported payment providers
• Manage gateway credentials centrally in Connected Apps
• Track transaction references in order records

For organizations:

• Accept online payments through trusted gateway providers
• Leverage existing merchant account relationships
• Maintain PCI compliance through provider-managed payment handling
• Support multiple storefronts with shared or distinct gateway configurations

Supported Payment Providers

Magentrix storefronts support the following payment gateway providers:

Authorize.Net

Authorize.Net is a widely-used payment gateway supporting credit card and electronic check processing. Integration requires API Login ID and Transaction Key credentials from your Authorize.Net merchant account.

Supported features: Credit card authorization, capture, and refund processing

Card types: Visa, Mastercard, American Express, Discover, JCB, Diners Club

Stripe

Stripe provides modern payment infrastructure supporting credit cards and various payment methods. Integration requires API keys (publishable and secret) from your Stripe dashboard.

Supported features: Credit card processing with advanced fraud detection

Card types: Visa, Mastercard, American Express, Discover, JCB, Diners Club

Moneris

Moneris is a Canadian payment processor offering credit card processing for businesses in Canada and the United States. Integration requires Store ID and API Token credentials.

Supported features: Credit card authorization and capture

Card types: Visa, Mastercard, American Express, Discover

PayPal Express Checkout

PayPal Express Checkout enables payment through PayPal accounts and credit cards processed through PayPal. Integration requires API credentials from your PayPal business account.

Supported features: PayPal balance and linked card payments

Card types: Cards linked to PayPal accounts

Prerequisites

Before configuring payment gateway integration, ensure the following prerequisites are met:

Merchant Account Requirements

• Active Merchant Account: An active account with your chosen payment provider
• API Credentials: API keys, tokens, or login credentials required for gateway connection
• Production Access: Production (not sandbox/test) credentials for live payment processing
• Supported Currencies: Merchant account configured for currencies matching your storefront

Connected Apps Access

• Administrator Permissions: Administrator System Role required to configure Connected Apps
• Connected Apps Module: Access to Setup > Connected Apps configuration

Configuring Gateway Credentials

Gateway credentials must be configured in Connected Apps before they can be selected in storefront settings.

Accessing Connected Apps

1. Navigate to the Setup Home page
2. Click Connected Apps (or navigate through the appropriate menu path)
3. Locate or create the configuration for your payment provider

Creating Gateway Credentials

The specific configuration fields vary by payment provider:

Authorize.Net:

• API Login ID
• Transaction Key
• Environment (Production/Sandbox)

Stripe:

• Publishable Key
• Secret Key
• Environment (Production/Test)

Moneris:

• Store ID
• API Token
• Environment (Production/Test)

PayPal Express Checkout:

• API Username
• API Password
• Signature
• Environment (Production/Sandbox)

Testing Gateway Configuration

After configuring gateway credentials:

1. Create a test storefront with Credit Card checkout
2. Select the configured gateway credentials
3. Add a test product with minimal pricing
4. Complete a test purchase to verify payment processing
5. Confirm the transaction appears in your payment provider's dashboard
6. Verify order records include transaction reference numbers

Configuring Storefront Payment Settings

After gateway credentials are established in Connected Apps, configure storefront checkout settings:

1. Navigate to the storefront Settings tab
2. In the Checkout Settings section, select Credit Card as the Checkout Method
3. Select the Payment Provider (Authorize.Net, Stripe, Moneris, or PayPal Express Checkout)
4. Select the Gateway Credentials configured in Connected Apps
5. Select Available Card Types the storefront will accept
6. Configure Store Currency matching your merchant account
7. Click Save

Payment Settings Fields

Checkout Method: Select Credit Card to enable payment gateway processing. Other options (Place Order, Redeem Points) do not require gateway configuration.

Payment Provider: Select the payment gateway provider matching your merchant account and configured credentials.

Gateway Credentials: Select the specific credential configuration from Connected Apps. Multiple configurations may exist for different merchant accounts or environments.

Available Card Types: Select which credit card brands the storefront accepts. Options include Visa, Mastercard, American Express, and Discover. Only selected card types are presented during checkout.

Store Currency: Select the currency for product pricing and payment processing. Ensure the currency matches your merchant account configuration to avoid processing errors.

Payment Processing Flow

Customer Checkout Experience

1. Customer adds products to cart and proceeds to checkout
2. Customer enters billing and shipping information
3. Customer enters credit card details (card number, expiration, CVV)
4. Customer confirms order submission
5. System sends payment authorization request to gateway
6. Gateway processes authorization with card network
7. Authorization response returned to Magentrix
8. If approved: Order is created and confirmation displayed
9. If declined: Error message displayed and customer can retry

Transaction Data

Successful transactions generate the following data:

• Transaction Number: Unique identifier from payment gateway, stored in order record
• Authorization Code: Approval code from card issuer
• Order Record: Complete order with payment status and reference

Transaction references enable reconciliation between Magentrix orders and payment provider records.

Security Considerations

Payment processing follows security best practices:

• No Card Storage: Magentrix does not store complete credit card numbers
• Secure Transmission: Payment data transmitted over encrypted connections
• Provider Handling: Sensitive card processing handled by PCI-compliant payment providers
• Credential Security: Gateway credentials stored securely in Connected Apps configuration

Multiple Storefronts and Gateways

Shared Gateway Configuration

Multiple storefronts can share the same gateway credentials when:

• All storefronts use the same merchant account
• Currency and card type requirements are consistent
• Transaction reporting can be consolidated

Separate Gateway Configurations

Create separate gateway credentials in Connected Apps when:

• Different storefronts require different merchant accounts
• Business units need separate transaction tracking
• Different currencies require separate merchant configurations
• Test and production environments need distinct credentials

Best Practices

Credential Management

Secure Storage: Never share gateway credentials outside of Connected Apps configuration. API keys and tokens provide full access to payment processing capabilities.

Environment Separation: Maintain separate credential configurations for test/sandbox and production environments. Clearly label configurations to prevent accidental use of test credentials in production.

Regular Review: Periodically review Connected Apps configurations to ensure credentials remain valid and unused configurations are removed.

Testing and Validation

Test Before Launch: Complete end-to-end payment testing before enabling storefronts for customer use. Verify successful authorization, order creation, and receipt delivery.

Test Card Numbers: Use payment provider test card numbers during development. Each provider publishes test card numbers that simulate various authorization responses.

Error Handling: Test declined card scenarios to verify appropriate error messages display to customers without exposing technical details.

Ongoing Operations

Transaction Monitoring: Regularly review transactions in both Magentrix orders and payment provider dashboards to identify discrepancies or issues.

Credential Rotation: Follow payment provider recommendations for credential rotation and security updates.

Provider Communication: Monitor communications from payment providers regarding API changes, security updates, or service modifications that may require configuration updates.

Troubleshooting

Issue: Gateway Credentials dropdown is empty in storefront settings

Solution: Gateway credentials have not been configured in Connected Apps. Navigate to Connected Apps and create credential configuration for your payment provider before returning to storefront settings.

Issue: Payment authorization fails during checkout

Solution: Verify gateway credentials are correct and use production (not test) credentials. Confirm the payment provider account is active and in good standing. Check that the store currency matches merchant account configuration. Review payment provider dashboard for detailed error information.

Issue: Credit card declined messages during testing

Solution: If using test credentials, use payment provider test card numbers rather than real cards. If using production credentials with real cards, verify the card is valid, has available credit, and is not blocked by the issuing bank.

Issue: Transaction completed but no transaction number in order

Solution: Check payment provider dashboard to confirm transaction was processed. If transaction exists in provider system but not in Magentrix, there may be a communication issue. Contact Magentrix support for investigation.

Issue: Currency mismatch errors during checkout

Solution: Verify the Store Currency setting matches your merchant account's configured currency. Some merchant accounts support only specific currencies. Update storefront currency or merchant account configuration to align.

Issue: Specific card types being rejected

Solution: Verify the card type is selected in Available Card Types for the storefront. Confirm your merchant account supports the card type. Some merchant accounts have restrictions on card brands they can process.

Related Documentation

• Creating Storefronts - Complete storefront configuration
• Managing Storefront Orders - Order management and transaction tracking
• Email Templates - Configuring receipt templates for order confirmation

Jump to Stores Module Checklist

<< Stores and Rewards Integration