What Are Payments?
Using Akia payments, you can now place a hold on a card, collect a set payment amount, or accumulate tips from guests in your Agreements and Mini Apps. Not ready to process payment yet? Choose to only place a small hold on the guest’s credit card (which is automatically released after 7 days) and process payments later.
![Set a payment amount that can either be charged to the guest or placed as a hold to be captured later if needed.](https://www.notion.so/image/https%3A%2F%2Fs3-us-west-2.amazonaws.com%2Fsecure.notion-static.com%2F2ea7aa15-18a4-4057-bf46-28dc14aa6be9%2FScreen_Shot_2022-10-03_at_5.34.02_PM.png?table=block&id=d2e5eec5-9455-470f-9c87-84c9f64d5ad9&cache=v2)
![Allow guests to choose their tip amount in the agreement field at the end of their stay.](https://www.notion.so/image/https%3A%2F%2Fs3-us-west-2.amazonaws.com%2Fsecure.notion-static.com%2Fadaea623-48ef-426a-a180-bdd8a0b21d71%2FScreen_Shot_2022-10-03_at_5.34.33_PM.png?table=block&id=10660dd8-5fcb-46e5-a260-848618e6b750&cache=v2)
How Do I Set Up Payments in My Mini Apps?
- Install Stripe in Akia here: https://sys.akia.ai/integrations/apps/stripe. (You will need to make your account in Stripe to be able to process guest payments.)
- Only Akia Admins can install Stripe, and only Stripe users will be able to view and manage any payments in Stripe.
- Click on the Mini Apps header and select the Mini App you want to add the payments to
- Remember to click Edit in the top right to begin editing the Mini App
- Click on the three dots next to any screen click Payment Configuration
![Notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2F4db08800-92cb-4deb-8f42-d4dfef6947fc%2F382f6ee2-e8e5-4852-afc9-86ed9039b2cd%2FUntitled.png?table=block&id=82b9a78c-5385-4f93-b6bc-0a8c62d697c9&cache=v2)
- Navigate to the Settings tab where you can enable payment on the Mini App, allowing you to also specify Charges or Authorization amounts
- Capture Payment: Prompt the guest to provide their credit card upon submission of the Mini App
- Capture Payment Timing: By default, Akia will not charge the guest for their ordered items from the specified Collection until you accept the guest’s order on your Orders page. You can change this to process payment immediately when the order is created or completed as well.
- Flag if Payment Succeeds: Have Akia track if the provided card is valid and if the required payment or authorization hold could process
- In your automations, you can use the conditions Payment Succeeded and Authorization Held to control when certain messages (e.g. door code) are sent to the guest if their payment could be verified
- Due to this flag being true/false, we strongly recommend not flagging if payment succeeds in multiple Mini Apps the guest might submit during their stay with your property - try limiting it to just the Registration Card or Rental Agreement
![Notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2F4db08800-92cb-4deb-8f42-d4dfef6947fc%2F3a9bb695-cb70-4567-9576-9a0abbe55730%2FUntitled.png?table=block&id=47b93475-485c-4274-a09b-fa9daec88094&cache=v2)
- Charges - List items the guest needs to pay for before submitting the Mini App, such as their balance due in addition to a mandatory resort fee
![Notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2F4db08800-92cb-4deb-8f42-d4dfef6947fc%2Feb28c6b8-95fb-4f5c-9559-69c7a937a66a%2FScreenshot_2024-08-08_at_11.56.00_AM.png?table=block&id=316126b9-f063-4e27-8620-995893032b13&cache=v2)
- Authorization - Place a hold on the guest’s credit card that is automatically released after 7 days from when the guest submits the form (you will be able to charge their card even after the hold is released within Stripe)
- The minimum hold value is $0.50 and Stripe will indefinitely keep the guest’s card information securely in their system
![Notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2F4db08800-92cb-4deb-8f42-d4dfef6947fc%2Fc99be062-26a3-4938-9f19-24f58642b862%2FUntitled.png?table=block&id=818f54fe-45e9-4874-9bdf-15b217979325&cache=v2)
Click Ok at the bottom to save the payment configuration, Save Changes in the top right of the Mini App editor to get out of the editing mode, and Publish to begin processing payments for guests!
Collections
On the Mini Apps page, you can create a new Collection. Think of these as a combination of menus and upsells that can be displayed in your Mini Apps.
![Notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2F4db08800-92cb-4deb-8f42-d4dfef6947fc%2F9a1bf79f-6821-4145-91a2-614093ab9271%2FUntitled.png?table=block&id=782e294b-49a1-43b3-98ff-a0d80350813a&cache=v2)
- Click + New Collection to create a collection manually and add items as needed. If you already have a list of items you want to include, you can select Upload CSV.
- We only need 5 columns for the CSV upload:
- Name: the name of the item the guest will see
- Description: the description of the item
- Image: image link for the item (needs to be an image link, not an image uploaded into the CSV)
- On Tap URL: the link the guest is redirected to if they click on the item in the Mini App
- Not required if the collection has Create Order selected
- Price: the price of the item
- Selecting Create Order will allow guests to purchase Collection items
- Once the collection has been created, you can add the Collection component to your Mini App (if you check marked Create Order, it would be the Menu component, otherwise it would be the Gallery component) and select which Collection you want to be shown.
- There are different types of Tap Behavior depending on what you’re looking for
- Load Detail Page (default): tapping the item will take the guest to another screen where the description is fully shown. If you also have Create Order
- Navigate to URL: the guest is automatically routed to the specified URL
- Add To Cart: tapping the item adds it to the cart, but it will not direct the guest to another screen like the Load Detail Page
- Optionally change the layout to Carousel if you want the guest to scroll through the different options
- Make the Collection required if the current page is intended for ordering that item (e.g. your early check-in screen should have the early check-in Collection required so the guest can make the request)
![Notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2F4db08800-92cb-4deb-8f42-d4dfef6947fc%2F553f94f1-490d-48a3-a64b-4e43286c2ff3%2FUntitled.png?table=block&id=0ac3cd64-ad0c-4778-88ed-253f013a07d3&cache=v2)
- Make sure you enable payments in Payment Configuration if you’re allowing guests to purchase items
- Save Changes and Publish to make the changes viewable to guests!
Charge Taxes/Collect Tips and Delivery Fee (Checkout Config)
With our checkout configuration, you can customize multiple tax line items and set up a tipping and/or delivery fee for the Mini App page. These checkout configurations are applied on a per-Mini App page basis so if different collections have different tax rates, they must be on separate Mini App pages.
- Go Settings > Checkout Configs
- Click + Add New Config
- Configure Taxes & Fees, Tip Configuration, and Delivery Fee by toggling them on/off
- Taxes & Fees are percentage based and the Delivery Fee is a flat price.
![Notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2F4db08800-92cb-4deb-8f42-d4dfef6947fc%2F25f5f3fb-cc2e-4524-aaf4-0f5faa564ada%2FUntitled.png?table=block&id=77f7ecdb-8d8f-4b74-a4eb-16cb8c54d1f8&cache=v2)
- After you have created your Checkout Config, go into the Mini App you want to add it to and click Edit in the top right corner
- You cannot configure the Checkout Config without being in the Editing mode.
- Click on the Checkout Config button in the bottom left hand corner and choose to configure a payment (Checkout Config) per page or one payment (Checkout Config) for the entire Mini App
![Notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2F4db08800-92cb-4deb-8f42-d4dfef6947fc%2F68300cd6-237e-48c2-83f0-39316e1f0c19%2FScreenshot_2024-08-07_at_5.09.58_PM.png?table=block&id=504c8983-e028-4b45-bca4-8ed09adf9dcd&cache=v2)
- After you have configured your checkout configuration by clicking Ok, click Save Changes in the top right corner and Publish to begin applying the configuration to checkout
How Do I Set Up Payments in My Agreements?
- Install Stripe in Akia here: https://sys.akia.ai/integrations/apps/stripe. (You will need to make your own account in Stripe to be able to process guest payments on your account.)
- Only Akia Admins are able to install Stripe, and only Stripe users will be able to view and manage any payments in Stripe.
- Click on your profile picture in the top right corner, go to Settings > Agreements, and select the agreement to which you want to add the payment form.
- In your Agreement editor, scroll down to the Payment section and select either Process Payment or Authorize Only to add it to your Agreement.
- The credit card information the guest provides will be stored in your Stripe account so that you can charge them later on if needed.
![When you select](https://www.notion.so/image/https%3A%2F%2Fs3-us-west-2.amazonaws.com%2Fsecure.notion-static.com%2F102df624-bdd3-4548-9bb2-5ebff516faed%2FScreen_Shot_2023-01-06_at_4.27.57_PM.png?table=block&id=8eaa7b4d-d0ac-4214-8415-2aaa587747ca&cache=v2)
- Specify your payment value amount and/or the tip amount(s) you want viewable to the guest on the Agreement.
- Note: holds are for seven days and can be managed and viewable in Stripe.
- Transaction fees apply to payment processing and tips (not holds). For more information, please contact us in the Support Chat or help@akia.com.
- Save the agreement and add it to your scheduled messages to begin sending it to guests.
Upsells
If you want to collect payment for upsells in your Agreements, it’s the exact same process!
- Install Stripe in Akia here: https://sys.akia.ai/integrations/apps/stripe. (You will need to make your own account in Stripe to be able to process guest payments on your account.)
- Only Akia Admins are able to install Stripe, and only Stripe users will be able to view and manage any payments in Stripe.
- Select the upsell items you want to offer to guests
![Notion image](https://www.notion.so/image/https%3A%2F%2Fs3-us-west-2.amazonaws.com%2Fsecure.notion-static.com%2Ff06bc83e-d9d6-446b-beb7-1e76192fd655%2FUntitled.png?table=block&id=96818df4-b60d-4cb2-8bcf-3f924bc1abf0&cache=v2)
- Done! If a guest selects an upsell, they will be prompted to input their credit card information and the payment will process immediately.
How Can I Collect Guest’s Card Information Without Charging Them?
It is not PCI compliant to ask the guest to take a photo of their credit card or ask for the raw credit card information. Instead, we strongly suggest placing a hold on the guest’s card for a small amount (e.g. $0.50) so they provide their credit card information which will then be securely stored in Stripe.
Mini Apps
Click on the three dot icon next to your screen name and select Payment Configuration
![Notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2F4db08800-92cb-4deb-8f42-d4dfef6947fc%2F0c3e4a88-2bdd-42f0-bf0b-8b0546d98fd9%2FScreenshot_2023-12-28_at_5.15.35_PM.png?table=block&id=c0505ba5-3817-415c-8855-f2fbecb4cd80&cache=v2)
In the Payment Configuration side panel, check Process Payment and then you can specify your authorization amount under Add Authorization:
![Notion image](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2F4db08800-92cb-4deb-8f42-d4dfef6947fc%2Fc2583519-2cc9-4e54-bbae-0696049d7278%2FScreenshot_2023-12-28_at_5.15.24_PM.png?table=block&id=f8b4a6da-b7c5-4f17-acdf-fdf1846ea77a&cache=v2)
After the authorization has been configured, you will see the Next button show up at the bottom of the page if you had no other form components.
Agreements
Select Process Payment and Authorize Only to require the guest to provide their credit card information before being able to complete the agreement.
![Make sure that you specify](https://www.notion.so/image/https%3A%2F%2Fprod-files-secure.s3.us-west-2.amazonaws.com%2F4db08800-92cb-4deb-8f42-d4dfef6947fc%2Fcd7e9d67-3608-40dd-9da2-5813a0b42672%2FScreenshot_2023-09-12_at_10.57.04_AM.png?table=block&id=e4303be4-6c73-42d8-9cd2-60c81dce019d&cache=v2)
Use Cases
- 💰 Tips for Housekeeping: Upon checkout, send an Agreement to guests encouraging them to tip their housekeepers.
- 🔐 Incidentals Deposit: Add Process Payment → Authorize Only in your registration card to place a hold on your guest’s card in case of incidentals.