MivaPay is an addon service for Miva Merchant which allows your customers to securely store their credit cards on your Miva Store. To sign up for MivaPay please contact us to speak with one of our sales consultants.
Your API keys can be found in you my.miva account. https://my.miva.com/
Once signed up, you will be given the following information:
All three of these will be needed to link your store to your MivaPay account. You can get your Merchant ID and API Keys from you my.miva account. You’ll get access to this account after completing signup for MivaPay. If you do not have access to your my.miva account, please contact firstname.lastname@example.org.
Once you have the API keys you will add them to Miva under the Payment menu, then the settings tab
Add your credentials and click update to save.
Note: The Base URL will be pre-set and this should not be changed.
MivaPay introduces the concept of “Payment Cards.” These are the card types (linked to MivaPay) you accept on your Miva Store. They also appoint an individual payment method and determine which Payment Gateway to use.
To configure your Payment Cards go to Payment -> Payment Method Rules tab, then click on the Payment Cards button
This will bring up a window where you can map each card type to a MivaPay supported payment method. Only payment gateways which support MivaPay will be allowed to be selected. These gateways include all the built in Miva Payment Gateways:
To edit the Payment Card Type select a row and click the edit button:
From the Drop Down choose the payment gateway and card type to map to the Payment Card Type.
Click the save icon to save. Repeat this step for all the Payment Card Types you wish to accept on your store.
This functionality is available in 9.0065.
In the Admin:
When you click on the tab it will open a new window and there you will see two new fields, "Allowable Prefixes" and "Allowable Lengths." Allowable Prefixes will show you what prefix each card type starts with. The Allowable Lengths will show you how many characters will be on each card.
In the 9.0065 update, Miva now automatically detects what credit card is being used by the numbers being entered. They no longer have to choose "Visa, MC, AE, or Discover." Instead of a drop down of multiple options showing up, your customers will only see "Credit Card." You can also choose to hide this section from view if you choose to.
When the customer goes to check out, it will show what type of card was used to complete the purchase.
Also, if you choose "Mastercard" and then on the next page enter a Visa number, Miva will automatically detect that the wrong card has been entered and will turn the card number field red and will not allow you to continue until you put a proper Master Card number in.
If it's checked, just "Credit Card" will show up at checkout.
You can login to your Customer Account and click on "Manage Saved Cards." There you will see the card you chose to save and can edit it if needed.
When you setup your Payment Card Types, these methods will appear in addition to your standard payment methods which do not use MivaPay. You can choose to accept both MivaPay and non MivaPay methods in your store, however in most cases you’ll want to hide your other Payment Methods and force your customers to use the MivaPay Methods.
For example: If you setup Visa as a Payment Card using MivaPay, you store will have 2 Visa payment methods. One for MivaPay and a second for the standard gateway you use. If you did not hide your old method, both would be shown to the customer.
You can do this by going into Payment -> Payment Method Rules. Edit your non MivaPay methods and check the box to “Exclude This Method Unless Permitted by Products.”
This checkbox will hide the payment method from displaying to your customers, unless explicity overwritten at the product level.
When your customer logs into their account, they will have a link view, edit and delete all their saved cards.
From here they will see a list of all their saved cards:
If they click the Add Credit/Debit card you will see the following screen:
This allows you to enter a new card number, select the card type and the billing address associated with the card. This screen pulls in any saved address you have within your address book or you can enter a new address.
Customers can edit any saved card by clicking the edit link next to each card. Everything can be edited about the card except the card number. If the card number needs to be edited, the card will need to be deleted and re-added.
If a customer is logged in to their customer account when checking out, they will have the ability to saved the card they use back to their account for future use. They will see a checkbox when entering their credit card.
If a customer has a saved card attached to their account and they are logged in, they will be presented with their saved cards as a payment option during checkout.
Their saved cards will appear in a drop down list. They can choose one of these or choose to enter a new card:
You have full control to add, edit or remove a customer's saved card right from the Miva Admin. Under each customer there is a new tab for Payment Cards. This is a list of all their saved cards.
You can select a record and edit it. Keep in mind the full card number is not viewable or editable. To change this value you need to delete the saved card and re-add it with the correct number.
You can also add a new card from this screen by clicking the add button on the right.
Miva has a built in tool to automatically email customers to update their card when their card is about to expire. Each customer will only get a single email notification.
There is a customizable email template which can be changed under Order Fulfillment -> Template Based Emails.
This email notification is controlled by a scheduled task. You can edit the settings for this scheduled task under Store Settings -> Scheduled Tasks Tab
Here there are settings to control how often the task runs (it runs once per day by default) and when to send the notification.
On the Email template settings itself there are settings to control when the email is sent and if it is sent to all expired cards or just those attached to a subscription.
If your setting up MivaPay on a 9.0006x or above store, all the template changes and item assignments should be done for you when your store was created. Any store that is upgrading to 9.0006 and wants to setup MivaPay they will need to follow the following steps:
Under Payment Settings -> Payment Method Rules Tab there is a button for “Payment Card Types”
This will bring up a window where you can map your MivaPay Card Types to a MivaPay supported payment gateway
After you configure your payment card types, you’ll need to “hide” the non-miva pay methods from displaying or else both sets of payment methods will display.
Under Payment Settings -> Payment Method Rules click on a MivaPay Method and set it to exclude the non MivaPay card type
Assign the paymentsettings item to the following pages:
Assign the mivapay item to the following pages:
Important, when you assign the MivaPay Item to each of the pages above, you also have to ensure the correct Mode is set.
CPEC - Payment Card: Edit
CPCA - Payment Card Add
Opay - Checkout
OSEL - Payment Methods For Each Loop
There is a new conditional that needs to be added to OSEL payment Methods foreach loop:
OPAY - Templaate Changes