Note: authorize.net test accounts will not work, you must have a full account. Once you have an account, obtain a transaction key in the Account/Security Settings/Transaction Key area on the accounts.authorize.net website.
CCSetGateway("Authorize.net") // for authorize.net accounts (the default)
CCSetGateway("PayPal") // for paypal/verisign accounts
Once your merchant account is set up correctly, running charges can be done in one quick step. Here is an example of its usage:
CCProcessPayment( merchantAccount; transactionKey; chargeAmount; cardNumber; expDate )The above method will process a payment transaction for a card, and return the gateway transactionID for the transaction, or the word "
ERROR",
if the transaction fails for some reason. For additional information about the failure, call CCLastError.
It is important that you store this resulting transactionID, you may need it to VOID the transaction later.
The minimum amount of information needed to process a transaction is:
CCProcessPayment( merchantAccount; transactionKey; chargeAmount; cardNumber; expDate; "chargeDescription=" & description; "cardType=" & cardType; "verificationCode=" & securityCode )Here is a list of all valid additional parameters:
USD, for example)SWIPE (card-present transactions) are not supported by the PayPal processor.
To void a transaction, you need the transactionID which was returned by the CCProcessPayment function. Pass this (along with other payment info) to the CCVoidPayment function.
CCVoidPayment( settings::merchantAccount ; settings::transactionKey ; // your transaction key or password "1321353789" ; // the transactionID being voided "1234123412341234" ; // the credit card number Date(12, 1, 2010) ; // credit card expiration date "John" ; // card holder first name "Doe" ; // card holder last name )
To credit a transaction, you need the transactionID which was returned by the CCProcessPayment function. Pass this (along with other payment info) to the CCRefund function. This is similar to the void process, but accepts a dollar amount.
CCRefund( settings::merchantAccount ; settings::transactionKey ; // your transaction key or password "1321353789" ; // the transactionID being credited "1234123412341234" ; // the credit card number 0.02 ; // the amount of the refund Date(12, 1, 2010) ; // credit card expiration date "John" ; // card holder first name "Doe" ; // card holder last name )
To try it out, open the ECommerce.fp7 file and follow the directions on the main menu.
FileMaker version 7 or higher.
Java Virtual Machine (JVM) version 1.4.2 or later. If you are running a JVM earlier than 1.4.2, you should upgrade. Download a JVM from http://www.java.com/en/download/. If you are not sure what version of Java you have installed, you can do 'java -version' on the command line in Windows or OS X.
Windows, or Mac OS X version 10.4 or higher.
Note to intel Mac users: running this plugin under Rosetta is not supported. Upgrade to FileMaker 8.5 to run our plugin in native Intel mode.
Drag the plugin from the MAC or WIN folder into your FileMaker extensions, and restart FileMaker. You will need to enter your license key before you can use it. After FileMaker starts up with the plugin installed, open FileMaker preferences, click on the Plug-ins tab, select the plugin from the list, and click the Configure button. Enter your license key and company name in this dialog. You will only need to do this once on a given machine. Alternately, you can use the registration function to register the plugin during a startup script.
This will also enable the plugin for use with Instant Web Publishing from the FileMaker Pro client software.
If the plugin does not load correctly, double-check that you meet the system requirements.
You do not need to do this step unless you plan on using the plugin with Instant Web Publishing or Custom Web Publishing with FileMaker Server Advanced. You will need an Enterprise License to use this feature.
For installing into the Web Publishing Engine with FileMaker 9 Server or FileMaker Server Advanced, drag the plugin from the MAC or WIN folder into the FileMaker Server/Web Publishing/publishing-engine/wpc/Plugins folder. If there is no 'Plugins' folder inside the 'wpc' folder, then create it manually. Restart FileMaker Web Publishing, and now the plugins should be ready to go.
Note that you must use the registration function to register the plugin, since there is no preferences dialog in the FileMaker Web Publishing Engine to enter the license key and company name.
Note that due to a bug which we and other plugin vendors have reported to FileMaker, web plugins do not work in FileMaker Web Publishing Engine 8.0v4 on Mac OS X. You will need to use a later version, like 9, or an earlier version, like 8.0v3. The Windows FileMaker Server 8.0v4 does not have this bug, and will work correctly.
The easiest way to test whether the plugin is working is to have a calculation which calls the version function of the plugin, and display that on an IWP layout. If it shows "?", then the plugin is not working. If it shows a number, then the plugin has been installed successfully.
You do not need to do this step unless you plan on using the plugin with scheduled script triggering, a new feature in FileMaker Server 9. You will need an Enterprise License to use this feature.
FileMaker Server/Database Server/Extensions folder (older versions of server use the path FileMaker Server/Extensions/Plugins).Configuration -> Database Server->Server Plug-ins.
Note that you must use the registration function to register the plugin, since there is no preferences dialog in FileMaker Server to enter the license key and company name.
We love to hear your suggestions for improving our products! If you are experiencing problems with this plugin, or have a feature request, or are happy with it, we'd appreciate hearing about it. Send us a message on our website, or email us!
You must process a payment with the CCProcessPayment function before calling this function
The code will be one of the following:
A = Address (Street) matches, ZIP does not
B = Address information not provided for AVS check
E =
AVS error
G = Non-U.S. Card Issuing Bank
N = No Match on Address (Street) or ZIP
P = AVS
not applicable for this transaction
R = Retry Ð System unavailable or timed out
S = Service not
supported by issuer
U = Address information is unavailable
W = 9 digit ZIP matches, Address
(Street) does not
X = Address (Street) and 9 digit ZIP match
Y = Address (Street) and 5 digit ZIP
match
Z = 5 digit ZIP matches, Address (Street) does not
Note: This feature is currently only implemented for the authorize.net gateway.
"" if there was no error.
Generally, the CCProcessPayment function returns this value as well. This function is here as a convenience if you're not able to retrieve that value due to chaining multiple functions together.
You must process a payment before calling this function.
The second parameter (txKey) should be your merchant account password OR your 16-digit authorize.net transaction key.
You can obtain an authorize.net transactionKey by logging into https://account.authorize.net/ and going
to the Account / Settings / Transaction key section.
If the txKey is not exactly 16 digits, it is assumed to be your authorize.net merchant account password. Using your account password to approve
transactions is not recommended.
PayPal only supports passwords, not transaction keys. If you have a PayPal merchant account, simply use your paypal account password for the second parameter to this function.
To pass in additional parameters, see the documentation and examples at the top of this document.
If successful, this function returns the unique transactionID for the payment (as assigned by the payment gateway).
If you wish to void the payment later with the CCVoidPayment function, you will need this number!
Note: if test mode is enabled, a successful authorize.net transaction will return 123456789.
detailed information about the nature of the error).
merchantAccountName - your payment gateway merchant account nametxKey - your merchant account password OR authorize.net transaction key.dollarAmount - the amount of the transactioncardNumber - the credit card account number to charge for the transactionexpirationDate - the expiration date of the credit card being charged. Format the expiration date as MMYY or MM/YY or MM/DD/YYTo pass in additional parameters, see the documentation and examples at the top of this document.
card number, or just the last 4 digits. passed the absolute value is used. detailed information about the nature of the error).
merchantAccountName - your payment gateway merchant account nametxKey - your merchant account password OR authorize.net transaction key.previousTransactionID - the transactionId of a previously processed transaction.cardNumber - the credit card account number to credit for the transaction. For credits, you may either pass the entireamountToCredit - the amount to credit, as a positive number. Must be less than the original transaction amount. If a negative number islicenseKey - a valid license key string, or the literal string "DEMO" to run in demo mode.registeredTo - the company name for the license key used.The following gateways are supported:
gatewayName - one of the supported gateway names.This can be very handy for "validated by calculation" fields, to ensure that only valid credit cards are entered.
cardNumber - credit card number, containing numbers and optional dashesdollarAmount is replaced with the addition of the previousTransactionID parameter. The
previousTransactionID should be the transactionID of the transaction you wish to void. This value is returned by the
CCProcessPayment function. Alternately, you can use the CCLastPaymentTransactionID function
to get the transactionID of the last processed payment.
To pass in additional parameters, see the documentation and examples at the top of this document.
information about the nature of the error).
merchantAccountName - your payment gateway merchant account nametxKey - your merchant account password OR authorize.net transaction key.previousTransactionID - the transactionId of a previously processed transaction.