You will find the Payment History screen on your WordPress admin area navigating to the GamiPress menu -> Payment History submenu.
The payment history screen is a quick view of all payments stored by GamiPress – Purchases. Quickly you will see each payment number, customer, date, status, payment method and total (with taxes included).
Clicking on the Edit link, you will be redirected to the payment edit screen.
Payment details are separated in two columns, the order details and the user details.
The order details column has all fields related to the payment: number, date, status, payment method, IP from where the payment has been processed, etc.
You are able to edit anything, but is recommendable to do not edit the purchase key or transaction ID. Both fields are handled by the payment gateway that process the payment.
The user details column has all fields related to the user that made the payment: name, email, billing address, etc.
In addition, you have the “Load billing address” that will load automatically the current user details to the payment (keep in mind that each payment stores the user details that user provides on each purchase, so user can be located on different addresses for each payment or has different email address).
The payment items are all items that user has purchased. Adding or changing items totals (quantity, price or total) will automatically update the total of the payment (without refresh the page).
Also you are able to change the tax applied to the amount you want (as percent).
An important detail of each payment item is the assignment it has and how it works, so check the next section to see how payment items assignments works.
Payment Items Assignments
Each payment item can be related to an assignment. This assignments are the points type, achievement or rank that user will earn on complete the purchase.
Of course, you can define payment items without assignment to add custom fees for something, like an charge for some condition of the payment.
Let’s to see how to add an item and assign it to an achievement.
First, clicking on the “Add Item” will add a new row like this:
As you can see, you can define a custom description, quantity, price and total.
Check that after the payment item description field, there is a link with the text “assign post”, clicking on it, will show a form like the next one:
The first field is the assignment type and it could be any of our registered points types, achievement types or rank types. Choose any of your registered achievement types (in this example, the “Badge” achievement type).
Now, a new field will be loaded letting you choose the “Badge” you want to assign to this payment item.
Clicking on the “Save” button will confirm our assignment. Now, the assignment description will change with the current payment item assignment description.
Important: This assignments will be awarded to the user when the payment gets completed and will be revoked when payment gets refunded. If you set new assignments when payment is completed they will not be awarded.
To make this assignments work manually you need to follow this steps:
- Add the assignments you want.
- Change the payment status to pending.
- Save the payment (this will trigger internal actions based on payment status change).
- Change the payment status to complete.
- Save the payment (here is where internal actions based on payment status changes from pending to complete will happen and will award everything).
That’s know as payment status transitions, and normally they happen when payment status changes from pending to complete and from complete to refunded.
To manually revoke the assignments you need to do the same but changing with the status from complete and refunded.
The payment notes has two functionalities, first GamiPress – Purchases will use it to inform about internal process results like a log. When payment fails for some reason, when payment gets paid, on resend the purchase receipt, etc. The author of this notes will be the GamiPress Bot.
Also, you have the ability to add your own notes for internal purposes. This process is explained on the next section.
Adding Payment Notes
Adding a payment note is really similar to adding a comment on any post or page from the admin area. Clicking on the “Add Payment Note” will show to you a hidden from like this:
Just fill the form with the title and note and click to the “Add Payment Note” button to add it.
Note: Adding payments notes will be done and stored without refresh the page. So you do not need to save the payment if you just added some payment notes.
From the payment actions box you will be able to process some actions based on the current status of the payment. For example, when the payment is complete, you can resend the purchase receipt to the user (this action will create a new payment note to meet that this action was happen and when).
Payment gatewaywill add their own actions, for example, if payment has made choosing the Bank Transfer and payment still pending, you will see an action to quickly mark as paid when you receive the transfer.
Also, the PayPal Standard gateway will add the refund action when payment is completed to allow you refund the payment and notify about that to PayPal.