---
title: Payment Processing Flow
slug: payment-processing-flow
createdAt: 2020-09-19T11:50:57.000Z
---

In this articale we describe the entire process of charging a client for provided services and all actions that should be performed by a manager to successfully complete a reservation.&#x20;

## Payment Processing

After the reservation has been created, you can start accepting payments for it.

### Creating an Invoice

To do that, first of all you have to create an Invoice. It is recommended to do so, directly from the Reservation details page to allow the system to automatically inherit reservation related data and prevent unnecessary mistakes.

![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/lXmOEE4QIP8ch5YE6S2-K_Img1.png "Img. 1. New Reservation created.")

![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/YTaz21wHzxrJUfuVB0r2L_Img2.png "Img. 2. New Invoice is being created from the Reservation page. Details are inherited automatically.")

Please note that all payment related mailing will be handled through an email specified in the Invoice. By default it is the same as the main customer profile email, but upon creating an invoice you can change the mail address in case someone else is paying for this reservation. Once the invoice is created email can no longer be changed.

![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/Bt1JULAXPYdReUugs3DwS_Img3.png "Img. 3. New Invoice saved.")

As you can see, the newly created Invoice received “Open” Status. If there will be no entries confirming payments for this invoice, it will automatically change to “Expired” right after crossing the Payment due date. 

### Creating Payment Requests

While it’s still Open, let's move on with a payment procedure. In order to do that you have to create a Payment Request for this Invoice. Once again, if created from the Invoice page, needed data will be fetched automatically. **Please note that you should only create Payment Requests if the payment will be done online. For cash payments you have to skip this part and proceed to manually creating a Payment Entry.**

****

![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/WYmLZRE7iPrsZ7CYvePn__Img4.png "Img. 4. Click Payment Request button in order to easily create a Request connected to this Invoice.")



![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/BkQEZYVERMVcacGt_L_Pe_Img5.png "Img. 5. Newly created Payment request. Method has to be chosen Manually.")



As soon as you save the Payment Request, the Reservation Status will change to Pending.



![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/I2FBPBDUmQO1QAmJGBRFg_Img6.png "Img. 6. Pending Reservation. It will expire if no payments will come after the Payment Request.")



### Receiving Payment Entries

After the payment is submitted several things happen:

- You receive a Payment Entry
- Payment Request changes its status to Paid
- Reservation and Invoice Statuses change accordingly to the payment amount



![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/k5zD3-XZcEuLAnSN8wFIY_Img7.png "Img. 7. Payment Entry was created automatically after Mollie confirmed the payment.")



![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/BfZDM-qn8UCGKer4cnR_m_Img8.png "Img. 8. Payment Request with Paid Status.")



As you can see for now only 1€ was paid, which is less than the full price but enough to cover the prepayment. Therefore the Invoice and the Reservation statuses will automatically be changed to Prepaid.



![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/RPZeFElKLd1F7ravn-gEn_IMG9.png "Img. 9. Invoice with Prepaid status.")



![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/nmLxz8vsAv_0kLsdQwwTb_IMG10.png "Img. 10. Reservation with Prepaid Status.")



Now to complete the payment, you have to create one more Payment to cover the entire Reservation fee. Once again it is recommended to create the request from the Invoice page.





![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/cZnBTBULicOlF0nkMAYXh_IMG11.png "Img. 11. Second Payment request with Open status.")



Now the procedure repeats, as soon as this Request is paid, we will receive a Payment Entry only this time the Invoice status will change to Paid and the Reservation Status will change to Confirmed



![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/2V8Am2VjTi-cFwjpUd9Z7_IMG12.png "Img. 12. Second Payment Entry fulfilled.")



![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/yzi3YEH4B7PJm0eyUoAuB_IMG13.png "Img. 13. Invoice Status changed to Paid.")



![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/uFU0TfKNCDA2QyAAkugLt_IMG14.png "Img. 14. Reservation Status changed to Confirmed")



After all these steps the main payment processing loop is completed and the Customer will receive a Confirmation email, that approves his Reservation as legit.

## Merging Invoices

In case the Reservation was altered after the prepayment was already made a situation will occur when you will have to account previous payments intor the updated Invoice. In order to do so we added the possibility to "inherit" past payments from another invoice during new Invoice creation.



![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/QHKzymKc0yVQL0Pe86zYC_image.png "Img. 15. Prepaid outdated Invoice")



![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/kK6MO10Q1-lNmhi-VkILD_image.png "Img. 16. Updated Reservation total")



![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/Woe3VZw-ISzcwFdm2iimM_image.png "Img. 17. Merging during new Invoice Creation")



![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/iOn4hJGk0UmvXPqqlbYP9_image.png "Img. 18. New invoice inherited payment automatically")

Please note that merging procedure cannot be reverted. It is necessary to merge all payments into latest actual invoice before the Reservation Check In procedure. Apart from that invoices will be automatically merged before pushing payment data from the Cash back into booktivity.

## Refund Flow

&#x9;As you well know, sometimes there is a necessity to refund a certain amount of money back to the Customer. In this case you have to manually create a Refund Request from the payment entry you would like to refund. Due to Mollies API limitations now each Payment Entry has to be refunded separately, so you will need at least 2 refunds to fully refund our example Reservation. When you give partial refunds it is recommended to create a Refund Request from the largest Payment Entry.




![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/ZJ72yU-hS-F5Kb_pQyUPc_IMG15.png "Img. 19. Payment Entry from which the Refund Request will be created. Click Refund to proceed.")



![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/AjvOeHXZO4wM2GlHiMZdf_IMG16.png "Img. 20. Process of Refund creation. As soon as you save it the Refund will be processed automatically.")



![](https://archbee-doc-uploads.s3.amazonaws.com/6RS_ocHfnFx0lpMGgjo3h/K_S7C_AYwbfREuEzCVgKB_IMG17.png "Img. 21. Reservation with Refunded status.")



As you can see, after you created the refund, the Reservation Status will change to Refunded.














