Retail POS: MPPG Payments

Retail POS: MPPG Payments


Configuration in Admin

  1. Select Account > Stores, then select the Store for which the respective Payment needs to be enabled.
  2. Under the Store Settings section, enable the MPPG toggle.
  3. When you enable the MPPG credit card toggle, the MPPG details appear on the screen with the following fields: Customer CodeUsernamePasswordPayment Gateway and MCC.


  4. For Payment Gateway, select the processor TSYSFDMS or Worldpay.
  5. Click Save.
    1. The Save button will be available once all mandatory fields are filled in.

Configuration in Back Office

  1. The Payment Method MPPG Credit Card must be enabled in Back Office [under Settings > Payments > Payment Method].

  2. When Admin MPPG toggle is Enabled, the MPPG payment appears in Payment Settings under Store Settings.
    1. When Disabled, the MPPG payment won’t appear under Payment Settings.

  3. Under Payment Type in Add Payment method, the MPPG Credit Card payment type must be added.
  4. After selecting MPPG Credit Card as a Payment Method: you can configure the following fields:
    1. Mobile - Payment NameCodePriorityOpen Cash DrawerSale or Authorize Payment Type.
    2. Tablet - Payment NameCodePriorityOpen Cash DrawerSale or Authorize Payment TypeDebit, and Exempt Surcharge

Payment Surcharge

You can select and set up Surcharge Type in Payment Surcharge.

Surcharge

  1. You can set up a customized Surcharge Name to appear on the POS Receipt.
  2. You can set up a Surcharge Percentage for MPPG payment.


Service Charge

  1. Service Charge is calculated based on card type for MPPG payments.
  2. Service Charge applies to Debit Card and Credit Card based transactions in BO settings.
  3. You are able to enter the Service Charge Percentage for MPPG.
  4. Service Charge applies to both Auth and Sale.
  5. The Service Charge for MPPG payments will be automatically deducted from the card, based on the Service Charge configured by the customer.

Dual Price

  1. The Reward will apply when the paying via Cash.
  2. Provide the NameDual Price Percentage, and Dual Price Tax Type for MPPG payments.

Batch Settings

  1. Set the Enable Auto Batch toggle to YES (Enabled). Then enter the Time the Batch will automatically run.
    1. If you enable the Print Batch Report, then the Batch report will be printed after submitting the Batch.

  2. Batch Submit Device - Select the device used to process Batch payments, including MPPG.

  3. For Default Batch Payment, select MPPG Credit Card.
    1. MPPG Credit Card is an option only when the MPPG Payment toggle is enabled in the Admin page.

  4. On the Batch screen: MPPG related payments will appear, and MPPG appears as a Type dropdown option.


  5. All Offline transactions (including MPPG) will appear under Batch in BO. 
  6. Once Offline transactions are processed, all the processed transactions will be removed from the Batch screen under BO.
    1. If Offline transactions are available in multiple Nodes, all the Nodes must be online to process the Batch. If not, the Node only available in online will be batched.
  7. When the Process Offline button is clicked, the POS will not validate POS Online/Offline status, and a generic message will appear.
    1. Please make sure all terminals are Online to process the payments.
    2. If a specific terminal is Offline, then payments will not be processed.
    3. For Offline transactions, Process Batch will process the Offline payment and Batch them.

  8. Once you click Process Offline, the Offline receipts will be Processed and Batched, and the processed Offline receipts will disappear from the Batch screen. Checks taken in Online mode it will continue with the existing process.


Receipt

Note: The Receipt will support Star and Epson Printers and for both Text and Image. The following fields will be added to the receipt: Table & Seat Number, Server Name, Receipt Number, Transaction Type, Transaction Total, Transaction Currency, Transaction Number, Payment Type, Receipt Number, Masked Card Number, Date & Time, Card Holder Name, Card Name, Payment Type, and Auth No.


Managing the Payment

Hardware Settings

  1. In the Store's Admin settings, ensure the Payment Type MPPG is enabled (YES).

  2. On the Operations screen, select Hardware Settings.
    1. The Device Name is displayed in the Select A Bluetooth Card Reader section.
    2. When selecting the specific Device in POS, the device will be viewable as an option once it’s paired.

  3. Now you can select MPPG Credit Card payment for a sale, then you can either Swipe or Insert or Tap the Card on the terminal for processing the payment.


Payment

To Create a Sale
  1. Select the Payment  option.

  2. The Payment screen appears, where you can see all the Payment options enabled in Back Office (BO) settings.

  3. On the Card screen, there are options: ManualClear, and Process, with the Amount to be paid appearing. You can manually enter the Card details - or swipe or tap or insert the Card (EMV).
    1. If no device is connected, the ‘Card reader is not connected’ message will be displayed.

  4. After payment completion, the Show Digital Receipt screen will appear if enabled in BO.


  5. On the Digital Receipt screen, you can choose whether the Receipt Bill is to be sent via SMSEmail or Print. You can choose any one of the options then press Send Receipt.


  6. The Receipt will be sent based on the selection, then the Order screen appears.

  7. The Service Charge will apply to both Sale and Auth.

Sale

  1. When a Sale is placed, the Payment Request is sent to the Server and the Amount is credited to the Merchant.
  2. Under the Payment section, the Payment Method MPPG Sale appears only when the Payment Type is enabled for the Store.


  3. After selecting MPPG Sale as the Payment Method, click press Process Payment
  4. The Card screen appears, displaying the Amount to be paid - with options: CancelManualClear, and Process.
  5. Manually enter the Card details or swipe/insert the Card in the Magtek device (EMV) to complete the payment.

Auth

  1. While creating Payment Method such as MPPG Credit Card, set Auth as the Payment Type.
  2. When the Sale is placed, the Payment will go to the Batch screen and when Batch Submit is clicked, all payments will be processed.
  3. In the Payment section, MPPG Auth appears under Payment Methods when the Payment Type is enabled for the Store.


  4. After selecting MPPG Auth as the Payment Methodclick press Process Payment
  5. The Card screen appears, containing the Amount to be paid - with options: CancelManualClear, and Process.
  6. Manually enter the Card details or swipe/insert the Card (EMV) to complete the payment.
  7. If the Device is not connected, the message ‘Card reader is not connected’ appears.
  8. Service Charge will apply to both Sale and Auth.


Payment Scenarios

  1. Insert - Select Process. Insert the card in the card reader device then click Process. The payment will be processed on the card. 
  2. Swipe - Swipe the card in the card reader device slot. Payment will begin processing. 
  3. Tap - Tap the card and payment will start processing. If this fails, select the Manual method.
  4. Manual Card Details - After manually entering the Card details, click Process. The payment will be processed on the card.

Payment Success

When Process is clicked, the system will send a response to the server, which will respond that the Payment is processed (or not processed). 
  1. If processed: the payment will be added, and a Confirmation will appear.
  2. If not processed: the request will be cancelled, and you are returned to the Card screen.

Cancel

If Cancel (below the transaction loading graphic) is pressed while payment is processing, the system checks whether the payment request was successful.
  1. If payment is successful before the cancellation request: the payment will be included on the Check
  2. If payment failed or the Amount wasn’t processed: the payment processing should stop, and you are reverted to the Payment screen with message 'Cancelled by host'.


Time Out

If Process is pressed and Payment processing started but a Card wasn’t swiped or inserted: the system will check for a Time Out period of 2 minutes. After 2 minutes, the optional error message ‘TIMEOUT’ appears.


Void

  1. Void applies to both Sale and Auth.
  2. You can void the payment after it's completed. You must Delete the payment on the Payment screen and the full payment will be voided.
  3. Partial void is not possible. All payments on the Receipt must be deleted to void.

  1. After closing the Check, the Receipt will be under the Closed tab. You can reopen the Receipt and select Void. You are redirect to the Payment page where the message ‘Payment made on this check. Can you return this to [Customer Name]’ appears.
  2. If Manual Submit is enabled, the Receipt will not close and the system will redirect to Payment from there you can delete the payment and void the receipt.
  3. If a customer would like to remove an item from an unpaid Order, press Void. The message ‘All orders are voided’ appears and retail items on the receipt will be voided.
  4. If the Order has already been sent to the Kitchen, press Void. TheVoid Reason pop-up appears, containing Reasons previously defined in BO. You can select any one of pre-defined Reasons, or manually type in Void Reason.
  5. After providing the Void Reason and pressing Add, the Retail Item(s) will be voided.


  6. Void applies to both Sale and Auth.

Batch

You can complete the Auth transaction by clicking Submit Batch.
  1. On the Batch screen: all the successful and offline transactions appear.
  2. MPPG Auth payments will appear on the BO Batch screen for batching.
  3. When the value is chosen in the Batch Submit Device in Back Office and you attempt to submit the MPPG Batch from the same Node, you will be able to submit the Batch without any intervention.
  4. When a Batch Submit Device is assigned in BO and you attempt to submit the MPPG Batch from a different Node, the warning message 'MPPG default batch device has been set to – [node]! Try batch device from specified device' appears.


Auto Batch

  1. After setting the Auto Batch Time in BO, all the successful payments will process, including offline transactions on the Batch screen. 
  2. Auto Batch is available for MPPG payments.

Manual Batch

You must manually click Submit Batch.
  1. If there are offline transactions, you must first click Process Offline.
  2. Once all offline receipts are processed, then click Submit Batch and the rest will be processed.
  3. If Submit Batch is selected before processing offline receipts, the message ‘Run Process offline before batch’ appears.
  4. Under Default Batch PaymentMPPG is included only when the MPPG Payment toggle is enabled in Admin. You can select MPPG as the Default Batch Payment in BO.
  5. On the Batch screen, MPPG related payments appear along with MPPG as the Device.
  6. If the Batch is processing, the Submit button at the bottom of the screen will be disabled and the loading graphic will be displayed until the batch completes.

Batch Settle Date & Status

On the Batch screen: the Settle Date and Status of the Batch will appear at the bottom-left of the screen.


Batch Status

The below statuses will appear on the Batch screen:
  1. Batch Completed
    1. After the batch is processed, the Batch Completed status will appear at the bottom of the screen.
    2. The header Last Batch Started appears - with the Batch transaction's DayDate and Time appearing below it, and the Status of the Batch below that.
    3. The Batch Completed status will appear in green.


  2. Batch In Progress
    1. If the Batch is processing, the Batch in Progress status will appear at the bottom of the screen.
    2. The header Last Batch Started appears - with the Batch transaction's DayDateTime, appearing below it, and the Status of the Batch below those. 
    3. Batch In Progress status will appear in green.


  3. Batch Incomplete – Resubmit Batch
    1. If the batch processing is incomplete, the Batch incomplete – Resubmit Batch status will appear at the bottom of the screen.
    2. The header Last Batch Started appears - with the Batch transaction's DayDateTime, appearing below it, and the Status of the Batch below those. 
    3. Batch incomplete – Resubmit Batch status will appear in red.


  4. Note: The Date and Time format configured in BO will be reflect on the Batch Settle Date. The Batch Status will appear for MPPG and Tempus payments.

Refunds

Refund

A sale was placed on a performed Close Day and the Customer wants a Refund on the payment.
  1. Navigate to the Closed Receipt screen.
  2. Enter the Receipt's Date and/or Receipt Number.
  3. Press Search, and it will appear.
  4. Select the Receipt then press Return. The receipt will be opened, and select Refund Item or Refund All to refund a single item or a whole receipt.
  5. On the Refund pop-up that appears with the following information:

    1. Refund Reason.
    2. The Amount to be refunded (with the number pad).
    3. The Customer (add if necessary).
    4. The Return By options.

  6. After providing a Reason, select the Payment. A pop-up with the message ‘Do you want to refund?' and Yes and No options appears.
    1. If you select Yes, the ‘Refund Success’ confirmation pop-up appears.
    2. If you select No, you remain on the same screen.
    3. If a Refund has already been issued, the message 'Receipt is already refunded’ appears.

  1. This also applies to Exchange and Layaway.


Offline Transaction

When the network is unavailable but the Allow Offline Payment toggle is enabled, making a Sale and processing the Payment will automatically enable the Offline Mode toggle. 

If the Allow Offline Payments toggle is enabled and Offline Mode is disabled:
  1. If the network went to an offline state during payment processing, the device automatically moves to Offline Mode as the Offline Mode toggle was automatically enabled and payment will be taken offline, and the following notification appears at the bottom: ‘Your device is offline. Payments will be taken in offline mode. Make sure to authorize your offline payments Next network connectivity check will be done after 15mins’.


  2. During payment processing: if there is any network failure, the offline payment will be processed and the sale Payment will go into Batch. The below scenarios outline payment processing conditions:

    1. If Allow Offline Payments is disabled and Offline Mode toggle is disabled, the system will not be able to take any offline payments.
    2. If Allow Offline Payments is enabled and Offline Mode toggle is enabled, the following notification appears: ‘Your device is offline. Payments will be taken in offline mode. Make sure to authorize your offline payments Next network connectivity check will be done after 15mins’.
    3. If Allow Offline Payments is disabled and Offline Mode toggle is enabled, the following notification appears: ‘Your device is offline. Next network connectivity check will be done after 15mins’. Payments will not be processed no offline receipt will be processed but remaining offline functionality will work.

  3. When the system comes back online: payments taken in offline mode will be noted by light red highlight, which indicates these Checks must be processed offline and then batchedFailure transactions are marked by a dark red highlight.

  4. When there are offline transaction Checks, click Submit Batch. The system will display a pop-up with the message ‘Run Process offline before batch’.

  5. When Process Offline is pressed, any successful transactions (those without a colorized highlight) can be batched. If all the offline transactions are processed and there are no Checks to be processed offline, then the Process Offline button will be greyed out.

  6. Once the offline process is completed, you can Submit the Batch for other Checks.
    1. Offline transactions don't allow for Tip adjustment.

  7. After the Device comes online, the Receipt must be visible on the BO Batch screen.

  8. For processing offline Checks: all nodes must be in online mode. Otherwise, the POS will process only the specific Node Receipts which are online.


Tokenization

Navigation: Log into the BO for your Store then select Settings > Store > Payments

In Back Office, you must configure the Service Type for Tokenization in Payment Settings.
  1. When Tokenize the Credit Card Toggle is set as No, the card details will not be saved under customer profile.
  2. When Tokenize the Credit Card Toggle is set as Yes, the card details will be customer profile. 



Implementation in POS

  1. After placing an Order: on the Payment screen select MPPG payment method and pay using Card in Magtek devices.
  2. Attach a customer to the Order. A Search bar is available to search customer.
  3. If the customer uses new card for Payment, a pop-up with the message 'Do you want to Tokenize your card' with Yes and No options.
    1. If Yes, card details should be attached to the customer. In Customer profile screen under the credit card tab the card number will be displayed as shown below.
    2. If No, payment will be made but the card will not be saved.
    3. If a Customer is not attached to the Order, but the user clicks Yes on the Tokenize pop-up: another pop-up appears for entering the Customer's details.

      1. First Name
      2. Last Name
      3. Phone Number
      4. Email
      5. Click Save button customer details will be saved & attached to the order.
        1. If Cancel, the pop up will be closed.
        2. If Save, without providing Phone number and Email, the error message 'Enter Email ID or Mobile number' appears.

  4. Once again, the same customer orders and makes payment using the same card. The Choose Card pop-up appears which displays all saved cards.


  5. If the same customer orders and make payment using different card which is not saved in customer profile, the 'Tokenize' pop-up appears with Yes and No options.
    1. If Yes, card will be saved for the customer.
    2. If No, payment will be made & card will not be saved.

  6. When the same customer orders and makes payment by any one of the saved cards. On the Choose Card pop-up: all cards including the most recently added one appears, and you can select any one of the cards to make payment by clicking Pay.

  7. When customer clicks the New Card button, they must swipe the card again, the 'Tokenize' pop-up appears with Yes and No options and the process continues as shown above.

  8. There is no restriction on the number of cards that can be added to a Customer's profile.




Receipts

  1. The below Receipts are supported for Star and Epson Printers and for both Text and Image.
  2. Only the last digits of the Credit Card used for payment will be displayed on receipts.
  3. These Receipts apply to FrontendMerchant CopyCustomer Copy and Itemized receipts.

Template 1


Template 2



Refund All



Refund 1 Item



Exchange



Void Template 1



Void Template 2

    • Related Articles

    • Retail POS: SPPax Payments

      Back Office (BO) BO Admin Requirements Navigation: Log into BO then select Admin > Stores Under Admin Store(s): When enabling the SPPAX toggle (setting to Yes), the SPPAX Details screen appears. Enter the mandatory details (pax device serial number) ...
    • Retail POS: Tokenization

      Back Office In Back Office, you must configure Service Types for Tokenization in Payment Settings. Navigation: Log into the Back Office for your Store, then select Settings > Payments > Payments For the Tokenize The Credit Card toggle: If enabled ...
    • Retail POS: Customer Display Hardware Settings

      On the Hardware Settings screen, select the Card Reader tab. The screen displays the device name of the Customer Display which is connected to the POS. Back Office License Settings Navigation: Log into Enterprise, then select Settings. Under Licenses ...
    • Retail POS: Operation - Batch

      In POS, select Operation then Batch. User Dropdown The User dropdown contains a list of users (employees), allowing you to choose a specific User from the list. Once a User is selected, you can view a list of transactions carried out by that selected ...
    • Retail Back Office: Payment Method Settings

      Navigation: Sign into the Back Office for your Retail Store. On the left-side Navigation Panel, click Settings. On the Settings page, under Payments click Payment Method. The Payment Method page displays a table of Payment Methods that were created ...