www.microsoft.com/dynamics/ax
Biplob Ghose, Program Manager
Table of Contents
Introduction ................................................................................................ 3
Credit Card Processing Feature Concepts .................................................... 3
Setting up Credit Card Processing ............................................................... 4
Security ............................................................................................................................... 4
Payment Services ................................................................................................................. 5
Payment Services for Microsoft Dynamics ERP ....................................................................... 5
Address verification............................................................................................................ 6
Card verification value ........................................................................................................ 6
Demo data ........................................................................................................................ 6
Set up Cards ..................................................................................................................... 7
Terms of Payment ................................................................................................................. 8
Customers ..........................................................................................................................11
Customer settings for address verification and card verification values .......................................14
Credit Card Parameters ........................................................................................................15
Sales Order setup ................................................................................................................16
Processing an authorization ...................................................................................................18
Processing an authorization with card verification values enabled ...............................................19
Processing an authorization ...................................................................................................20
Sales order ...................................................................................................................... 20
Sales Pickup (Will Call) ...................................................................................................... 21
Warehouse management ................................................................................................... 23
Creating a payment journal ................................................................................................ 23
Partial shipments .................................................................................................................23
Batch processing .................................................................................................................23
Merging sales orders ............................................................................................................23
Refunds ..............................................................................................................................24
Voiding an authorization .......................................................................................................24
Credit card issues ................................................................................................................25
Intercompany processing ......................................................................................................25
Appendix A................................................................................................ 28
Information provided in Level 2 data support ..........................................................................28
Information provided in Level 3 data support ..........................................................................30
2
CREDIT CARD PROCESSING
Introduction
Customers often pay invoices using one or more credit cards.
This paper describes how to automate the processes of authorizing a credit card amount at the time of
an order and then capturing the charge when the order is shipped and invoiced. It also provides an
overview of the development approach to use with credit card processing
This paper is intended for professionals who are involved in the implementation and support of the
credit card processing functionality at a customer site, as well as for those who need to advise
customers, or make modifications within the area.
Security
The following privileges are assigned to various duties and roles to ensure that credit cards are
processed by only authorized users in Microsoft Dynamics AX 2012:
Security Privilege
Modify the settings that control the credit card processing parameters
In all cases where the user can view credit card information, only the last four digits of the credit card
are shown.
4
CREDIT CARD PROCESSING
Payment Services
The Payment services form allows you to activate a payment services provider by providing logon
information and additional parameters. Credit cards cannot be processed unless one of the payment
services providers is set to Active.
5
CREDIT CARD PROCESSING
Address verification
You can use address verification as a criteria for accepting a credit card. Address information is always
sent to Payment Services for Microsoft Dynamics ERP. However, if you select the Address
verification check box, a transaction can be automatically voided if the address is incorrect.
Payment Services for Microsoft Dynamics ERP replies to the address verification request with a result
that indicates how accurate the address is. The value of the Address verification status required
to accept transaction field determines which action is taken. The result of the verification is
compared with the setting that you select. If the result is equal to or better than the value selected,
then the transaction is accepted. If you select the Void transaction when no results are available
check box, the credit card transaction will be voided when the result shows that address verification
was not available.
Demo data
You must sign up for Payment Services for Microsoft Dynamics ERP to demonstrate the credit card
feature. When Test mode is selected in the Payment services form, you can process transactions
for demo purposes without creating real transactions.
6
CREDIT CARD PROCESSING
Set up cards
Microsoft Dynamics AX2012 supports four credit card types: VISA, Master Card, American Express,
and Discover. Each of these card types has additional settings that control the credit card process. To
change these settings, click the Set up cards button on the Payment services form.
A credit card transaction is automatically posted to a cash journal when a transaction is complete.
However, a typical company may have different merchant accounts at the payment services provider.
To support this scenario, individual payment journals can be specified in the Credit card types form
for each type of credit card. In addition, credit card payments are credited to a merchant account and
are not received as cash immediately, so a credit cards receivable account should be used for the
journal. After the cash is received from the merchant, it can be reconciled against this account and
posted to a cash account.
To ensure that only valid currencies are used in sales order transactions, you must enter a list of
currencies that are supported by the payment services providers that you have selected. The default
currency is USD. You can add additional currencies.
The default data support value is Level 1, which represents basic information that is provided by
Microsoft Dynamics AX to Microsoft Dynamics Online Payment Services, such as transaction date,
transaction amount, and description.
Figure 4 shows the Credit card types form, with level 1 data support selected.
7
CREDIT CARD PROCESSING
Terms of Payment
In Microsoft Dynamics AX 2012, the Terms of payment form has been modified to identify the terms
of payment that will initiate credit card transactions.
8
CREDIT CARD PROCESSING
A new payment type called Credit card has been added in Microsoft Dynamics AX 2012. Figure 6
shows the Terms of payment form, with Credit card selected for Payment type. You can maintain
backward compatibility with certain earlier versions of Microsoft Dynamics AX by using a blank
payment type. A blank payment type does not use credit card functionality when it is selected for a
term of payment. By default, all terms of payment are assigned to a blank payment type during the
upgrade process.
9
CREDIT CARD PROCESSING
In Microsoft Dynamics AX 2012, a Credit check field has been added to allow you to bypass credit
limits when using a credit card. If a customer has exceeded their credit limit and you require the
customer to pay by cash or credit card, this field allows you to select the Bypass credit check value
to bypass the credit check. The Bypass credit check value will be used only when the payment type
is Credit card. The value Normal indicates that normal credit checks will be made when this term of
payment is used. To maintain backward compatibility with previous versions, the Normal value is
assigned by default during the upgrade process.
10
CREDIT CARD PROCESSING
Customers
Credit card information can be added to a customer account at any time before or during the sales
order process. To maintain security, all credit cards must be entered through a Credit Card Wizard.
To access the wizard, click the Credit card button in the Set up group on the Action Pane in the
Customer form or the Sales order form.
11
CREDIT CARD PROCESSING
When you click Credit card, the Customer credit cards form displays the existing credit cards for
the customer. You can add new credit cards or modify existing credit cards with this form. However,
the form does not allow you to directly modify the form. All changes must be made through the
Credit Card Wizard to increase the level of security provided by the application.
12
CREDIT CARD PROCESSING
The Credit Card Setup Wizard is a series of six pages that request cardholder information and the
credit card number. After you have completed the wizard, the credit card information will appear in
the Customer credit card form, and the credit card will be available for use in a sales order.
13
CREDIT CARD PROCESSING
Figure 11: Customer settings for address verification and card verification values
14
CREDIT CARD PROCESSING
Percent adds a percentage of the order amount before tax, up to the maximum amount, to the
authorization.
Fixed adds the Value setting to the authorization.
15
CREDIT CARD PROCESSING
The Credit card payment posting group defines the default settings that will be used when the
payment journal is posted after a credit card is accepted. To override the settings, select different
methods of payment on the Price and discount tab in the Sales order form.
The Data support setting identifies which dimension will be transmitted as the cost center when
using Level 2 or Level 3 data support.
16
CREDIT CARD PROCESSING
If a credit card does not exist for the customer, you can click the Register button in the Manage
group on the Action Pane to select Credit Card Wizard. After you have used the wizard to create a
credit card, the card number is automatically added to the order.
Figure 14: Selecting the Credit Card Wizard on the Sales order form
Note: If you have selected a currency, a method of payment, or a credit card payment posting setting
in the Accounts receivable parameters form that results in a currency that is not represented in
the Credit card types form, you will not be able to process the credit card with the payment services
provider.
17
CREDIT CARD PROCESSING
Processing an authorization
If the Credit card authorization check box is selected in the Accounts receivable parameters
form, the authorization will occur automatically when you post the picking list or packing slip. You also
can use the Credit card option in the Manage group on the Action Pane, and select Authorize to
authorize the credit card before sending the order to the warehouse for picking or packing.
18
CREDIT CARD PROCESSING
To open the Credit card history form to see the details of the authorization, click the Credit card
option on the Manage group on the Action Pane, and then select Authorization history on the
Sales order form.
19
CREDIT CARD PROCESSING
Processing an authorization
Credit cards are captured when an invoice is posted. There are three ways to post invoices that will
process the credit card:
Sales order
Sales pickup
Warehouse shipment
Sales order
A credit card is captured automatically when you post the invoice from the Sales order form. The
Infolog message shown in Figure 16 will appear when the credit card has been processed. An
additional entry will be added to the Credit card history form, noting the actual amount charged to
the credit card.
20
CREDIT CARD PROCESSING
21
CREDIT CARD PROCESSING
The Credit card tab allows the counter person to select a credit card for a customer when the
customer arrives. The credit card cannot be entered in this formit must already exist on the
customers account. When the invoice process is initiated, the credit card is captured, and if the card is
accepted, the invoice process is completed. If the card is declined, the process is stopped and a dialog
box is displayed with the decline information.
22
CREDIT CARD PROCESSING
Warehouse shipment
A button has been added to the Shipment form for credit card processing. The Process shipment
button is active when a credit card has been used for an order. Customers using a credit card payment
type often want an invoice included in the shipping package. The Process shipment button initiates
the invoice posting process, prints the invoice, and validates that the invoice can be posted. If a credit
card is involved, the credit card is processed. However, the invoice process will be stopped if the credit
card is not accepted.
Partial shipments
When a partial shipment is invoiced, the entire authorization is canceled and the credit card is
processed for only the amount of the partial invoice. Another authorization is then requested for the
amount remaining on the sales order. This cycle continues until the entire order has been invoiced.
Batch processing
Invoices that include credit cards can be posted using a batch. The batch log will include the same
information about the success or failure of the credit card that is shown in the Infolog message in
Figure 16.
23
CREDIT CARD PROCESSING
If the first order has a credit card on it, all the merged orders for the invoice account will be
consolidated into a single invoice and the entire amount will be charged. The authorization for the first
order will be used to process the card, and all authorizations for the remaining merged sales orders
will be voided. If the first order for the invoice account does not have a credit card on it but the
remaining merged orders do have a credit card, then the credit cards on those orders will not be used
and all authorizations will be voided.
Refunds
You can process refunds using the credit note functionality in Microsoft Dynamics AX. When you create
a credit note for a sales order that contains a credit card, the credit note is created and the credit card
information is obtained from the original sales order. Microsoft Dynamics AX recognizes that the credit
note is a refund and it processes the credit card transaction as a refund. You cannot process a credit
note as a refund unless the credit note is generated from an existing sales order.
Voiding an authorization
After you have authorized an amount, you may want to void that authorization. For example, a
customer may want to cancel the order. In addition, customers may change their mind and decide to
use another payment method.
You can void an authorization by changing the payment term. When you change the payment term,
the dialog box shown in Figure 22 appears. Click OK to void the authorization. You must always
perform this step before deleting a sales order, as well.
24
CREDIT CARD PROCESSING
Intercompany processing
Credit cards can be used in intercompany orders. When intercompany orders are automatically
invoiced, a credit card is captured during the invoice process. If the credit card is declined, the entire
intercompany invoice posting is stopped, just as if there were a posting failure. The order must be
invoiced again after the credit card issue is solved.
25
CREDIT CARD PROCESSING
Technical Information
The credit card processing feature is a framework for credit card processing. In this section, we
provide more details about the development approach and issues for the feature.
Payment services provider records are created when you open the Payment services provider form
for the first time. The settings for which providers are active and the settings for payment journals are
stored in the CreditCardProcessors table.
Each payment services provider has unique requirements for how you must connect to it and process
credit card transactions. Due to these requirements, the settings for each processor are stored in
separate tables.
Microsoft.DynamicsOnline.DOClientProxy.dll
Microsoft.DynamicsOnline.DOClientProxy.PaymentService.dll
Microsoft.DynamicsOnline.DOClientProxy.UserManagement.dll
The URLs that Microsoft Dynamics AX uses to communicate with the PSMDE web service and PSMDE
web pages for signup and account management are stored in the CreditCardMicrosoftSetup table.
Security
Two tables for the credit card processing feature contain sensitive information. These tables use the
table permissions framework (TPF) to limit access, however, we recommend additional security.
Although the AOS and the SYSADMIN user are the only users that can access the Microsoft Dynamics
AX database when it is installed, we recommend that you use the Microsoft SQL Server transparent
database encryption feature to further restrict access to the two tables. Specifics about how to protect
SQL Server are described in the Microsoft Dynamics AX Security Hardening Guide.
To reduce the possibility of obtaining credit card numbers on the network, all Microsoft Dynamics AX
code that processes the full credit card number is run on the AOS.
Error Messages
Several types of error messages can occur.
Error messages returned by the payment services provider, such as Decline or Invalid login, are
displayed in an Infolog message and included in the Credit card transaction history form.
If there are network issues or more serious failures that are not returned by the payment services
provider, Microsoft Dynamics AX 2012 will attempt to determine the most probable cause and display
that error. Additional error information will be included in the Credit card transaction history form.
To allow you to process your existing Authorize.Net transactions while transitioning to Payment
Services for Microsoft Dynamics ERP, first install Hotfix rollup 5 (KB 982812) and then hotfixes
KB979304_SYP and KB979304_HFX for Microsoft Dynamics AX 2009.ERP.
27
CREDIT CARD PROCESSING
Appendix A
Information provided in Level 2 data support
Payment Services for Microsoft Dynamics ERP
information
Order Date
Order Number
Invoice Date
Invoice date
Invoice Number
Invoice number
Order description
Customer reference
Not provided
Merchant Contact
Contact
Merchant Tax ID
Merchant Type
Not provided
Purchaser ID
Customer number
Purchaser Tax ID
Ship to City
Ship to city
Ship to County
Ship to county
Discount Amount
Handling charge
Handling charge
Duty Amount
Not provided
Freight Amount
Freight amount
Is Taxable
Merchant Name
Merchant Street
Company street
Merchant City
Company city
Merchant State
Company state
28
CREDIT CARD PROCESSING
Company country
Merchant County
Company county
Merchant Zip
Tax Rate
Tax Amount
Tax Description
Tax description
Alternate tax
Requester Name
Customer name
Total Amount
Total invoice
U Unknown (default)
Not provided
Not provided
Not provided
Not provided
29
CREDIT CARD PROCESSING
Item Sequence #
Blank
Commodity
Product Code
Item number
Product Name
Item description
Product SKU
Item number
Item Descriptor
Item description
Unit of Measure/Code
Unit
Unit Price
Unit price
Discount amount
Not provided
Item Quantity
Quantity
Net amount
Not provided
Cost Center
Dimension
Item number
Merchant Tax ID
Not provided
Freight Amount
Freight amount
Handling Amount
Handling amount
Tracking numbers
Pickup Address
Pickup City
Pickup State
Pickup ZIP
Pickup Country
Pickup County
UNSPSC Code
Not provided
Pickup Datetime
Not provided
30
CREDIT CARD PROCESSING
Tracking number
Tax Rate
Tax Amount
Alternate tax
31
CREDIT CARD PROCESSING
Microsoft Dynamics is a line of integrated, adaptable business management solutions that enables you and your
people to make business decisions with greater confidence. Microsoft Dynamics works like and with familiar
Microsoft software, automating and streamlining financial, customer relationship and supply chain processes in a
way that helps you drive business success.
U.S. and Canada Toll Free 1-888-477-7989
Worldwide +1-701-281-6500
www.microsoft.com/dynamics
This document is provided as-is. Information and views expressed in this document, including URL and other
Internet Web site references, may change without notice. You bear the risk of using it.
Some examples depicted herein are provided for illustration only and are fictitious. No real association or
connection is intended or should be inferred.
This document does not provide you with any legal rights to any intellectual property in any Microsoft product. You
may copy and use this document for your internal, reference purposes. You may modify this document for your
internal, reference purposes.
2011 Microsoft Corporation. All rights reserved.
Microsoft, Microsoft Dynamics, and the Microsoft Dynamics logo are trademarks of the Microsoft group of
companies.
All other trademarks are property of their respective owners.
32
CREDIT CARD PROCESSING