> For the complete documentation index, see [llms.txt](https://docs.thunkable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thunkable.com/~/changes/wHhkjLVeheBnfbpghRnw/in-app-purchases/purchase-subscription-purchase-one-time-item.md).
# Purchase Subscription / Purchase One-Time Item
### Blocks Explained
{% hint style="warning" %}
the green purchase block should be handled as a[ list/array](https://docs.thunkable.com/v/drag-and-drop/lists). The purchase [object](https://docs.thunkable.com/v/drag-and-drop/objects) is always item # 1 in the list
{% endhint %}
{% hint style="info" %}
Please note that the one-time items and subscription blocks are handled in a similiar manner.
{% endhint %}
1. a 'hider' is shown. We recommend you use a 'waiting' modal to indicate to users they should not interac
1. This could be a Group with a spinning 'loading' icon in an image component.
2. the purchase is initiated
1. you must pass in a valid [Android](https://app.gitbook.com/o/-LAn5sG4mFK2i_t-TiD1/s/KrMxDvAEx21XNB81zaoj/~/changes/8va9fno1jrAw80zwzIdp/in-app-purchases/overview/android-play-store-setup#step-2-create-the-item-or-subscription-to-purchase) or [Apple](https://app.gitbook.com/o/-LAn5sG4mFK2i_t-TiD1/s/KrMxDvAEx21XNB81zaoj/~/changes/8va9fno1jrAw80zwzIdp/in-app-purchases/overview/ios-app-store-setup#create-the-item-or-subscription-to-purchase) item or subscription id to this purple blocks input
3. If an error does occur, the error is passed on to the [Server Log](https://app.gitbook.com/o/-LAn5sG4mFK2i_t-TiD1/s/KrMxDvAEx21XNB81zaoj/~/changes/8va9fno1jrAw80zwzIdp/in-app-purchases/overview/host-your-server-side-verification-code-on-firebase/setup-your-cloud-environment/server-logs)
4. If the transaction is successful **and** the property purchaseState from object #1 in the (single item list) of purchase objects,
1. send the purchase for verification ([iOS](https://app.gitbook.com/o/-LAn5sG4mFK2i_t-TiD1/s/KrMxDvAEx21XNB81zaoj/~/changes/8va9fno1jrAw80zwzIdp/in-app-purchases/overview/verify-ios-purchases)) ([Android](https://app.gitbook.com/o/-LAn5sG4mFK2i_t-TiD1/s/KrMxDvAEx21XNB81zaoj/~/changes/8va9fno1jrAw80zwzIdp/in-app-purchases/overview/verify-and-acknowledge-android-purchases-and-subscription))
2. **else, send a** [**server log**](https://app.gitbook.com/o/-LAn5sG4mFK2i_t-TiD1/s/KrMxDvAEx21XNB81zaoj/~/changes/8va9fno1jrAw80zwzIdp/in-app-purchases/overview/host-your-server-side-verification-code-on-firebase/setup-your-cloud-environment/server-logs)****
5. Hide the hider/waiting modal after verification
Learn more about the data these blocks returnAfter you created your IAP's, you're ready to start selling them to your users!Using the corresponding `productID` created [above](https://app.gitbook.com/o/-LAn5sG4mFK2i_t-TiD1/s/KrMxDvAEx21XNB81zaoj/~/changes/8va9fno1jrAw80zwzIdp/in-app-purchases/overview/purchase-subscription-purchase-one-time-item#create-the-item-or-subscription-to-purchase), choose the appropriate block (either `Purchase Subscription` or `Purchase One-Time Item`) and connect it to a user action. Purchases should be very straight forward within your app. Make it clear for your users how much they are paying and provide a brief description of the item. You can include more details in your [app store item setup](https://app.gitbook.com/o/-LAn5sG4mFK2i_t-TiD1/s/KrMxDvAEx21XNB81zaoj/~/changes/8va9fno1jrAw80zwzIdp/in-app-purchases/overview/purchase-subscription-purchase-one-time-item#create-the-item-or-subscription-to-purchase).Once you check there wasn't an error, you should [verify](https://app.gitbook.com/o/-LAn5sG4mFK2i_t-TiD1/s/KrMxDvAEx21XNB81zaoj/~/changes/8va9fno1jrAw80zwzIdp/in-app-purchases/overview/purchase-subscription-purchase-one-time-item#verify-ios-transaction-and-purchase-status) the `purchase` (the green block). If your users are purchasing a subscription on android, you MUST complete the step of [verification and acknowledgement](https://app.gitbook.com/o/-LAn5sG4mFK2i_t-TiD1/s/KrMxDvAEx21XNB81zaoj/~/changes/8va9fno1jrAw80zwzIdp/in-app-purchases/overview/verify-and-acknowledge-android-purchases-and-subscription) in order to complete the transaction.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.thunkable.com/~/changes/wHhkjLVeheBnfbpghRnw/in-app-purchases/purchase-subscription-purchase-one-time-item.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
