Payment Processors

Open Sky Commerce supports four payment processors: Stripe, Authorize.net, Clover, and Square. Only one is active at a time. You switch between them from the admin panel under Settings → Payment.

Stripe

Stripe is the default processor. It uses Stripe Elements (React Stripe JS) for a fully hosted card form.

Required Keys

STRIPE_PUBLISHABLE_KEY=pk_live_...
STRIPE_SECRET_KEY=sk_live_...
STRIPE_WEBHOOK_SECRET=whsec_...

Webhook Setup

Create a webhook in your Stripe dashboard pointing to:

https://yourstore.com/api/webhooks/stripe

Subscribe to the payment_intent.succeeded and payment_intent.payment_failed events.

Authorize.net

Uses Authorize.net Accept.js for PCI-compliant card data handling. The environment can be toggled between sandbox and production from the admin panel.

Required Keys

# Set these in the admin panel (stored encrypted in the database)
API Login ID
Transaction Key
Public Client Key

Clover

Clover processes online payments using an API access key and merchant ID. No point-of-sale hardware is required for web transactions.

Required Keys

# Set in the admin panel
Clover API Access Key
Clover Merchant ID

Square

Square uses the Square Web Payments SDK. You'll need your application ID and location ID from the Square Developer dashboard.

Required Keys

# Set in the admin panel
Square Application ID
Square Location ID
Square Access Token

Switching Processors

1. Go to Admin → Settings → Payment.
2. Enter the credentials for the new processor.
3. Select it as the active provider and save.

The storefront checkout will immediately begin using the newly selected processor. No redeployment is required.

Security

All payment processor credentials are stored encrypted in the PaymentSettings database table. Secret keys are never returned to the client — they are read only on the server at transaction time.