]> git.evergreen-ils.org Git - Evergreen.git/blob - docs/modules/admin/pages/accepting_credit_card_payments.adoc
c4d27cfcff81d5ab7ca66b3e1940415d2764d97a
[Evergreen.git] / docs / modules / admin / pages / accepting_credit_card_payments.adoc
1 = Accepting credit card payments =
2 :toc:
3
4 Evergreen can interface with services like Authorize.net, Stripe, PayPal, or Payflow to allow users to pay fines and other charges in the Public Catalog.  Credit card settings can be configured in the xref:admin:librarysettings.adoc[Library Settings Editor]. 
5
6 As of 3.6 Stripe in Evergreen is using version 3 of the Stripe client library and the Elements API.
7
8 == Setting up credit card payments ==
9
10 Credit card payments are controlled in the library settings.  These settings are protected by two permissions.  In order to view the
11 current settings, you need the VIEW_CREDIT_CARD_PROCESSING permission.  To add, update, or remove these settings, you will need the
12 ADMIN_CREDIT_CARD_PROCESSING permission.
13
14 To enable credit card payments, you will need to set the following settings:
15
16 * Settings related to your credit card processor: AuthorizeNet, PayPal, PayflowPro, or Stripe.  The correct values for these settings will come from the processor.  The library settings editor includes many settings for each processor; you may not need to fill in every one.
17 * The "Name of the default credit processor" setting.  This should be the processor you set up in the previous step.
18 * The "Allow credit card payments" setting.  This should be True.
19
20 [NOTE]
21 Be sure you are applying these settings at the correct organizational unit context.  For many libraries, these settings should be applied at the System level.
22
23 == Running in Test Mode ==
24
25 This test mode is designed to be used on your library's Evergreen test server.  To avoid confusing your patrons and changing
26 billing totals, do not use this mode on a production Evergreen server.
27
28 You can enable test mode using the library settings editor by setting your credit card provider's test mode setting to True.
29 For example, if you use Authorize.Net, you can enable test mode by setting "AuthorizeNet test mode" to True.
30
31 In this test mode, Evergreen will display information from your processor about whether or not the payment information was
32 successful.  The payments will not actually be charged to the relevant credit card, but the Evergreen patron's balance will
33 be adjusted according to the test payment.
34
35 Your credit card provider should be able to provide test credit card numbers for your testing purposes.