MOP Payments and Tips

Configure a Payment Gateway

MOP supports two payment gateways: Oracle Payments and Freedom Pay. Use the Payment Gateway drop-down list to select a gateway and display its configuration settings.

  1. Open Customize Experience, select Payments, and then select Payment Configuration.
  2. If no payment gateway is configured, use the configuration form to add one. To change an existing gateway, select Replace Gateway.
  3. In the Payment Gateway drop-down list, select Oracle Payments or Freedom Pay.
  4. Complete the required configuration settings for the selected gateway. For Oracle Payments, enter the following required fields: Merchant Account, Store ID, and API Key. For Freedom Pay, complete the gateway-specific fields displayed in the configuration form.
  5. Select Save, and then wait for validation and saving to complete.
  6. Review the configured payment gateway and verify that sensitive field values are correctly masked.
  7. Preview the configuration, and then select Publish to make the changes available to customers.

Configure Payment Options

Use Payment Options to configure the currency and payment methods available to customers during checkout.

  1. Open Payments, and then select Payment Options.
  2. If no payment gateway is configured, follow the prompt to open Payment Configuration and configure a gateway.
  3. Select an available currency.
  4. Add or edit the payment methods you want to offer.
  5. Resolve any payment methods that are incompatible with the restaurant’s country or selected currency.
  6. Save your changes as a draft.
  7. Preview the available payment methods, and then select Publish to make the changes available to customers.

At least one payment method must be active. Only payment methods supported in the restaurant’s country and compatible with the selected currency can be enabled.

Available card and digital wallet payment methods depend on the configured payment gateway (Oracle Payments or Freedom Pay) and the payment methods enabled for the restaurant.

After publishing, test each enabled payment method on a compatible customer device to verify that it works correctly.

Configure Tips

Use Tips to configure the tip options available to customers during checkout.

  1. Open Payments, and then select Tips.
  2. Enable tipping if you want to allow customers to add tips during checkout.
  3. Enter three suggested tip percentages.
  4. Enter a value between 0 and 100 for each percentage.
  5. Select Save Draft.
  6. Preview the tip options and order totals during checkout, and then select Publish to make the settings available to customers.

You can configure three percentage-based tip presets. The configuration does not support fixed-amount tip presets or selecting a default tip amount.

During checkout, customers can select a suggested tip percentage or enter a custom tip amount. For Simphony orders, the custom tip amount cannot exceed 100% of the order total, excluding the tip.

Configure Gift Cards

Use Gift Cards to configure gift card connections and enable gift card redemption during checkout.

  1. Open Customize Experience, select Payments, and then select Gift Cards.
  2. Select Add Gift Card Connection. To modify an existing connection, select Edit in the Gift Card Connected summary.
  3. Enter the following required connection details: Client ID, Client Secret, and Access Token URL issued for the gift card connection.
  4. Select Save, and then verify that the connection summary appears with sensitive values masked.
  5. Select Enable gift cards to allow customers to redeem gift cards during checkout.
  6. Preview the checkout experience, and then select Publish to make the settings available to customers.

To disable gift card redemption, deselect Enable gift cards, and then publish the updated settings.

The Enable gift cards option and gift card connection details are configured separately. Review both settings before publishing to ensure that gift card redemption is configured correctly.

Validate Gift Card Checkout

After enabling and publishing the gift card configuration, verify that customers can redeem gift cards during checkout.

  1. Open checkout, and then expand Gift Card.
  2. Enter the gift card number and PIN, and then select Apply Gift Card to verify the card.
  3. After the card is verified, enter the Amount to apply, and then select Apply.
  4. Review the applied amount, remaining gift card balance, and outstanding order total.
  5. If needed, add another gift card or remove an existing card using the corresponding remove action.
  6. Complete checkout using an available payment method for any remaining balance.

Customers can apply up to three gift cards to a single order. Each applied amount must be greater than zero, contain no more than two decimal places, and not exceed the available gift card balance or the remaining order total. Expired or fully redeemed gift cards cannot be used for payment.

Gift card redemption is not available when using Apple Pay or Google Pay. To verify gift card redemption, use another supported payment method.

This functionality supports redeeming gift cards toward an order but does not support purchasing, issuing, or reloading gift cards.

Validate Payment Recording

Place a test order using each enabled payment method. Verify that the payment is processed correctly and that the Simphony check, tender, tip, and service charge details are recorded accurately. Before using the configuration in production, confirm that each transaction appears in the merchant’s payment reports.