Commerce Card on File (Forked)

Fork of Commerce Card on File 7.x-1.x as of commit 75f3dae.
Recommended: Commerce Card on File 7.x-2.x branch - It has incorporated some of the changes and features in this fork, as well as converting to an entity based storage.

Changes Applied:

• API documentation for all payment method callbacks and module hooks
• Example payment module to demonstrate all card on file integration
• Database table CRUD hooks
  • Related Issues: #1808166: Add module hooks for insert, update, delete
  • Commits: 954a195, d7fcf12, 3f1440c
• Views Integration
  • Commits: 38bf256
  • Views data definition, custom field handlers, argument validates for card id and owner
  • Default view for user tab page
• Update a card's billing address
  • Billing Address field form presented on update card form
  • New Card on File payment method callback defined to retrieve the billing address from the payment gateway module - 'get address callback'
  • Commits: 60ba651
• Add a new card (outside of checkout)
  • New card form
  • New Card on File payment method callback defined to create a new card outside of checkout, 'create callback'
  • Commits: acf4eb9, cb841d8
• Default card per Payment method instance
  • Added the ability and storage to set a default card per payment method instance id
  • Ensures that there is only 1 default per payment method instance
  • A user can toggle the default setting on the card via a tokenized menu path if they have the 'edit' card data permissions.
  • Default card can be set during checkout
  • The user's default card could be used in a recurring situation or noted to an admin on a manually created order
  • Related Issues: #1421832: Option to define a User's Default Card On File
  • Commits: 7059d09, 9962b04, 4d0c5b0, 43594f0, 9daee58
• Improved access control
  • More granular permissions added for 'view', 'edit', 'create', 'delete' instead of the original single 'manage' permission
  • Commits: 77fb98e, 9d1861c
• Card on File Reference field type
  • Defines a Card on File reference field and default display formatters.
  • A reference field gets attached to each order bundle
  • Order field populated during checkout for selected card on file
  • Commits: 252991a, 3542984, 830047a, 0604432
• Order entity properties
  • Defines a Card on File reference field and default display formatters.
  • A reference field gets attached to each order bundle
  • Chargeable Card on File (chargeable_cardonfile): returns an available card for the owner that can be charged - not expired and card is active. The following are checked top down to determine the card:
    • Order reference field "commerce_cardonfile"
    • Owner's default card for the order's payment method instance
  • Commits: 6a81bb8
• "Can delete" hook
  • Determines whether or not the give card can be deleted.
  • @see hook_commerce_cardonfile_data_can_delete() in commerce_cardonfile.api.php
  • Commits: 413dfe7
• Function to process a charge for a given an order
  • If no $card_data array is provided, then the "chargeable card" will be used per hook_commerce_cardonfile_order_chargeable_cards().

  • function commerce_cardonfile_order_process_card($order, $charge = array(), $card_data = array())
    

  • Rules Events
    • 'After a successful processing of an order'
    • 'After a failed attempt to process an order'
  • Rules Action to process an order with a card on file
    • Commits: 3b9cb16
• "Chargeable cards" hook
  • Lets modules define the chargeable cards associated with an order.
  • @see hook_commerce_cardonfile_order_chargeable_cards() in commerce_cardonfile.api.php
• Card label theme function
  • Provides a way to override the card label that is presented during checkout.
  • Theme added: "commerce_cardonfile_data_label" with a parameter of the card data array. Example: theme('commerce_cardonfile_data_label', array('card_data' => $card_data));
  • Commits: b0f0079
• Fix to not show card on file options to anonymous users during checkout
  • Commits: f28bb83
  • Issue: #1375216: Anonymous users see other anoynmous user's credit card details