Payment Processing
...
Payment Processing Stages
Authorization

Authorization Configurations

6min

System-wide Configuration

UpStart Commerce allows you to configure multiple Payment Service Providers (PSPs) for payment authorization. This configuration enables you to set up a robust payment processing system with failover capabilities.

Payment Service Provider (PSP) Configuration

When you set up a payment service provider in UpStart Commerce, you're essentially telling the system how to connect with a company that will process payments for your online store.

Document image


Here's a breakdown of what you'll need to set up, using a fictional payment provider called "SecurePay" as an example:

  1. Provider Name: This is simply what you call this payment setup. For example, "SecurePay Main Account".
  2. Your Store Details:
    • Store Name: "Cozy Home Furnishings"
    • Website: "cozyhome.com"
  3. Which of Your Online Stores Will Use This: You might have multiple online stores. You can choose which ones will use this payment method. For example, "Cozy Home US Site" and "Cozy Home Canada Site".
  4. SecurePay Account Details:
    • Account Type: "Test Account" (for trying things out) or "Live Account" (for real transactions)
    • Your SecurePay ID: Something like "CozyHome123"
    • Security File: A special file SecurePay gives you, like "CozyHome123.secret"
  5. How Important Is This Payment Method:
    • Priority: 1 (This means it's your first choice for processing payments)
    • Partial Payments: Yes (This allows customers to split payments if needed)
  6. Safety Net Settings: These help protect your store if there are problems with SecurePay:
    • Max Failures: 3 (If SecurePay fails 3 times in a row, stop using it temporarily)
    • Wait Time: 10 seconds (How long to wait for SecurePay to respond)
    • Cooldown Time: 15 seconds (How long to wait before trying SecurePay again after failures)
  7. Is It Ready to Use:
    • Turned On: Yes

You can set up multiple payment providers. If you do, the system will use them in order of priority. So if your number 1 choice has problems, it will automatically try your number 2 choice, and so on. This helps ensure your customers can always complete their purchases.

By configuring multiple PSPs with different priorities, you ensure continuous payment processing capabilities, enhancing the reliability of your e-commerce platform.

Pre-Order Functionality (Tenant-level)

Pre-order refers to a system for handling payment processing when a PSP is unavailable, not the traditional definition of ordering products before they're available.

This configuration enables you to decide if the system should create a pre-order if the PSP is unavailable during authorization. With pre-order enabled, if the PSP is not accessible, the customer's cart will be submitted, and the order will go into a queue. The queue will then process the payment attempt later when the PSP becomes available.

Curl


Here's an example of using pre-order functionality...

Imagine your primary PSP is down for maintenance during peak hours. A customer tries to purchase a limited-edition designer jacket from your store. If pre-order is enabled, the customer's order will still be submitted and placed in a queue, despite the PSP being unavailable. Once the PSP comes back online, the queued order will be processed automatically. This ensures you don't lose sales due to temporary PSP outages.

Queuing Scheduler Configuration

A queuing scheduler configuration to manage the processing of queued orders. This configuration defines the frequency at which the system processes queued payments. The cron pattern determines the schedule for processing, ensuring efficient handling of queued transactions.

Curl


Payment Set Restriction

Currently, UpStart Commerce doesn't allow using multiple PSPs for authorization if you're using Cybersource as your payment processor. You'll need to choose and configure a single Cybersource connection for authorization.