Overview of Credit Card Payment Processing in Digital StoreFront …documents.staples.com/ASP1/documentation/en/pdf/Digital... · 2015-05-28 · Overview of Credit Card Payment Processing
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Overview of Credit Card Payment Processing in Digital StoreFront
Integrating credit card payment processing with your web storefront will streamline your e-commerce workflow from order placement through checkout. Digital StoreFront currently supports hosted payment gateways (CyberSource Secure Acceptance, PayPal Payflow Link) and non-hosted payment gateways (PayPal Payflow Pro, PayPal Payments Pro, Ogone, WPM, iPay 88, PX Pay, Braspag-Pagador). This document provides an overview of payment processing in Digital StoreFront and addresses frequently-asked questions (FAQs).
General Overview of Credit Card Workflow for Hosted Payment Gateways (PayPal Payflow Link and CyberSource Secure Acceptance)
2 EFI Digital StoreFront | Digital StoreFront Credit Card Payment Workflow
General Overview of Credit Card Workflow for Non-Hosted Payment Gateways
Integrated Payment Gateways
Before setting up your merchant account in Digital StoreFront, you will need to establish an account with one of the payment gateways Digital StoreFront supports (if you have not already done so).
CyberSource Secure Acceptance For more information on CyberSource, contact CyberSource at: http://www.cybersource.com/contact_us/.
PayPal Payflow Link When Payflow Link is being used, all credit card and shipping address information will be entered on the Paypal web site. Digital StoreFront does not handle entering information and does not make the call to do the credit card authorization. Instead, Digital StoreFront redirects to the Paypal/Payflow Link URL and
allows buyers to enter their information. Paypal then redirects the buyer back to the Digital StoreFront site to complete the order. For more information on PCI compliance with Payflow Link visit:
To establish your Payflow Link account, visit: https://www.paypal.com/us/webapps/mpp/payflow-compare-pricing.
PayPal Payflow Pro When you use Payflow Pro, all credit card information is entered on the Digital StoreFront site on a Digital StoreFront page. Digital StoreFront thus handles securing the page and makes the method calls to the PayPal API to do the authorization.
To establish your Payflow Payflow Pro account, visit: https://www.paypal.com/us/webapps/mpp/payflow-compare-pricing.
PayPal Payments Pro
Note PayPal Payments Pro is called Website Payments Pro in Digital StoreFront.
To establish your PayPal Payments Pro account, visit: https://www.paypal.com/us/webapps/mpp/paypal-payments-pro.
Ogone
Note Ogone has changed its name to Ingenico.
To establish your Ogone e-commerce account, contact Ogone (via the contact information for your country on the Ogone Payment Services corporate web site at http://www.ogone.com.
WPM
For more information on WPM's complete line of payment products and services, visit the WPM corporate web site at http://www.wpmeducation.com or http://www.wpmsoftware.com.
For information on WPM's online payment systems and online store solutions tailored specifically for educational institutions, visit http://www.wpmeducation.com/ or contact WPM by phone at +44 (0) 844 264 1580.
PX Pay If you are interested in integrating a PxPay merchant account with Digital StoreFront, please contact EFI technical support by email at [email protected]. EFI Professional Services will assist you in setting up and configuring your site with a Px Pay merchant account. For more information on PxPay merchant services, please visit http://www.paymentexpress.com/technical_resources/ecommerce_hosted/pxpay.html.
iPay88 For more information on iPay88 gateway services, contact iPay at: http://www.ipay88.com/.
Braspag-Pagador For more information on Pagador gateways services, contact Braspag-Pagador at: http://www.braspag.com.br/pagador-braspag/.
Setting Up Merchant Accounts in Digital StoreFront
After establishing an account with your preferred payment gateway provider, you will set up the merchant account (to integrate with it) in Digital StoreFront. Credit card transactions and merchant accounts are managed on the Credit Card Management and Configuration page (accessed by selecting Administration > Credit Card Management and Configuration from the Administration home page) shown below:
The administrator sets up the merchant account details on the administration side of Digital StoreFront. The image below shows the screen where the administrator defines Merchant Account details:
Buyer Order Workflow
1. The buyer enters credit card details in the browser when ordering a product from a Digital StoreFront site.
2. The credit card details are sent from the buyer’s browser to Digital StoreFront via an SSL-encrypted connection.
3. The payment manager in Digital StoreFront retrieves the credit card details from the sent from the buyer’s browser and transmits them to the credit card gateway (e.g., Cybersource, Payflow Pro) for authorization of the order amount.
4. If the authorization is successful, the buyer is permitted to complete placing the order.
5. Digital StoreFront then stores the transaction ID (that does not contain any of the credit card details) in the database for future reference.
6. The diagram below illustrates at a high level the interactions between the buyer, Digital StoreFront, and the credit card gateway:
6 EFI Digital StoreFront | Digital StoreFront Credit Card Payment Workflow
Technical Notes on Data Exchange between Digital StoreFront and the Credit Card Gateway
The credit card details provided by the buyer are processed in the Digital StoreFront application
domain and are not persisted either in the database or file system.
The transaction ID returned by the credit card gateway is the only reference between the order, the
buyer, and the merchant account, and this reference cannot be retrieved by Digital StoreFront at
any time.
The data exchange between Digital StoreFront and the credit card gateway is on an SSL-encrypted
connection.
The payload is defined as a strongly-typed XML document.
The delivery mechanism is XML-based.
Operator Workflow
1. When the order is ready to be shipped, the operator changes the order status in Digital StoreFront to “Shipped.”
2. The payment manager in Digital StoreFront retrieves the transaction ID for the order and contacts the credit card gateway for capturing the order total from the buyer’s credit card.
3. The credit card gateway returns a status (success or failure), which changes the order status to “Shipped.”
4. The diagram below illustrates at a high level the interactions between the operator, Digital StoreFront, and the credit card gateway.
Major Credit Card Payment Processing Tasks in Digital StoreFront
Task What it means and how it works in Digital StoreFront
Authorization Authorization is the process by which Digital StoreFront routes a request through the
payment gateway to ensure that the buyer’s credit card has sufficient funds to pay for
the order. Your gateway/merchant account holder sends a request to the bank that
issued the buyer’s credit card to verify that funds are available. Authorization typically
takes less than three seconds. If a charge is authorized, the authorization remains valid
for a period set by your payment processor (i.e., CyberSource or PayPal) and places a
hold on the buyer’s credit limit for the authorized amount (i.e., the order amount plus $15 or 10% percent of the order amount—whichever is greater).
Note: Contact your payment processor for information on how long (1) the hold remains on the buyer’s account, and (2) the authorization remains valid.
Note: If an order is marked “Shipped” after the hold period expires, the order will fail
with an error message (check the Event Log for details) and capture will not occur. You will then have to contact the buyer to resolve the order.
In Digital StoreFront, Authorization is triggered (1) when the buyer clicks the Place My
Order button for a priced item that the buyer has opted to pay for via credit card, or (2)
when the buyer approves the price quoted for a manual quote that the buyer has opted
to pay for via credit card. Digital StoreFront always request authorization for the Order
Amount + additional amount of $15 or 10% of order amount (whichever is higher). If
changed amount is within this authorized amount limit we can always capture that
amount. This “buffer” amount covers taxes, shipping, and various other incidental charges that can cause the actual order charge to exceed the order amount.
Capture Capture releases the actual order amount (may not be equal to the authorized amount)
so you get paid at Settlement. In Digital StoreFront changing the status of an order paid
by credit card to “Shipped” in the Order View or Operator View. This settles the order
and transfers the funds to your merchant account. In order for capture to occur, all line items in a multi-line order must be marked “Shipped.”
Note: If your site is integrated with an MIS, credit card capture works the same way:
When the order status is changed to “Shipped,” the credit card is charged for the order amount.
Settlement
Settlement occurs when a transaction is processed between a merchant account
provider and the bank that issued the buyer’s credit card. When capture occurs
(payment is made for a sale), funds are transferred from the issuing bank/card association to your merchant account or PayPal account.
Cancel
Voids a credit card payment transaction. The entire amount of an order may be voided
by bringing up the transaction detail and pressing the Credit This Order button. You
cannot re-void an order. When you cancel an order in Digital StoreFront, Digital StoreFront will attempt canceling the authorization as well.
Issue Credit Credits customer balance after a credit card payment transaction has been settled. If
you need to issue credit to a customer after a transaction has been settled (i.e., funds
have been posted to your merchant bank account), there are two ways to do this in
Digital StoreFront. Both apply to Payflow Pro and PayPal Payments Pro transactions whereas only one applies to CyberSource transactions.
Outside of these hours, you may leave a voice mail message and an on-call support representative will be paged. Response time is based on the severity of the issue.
Note For problems involving infrastructure (i.e., computers, networks, operating systems, backup software, printers, third-party software, etc.), contact the appropriate vendor. EFI cannot support these types of issues.
EFI Professional Services can help you perform EFI software installations, upgrades, and updates. This group can also help you implement, customize, and optimize your EFI software plus offer a range of training options.