invoiceninja/docs/payments.rst

Payments
========

The Invoice Ninja system handles your entire invoicing process – from sending a quote (Pro Plan only), to invoicing your client, to receiving payment. What’s more, you can receive payments directly and automatically via Invoice Ninja’s 45+ payment gateway partners, enabling totally smooth management of your customer accounts using your choice of payment provider. To learn more about Invoice Ninja’s payment gateway partners `click here <https://www.invoiceninja.com/partners>`

List Payments
"""""""""""""
In the meantime, we’re going to take you through the Payments list page to give you an idea of the complete payment picture.

To view the Payments list page, click on the Payments tab on the main taskbar. This will open the Payments list page.
Understanding the Payments List Page

Overview
^^^^^^^^

The Payments list page displays a summary of all payments once they have been received. Payments are recorded in two ways:

1. **Automatic payment**: If your client has paid you via any of Invoice Ninja’s 45+ payment gateways, the payment will be automatically recorded in the Payments list. You will be notified by Invoice Ninja on your Dashboard page in the Payments table, and also via email (if you have chosen the relevant notification setting on the Settings / Notifications page).
2. **Manual payment**: If your client has paid you via cash, check, bank transfer, credit card or any other payment system not linked to Invoice Ninja, you will need to enter the payment manually on the Payments / Create page.

Whether automatic or manual entry, the Payments list page presents an overview of all payments received in a user-friendly table format. Now, we’ll take you through the various columns in the Payments table from left to right:

- **Invoice**: The invoice number for the payment
- **Client**: The client name
- **Transaction Reference**: If you have been paid automatically via one of the payment gateways, the reference number of the payment generated by the payment gateway system will be automatically recorded here. If you have entered a manual payment, the Transaction Reference will display the information you entered in the Transaction Reference field when entering the payment. If you left the Transaction Reference field blank when entering the payment, the system will automatically display “Manual entry” as the Transaction Reference on the Payments list.
- **Method**: The method of payment used, ie. PayPal, Bank Transfer, Visa, etc
- **Payment**: Amount The payment amount that was received
- **Payment Date**: The date the payment was received

The final column to the right is the Action column. To view the actions, hover your mouse over the Action area of the relevant payment entry and a gray Select button will appear. Click on the arrow at the right side of the button to open a drop-down list. These are the action options:

- **Edit Payment**: Edit the payment information on the Edit Payment page.
- **Archive Payment**: Click here to archive the payment. It will be archived and removed from the Payments list page.
- **Delete Payment**: Click here to delete the payment. It will be archived and removed from the Payments list page.

.. TIP:: To sort the Payments list according to any of the columns, click on the orange column tab of your choice. A small arrow will appear. If the arrow is pointing up, data is sorted from lowest to highest value. If the arrow is pointing down, data is sorted from highest to lowest value. Click to change the arrow direction.

Archiving/Deleting
^^^^^^^^^^^^^^^^^^

To archive or delete a payment, hover over the payment entry row, and open the Action drop-down list. Select Archive Payment or Delete Payment from the list. The Payments table will automatically refresh, and archived or deleted payments will no longer appear in the list.

You can also archive or delete one or more payment via the gray Archive button that appears at the top left side of the Payments list page. To archive or delete payments, check the relevant payments in the check boxes that appear in the far left column next to the invoice number. The number of payments selected for archiving/deleting will automatically update and show on the Archive button. Then click on the Archive button, open the drop-down list and select the desired action.

Want to view archived or deleted payments? Check the box marked Show archived/deleted payments, situated to the right of the Archive button. The table will automatically refresh, and will now feature the full list of payments, including current, archived and deleted payments. The status of the archived and deleted payments will be displayed in the far right column.

- **Deleted payments** are displayed with a red Deleted button. To restore deleted payments, hover on the red Deleted button. A gray Select button will appear. Click on the Select arrow, and select Restore payment in the drop-down list.
- **Archived payments** are displayed with an orange Archived button. To restore the archived payment, hover on the orange Archived button. A gray Select button will appear. Click on the Select arrow, and choose Restore payment from the drop-down list. To delete an archived payment, select Delete payment from the drop-down list of the Select button.

Enter Payment
^^^^^^^^^^^^^

You can enter a new payment directly from the Payments list page by clicking on the blue Enter Payment + button located at the top right side of the page. The Payments / Create page will open.

Filter
^^^^^^

To filter the Payments list, enter the filter data in the Filter field, situated at the top right of the page, to the left of the blue Enter Payment + button. Payments can be filtered according to Client name.  Enter the name or parts of the name, and the filter function will automatically locate and present the relevant entries.

Enter Payment
"""""""""""""

Once you’ve received payment, you’ll need to enter the payment on the Invoice Ninja system. If your client paid via one of Invoice Ninja’s 45+ payment partners, the system will automatically record the payment and send a downloadable PDF receipt to the client’s email address. If you were paid via cash, check, bank transfer, credit card, credit or any other payment method not automatically linked to the Invoice Ninja system, you will be required to enter the payment. The procedure of entering a payment is simple and lightning fast. Now, we’ll take you through the payment entry process, step by step.

**Let’s Begin**

The Payments / Create page features a number of fields that you’ll need to complete.

- **Client**: Click on the arrow on the right side of the Client field and select the client from the drop-down list.
- **Invoice**: Enter the invoice corresponding to the received payment. Click on the arrow on the right side of the Invoice field and select the invoice number from the drop-down list.
- **Amount**: Enter the amount of the payment received. TIP: The amount may not correspond to the amount on the invoice. It may be a partial payment, or it may be a higher amount than listed on the invoice, in which case the extra payment will be recorded as a credit on the client’s account balance.
- **Payment**: Type Select the method of payment used. Click on the arrow on the right side of the Payment Type field, and a drop-down list featuring a range of payment methods will open. Select the appropriate method from the list. Options include Bank Transfer, Cash, Debit, all credit cards, Google Wallet, PayPal, check and more.
Apply Credit: Here, you can apply credit from the client’s existing credit accrued in their account balance with your company. To do so, select Apply credit, which is the first option in the Payment Type drop-down list. If the client does not have enough credit to cover the payment, a red warning message will appear to notify you.
- **Payment Date**: The date the payment was received. Click on the calendar icon to the right side of the Payment Date field and select the appropriate date.
- **Transaction Reference**: Enter any information you wish for your future reference. This information can be useful when managing your accounts.

Email payment receipt
^^^^^^^^^^^^^^^^^^^^^

If you wish to send a receipt to your client for the payment received, check the “Email payment receipt to the client” box. A downloadable PDF receipt will be generated and sent to the client’s email address.

Saving the Payment
^^^^^^^^^^^^^^^^^^

Once you’ve completed all the payment details, click Save and the payment will be saved to the Payments list. To cancel the payment entry, click Cancel.

.. TIP:: When you click Save, you’ll be automatically redirected to the client’s individual summary page. Here you can view all the client details and actions recently taken in relation to this client, including the payment just entered and the balance adjustment.