docs/RELEASE_NOTES_NEXT/Administration/drop-cc-columns.txt

   1 UPGRADE NOTES - Credit Card Receipts and Privacy
   2 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
   3
   4 To improve privacy and security, Evergreen now stores less data
   5 about credit card transactions.  The following fields are no
   6 longer stored:
   7
   8  * cc_type
   9  * cc_first_name
  10  * cc_last_name
  11  * expire_month
  12  * expire_year
  13
  14 NOTE: All existing data within these fields will be deleted during
  15 the upgrade.  Reports using this data will no longer function.
  16
  17 Additionally, a tool has been added to Evergreen for clearing the
  18 last 4 digits of the credit payment from the database after payments
  19 reach a certain age.
  20
  21 Print/Email Templates
  22 +++++++++++++++++++++
  23
  24 The stock print and email payment templates have been modified to no
  25 longer use these fields, but only when the existing templates matched
  26 the stock templates.  If local changes have been applied, it will
  27 be necessary to modify local templates to avoid referencing these
  28 fields which no longer exist.
  29
  30 Any templates whose hook is "money.format.payment_receipt.print" or
  31 "money.format.payment_receipt.email" may need modification.  In stock
  32 Evergreen, these are templates:
  33
  34 1. "money.payment_receipt.email" (stock id 29)
  35 2. "money.payment_receipt.print" (stock id 30)
  36
  37 Example diff:
  38
  39 [source,diff]
  40 ---------------------------------------------
  41 -  [% CASE "credit_card_payment" %]credit card (
  42 -      [%- SET cc_chunks = mp.credit_card_payment.cc_number.replace(' ','').chunk(4); -%]
  43 -      [%- cc_chunks.slice(0, -1+cc_chunks.max).join.replace('\S','X') -%]
  44 -      [% cc_chunks.last -%]
  45 -      exp [% mp.credit_card_payment.expire_month %]/[% mp.credit_card_payment.expire_year -%]
  46 -  )
  47 +  [% CASE "credit_card_payment" %]credit card
  48 +  [%- IF mp.credit_card_payment.cc_number %] ([% mp.credit_card_payment.cc_number %])[% END %]
  49 ---------------------------------------------
  50
  51 Clearing the Last 4 of the CC Number
  52 ++++++++++++++++++++++++++++++++++++
  53
  54 To active automatic CC number clearing, add the following to opensrf's
  55 crontab.  Change timing to suit.
  56
  57 [source,sh]
  58 ---------------------------------------------
  59 5  4  * * *   . ~/.bashrc && $EG_BIN_DIR/clear_cc_number.srfsh
  60 ---------------------------------------------
  61
  62 The default retention age is 1 year, but this can be changed by modifying
  63 clear_cc_number.srfsh (typically found in /openils/bin/).  Replace "1 year"
  64 with the age of your choice.
  65
  66