> ## Documentation Index
> Fetch the complete documentation index at: https://docs.decoart.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Braintree Overview

## Overview

DASH uses PayPal Braintree to securely store customer card information and charge cards against orders and invoices. There are four main features worth noting:

* **Card Vaulting** - accounting can enter a customer's card details in DASH; the card itself is stored securely in Braintree, never in DASH.
* **Charging** - accounting can charge a customer card for an order or invoice. Once a transaction settles, an AR payment is created automatically.
* **Settlement** - Braintree processes the authorized transaction over a few days to confirm it is legitimate and the card details are valid. DASH checks for settled transactions on a regular (hourly) schedule and converts them into AR payments when applicable.
* **Refunds** - a settled transaction can be partially or fully refunded, which automatically creates a debit memo.

## Managing Customer Cards

### Viewing and Editing Customer Cards

1. From the Customer Information → Manage Customers submodule, click the `View / Edit Customer` tab.
2. Click the dropdown menu next to the Customer field.
3. Enter the customer number or name you're looking for, then click to select it.

   <img src="https://mintcdn.com/decoart-e7110480/6PAUf-gDc9hdyADi/images/customer-information/manage-customers/manage-customers-1.png?fit=max&auto=format&n=6PAUf-gDc9hdyADi&q=85&s=5162d096963e60ca1e94b6609995a452" alt="Select Customer" width="2559" height="1259" data-path="images/customer-information/manage-customers/manage-customers-1.png" />
4. View the customer's saved cards.
   <img src="https://mintcdn.com/decoart-e7110480/iDr5-A5oZVDKpkJA/images/customer-information/braintree/braintree-view-cards.png?fit=max&auto=format&n=iDr5-A5oZVDKpkJA&q=85&s=afeaba852f9d71775a7746c1fd3ac83f" alt="Customer Cards" width="982" height="310" data-path="images/customer-information/braintree/braintree-view-cards.png" />
5. To delete a card, click the red 'X' button on that card, then confirm the deletion.
6. To edit a card, click the yellow pencil button. Update the expiration date and CVV, then click 'Save'.
   <img src="https://mintcdn.com/decoart-e7110480/iDr5-A5oZVDKpkJA/images/customer-information/braintree/braintree-edit-card.png?fit=max&auto=format&n=iDr5-A5oZVDKpkJA&q=85&s=aa335ffbf05bbfbaa3481a9d613bb436" alt="Edit Card" width="983" height="312" data-path="images/customer-information/braintree/braintree-edit-card.png" />

### Adding a New Card

1. Click the edit button and scroll down to the 'Customer Payment Methods' section.
2. Click '+ Add New'.
3. Fill out the card information and click 'Add Card'. The card is stored in Braintree and linked to the customer account.

   <img src="https://mintcdn.com/decoart-e7110480/iDr5-A5oZVDKpkJA/images/customer-information/braintree/braintree-add-card.png?fit=max&auto=format&n=iDr5-A5oZVDKpkJA&q=85&s=d9acf5724a9d8efc54a1502fa9313cd9" alt="Add New Card" width="964" height="523" data-path="images/customer-information/braintree/braintree-add-card.png" />

## Charging a Customer Card

### From an Order

1. Navigate to Order Processing → Manage Orders → View / Edit Order and search for the order you want to charge.
2. Select either 'Charge Customer for Order' or 'Charge Card for Order (One-off)' at the top of the page. Use 'Charge Customer for Order' when a card is already on file. If no card is on file, use 'Charge Card for Order (One-off)' and enter the card information.
   <img src="https://mintcdn.com/decoart-e7110480/iDr5-A5oZVDKpkJA/images/customer-information/braintree/braintree-order-charge-buttons.png?fit=max&auto=format&n=iDr5-A5oZVDKpkJA&q=85&s=5a1f98852d22e4d98e7c725c9484e4b7" alt="Charge Order" width="994" height="191" data-path="images/customer-information/braintree/braintree-order-charge-buttons.png" />
3. Enter the net amount and tax amount, toggle any surcharge, freight surcharge, or transaction fee via its checkbox, add an optional comment, then click 'Charge Card'.
   <img src="https://mintcdn.com/decoart-e7110480/iDr5-A5oZVDKpkJA/images/customer-information/braintree/braintree-order-charge-modal.png?fit=max&auto=format&n=iDr5-A5oZVDKpkJA&q=85&s=33e2665cb76720e269cbe7cec0e8504c" alt="Charge Order Fields" width="981" height="602" data-path="images/customer-information/braintree/braintree-order-charge-modal.png" />
4. For a one-off charge, you'll be prompted to enter the card information after filling in the payment details.
   <img src="https://mintcdn.com/decoart-e7110480/iDr5-A5oZVDKpkJA/images/customer-information/braintree/braintree-order-charge-one-off-modal.png?fit=max&auto=format&n=iDr5-A5oZVDKpkJA&q=85&s=8093128695bd2f7d51deca5b302b2bc9" alt="Charge Card Fields" width="992" height="852" data-path="images/customer-information/braintree/braintree-order-charge-one-off-modal.png" />

<Note>
  Once a charge is submitted, DASH sends the transaction to Braintree for settlement. Settlement can take a few days, and DASH checks for settled transactions on a regular (hourly) schedule. Once the transaction settles, DASH automatically creates an AR payment for the order.
</Note>

### From an Invoice

Charging a card from an invoice works much like charging from an order, with two differences: the payment details pull from the invoice rather than the order, and the transaction is submitted for settlement automatically once the invoice is past a Pending status (Posted or Finalized).

## Credit Card Report

The credit card report lets you view past and current credit card transactions and issue refunds. To access it, navigate to Accounting → Accounts Receivable → CC Report.

1. Set the filters, such as 'Invoice Date', 'Transaction Date', 'Status', and 'Include Failed'.
   <img src="https://mintcdn.com/decoart-e7110480/iDr5-A5oZVDKpkJA/images/customer-information/braintree/braintree-cc-report-filters.png?fit=max&auto=format&n=iDr5-A5oZVDKpkJA&q=85&s=00a913ce40a46945d1f5b96120377572" alt="CC Report Filters" width="1001" height="192" data-path="images/customer-information/braintree/braintree-cc-report-filters.png" />
2. Click 'Run Report'. The table populates with the order number, customer information, and transaction status and details.
   <img src="https://mintcdn.com/decoart-e7110480/iDr5-A5oZVDKpkJA/images/customer-information/braintree/braintree-cc-report.png?fit=max&auto=format&n=iDr5-A5oZVDKpkJA&q=85&s=4989868ca758d800c33dd80ce6ef447c" alt="CC Report Results" width="988" height="548" data-path="images/customer-information/braintree/braintree-cc-report.png" />
3. From this report, you can view the underlying AR invoice and payment batch, and issue a refund.
   <img src="https://mintcdn.com/decoart-e7110480/iDr5-A5oZVDKpkJA/images/customer-information/braintree/braintree-cc-report-links-actions.png?fit=max&auto=format&n=iDr5-A5oZVDKpkJA&q=85&s=09e7c30c524482e563b11bffffa5d48e" alt="CC Report Refund" width="981" height="561" data-path="images/customer-information/braintree/braintree-cc-report-links-actions.png" />
4. To issue a refund, click the 'Refund' button in the Actions column. A modal appears where you can enter the refund amount. Once the amount is entered and validated, click 'Refund'.
   <img src="https://mintcdn.com/decoart-e7110480/iDr5-A5oZVDKpkJA/images/customer-information/braintree/braintree-cc-report-refund-modal.png?fit=max&auto=format&n=iDr5-A5oZVDKpkJA&q=85&s=326f68e023b44986d6c5e49dea8a5326" alt="CC Report Refund Modal" width="984" height="552" data-path="images/customer-information/braintree/braintree-cc-report-refund-modal.png" />

<Note>
  After a refund is issued, DASH automatically creates a debit memo for the refunded amount under the customer's account.
</Note>

## Good to Know

* Braintree also offers its own UI for viewing and managing customer cards, transactions, and refunds — log in at the Braintree website with your credentials. If a card transaction fails, you can view detailed information about the failure there.
* DASH automatically creates AR payments for settled charges and debit memos for refunds.
* Each transaction has a maximum chargeable amount based on the order/invoice details. This reduces erroneous transactions and helps ensure the correct amount is charged.
* Partial payments are allowed only for customers who receive a single invoice per order (that is, customers not set up for multiple invoices per order).
