<doc>
	<legacy_id></legacy_id>
	<name>mobileStoreMakePurchase</name>
	<type>command</type>

	<syntax>
		<example>mobileStoreMakePurchase <i>productID, quantity, developerPayload</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Create and send a request for a new purchase.</summary>

	<examples>
<example><p>mobileStoreMakePurchase "com.runrev.sampleapp.consumable", "1", "This belongs to me"</p><p></p></example>
<example><p>on buyConsumableProduct </p><p>   mobileStoreEnablePurchaseUpdates</p><p>   mobileStoreSetProductType "com.runrev.sampleapp.consumable", "inapp"</p><p>   mobileStoreMakePurchase "com.runrev.sampleapp.consumable", "1", "This belongs to me"</p><p>end buyConsumableProduct </p></example>
<example><p>on buySubscriptionProduct </p><p>   mobileStoreEnablePurchaseUpdates</p><p>   mobileStoreSetProductType "com.runrev.sampleapp.subscription", "subs"</p><p>   mobileStoreMakePurchase "com.runrev.sampleapp.subscription", "1", "This belongs to me"</p><p>end buySubscriptionProduct</p></example>
	</examples>

	<history>
		<introduced version="6.7">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</history>

	<objects>
	</objects>

	<platforms>
		<ios/>
		<android/>
	</platforms>

	<classes>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
	</classification>

	<references>
		<command tag="mobileStoreSetProductType">mobileStoreSetProductType command</command>
		<function tag="mobileStoreCanMakePurchase">mobileStoreCanMakePurchase function</function>
		<function tag="mobileStorePurchasedProducts">mobileStorePurchasedProducts function</function>
		<function tag="mobileStorePurchaseError">mobileStorePurchaseError function</function>
		<function tag="mobileStoreProductProperty">mobileStoreProductProperty function</function>
		<command tag="mobileStoreEnablePurchaseUpdates">mobileStoreEnablePurchaseUpdates command</command>
		<command tag="mobileStoreDisablePurchaseUpdates">mobileStoreDisablePurchaseUpdates command</command>
		<command tag="mobileStoreRestorePurchases">mobileStoreRestorePurchases command</command>
		<command tag="mobileStoreConfirmPurchase">mobileStoreConfirmPurchase command</command>
		<command tag="mobileStoreConsumePurchase">mobileStoreConsumePurchase command</command>
		<command tag="mobileStoreVerifyPurchase">mobileStoreVerifyPurchase command</command>
		<command tag="mobileStoreRequestProductDetails">mobileStoreRequestProductDetails command</command>
		<message tag="purchaseStateUpdate">purchaseStateUpdate message</message>
		<message tag="productDetailsReceived">productDetailsReceived message</message>
		<message tag="productRequestError">productRequestError message</message>
	</references>

	<description>
	<overview>Use the <b>mobileStoreMakePurchase</b> command to create and send a request for a new purchase.</overview>

		<parameters>
  <parameter>
    <name>productID</name>
    <description>Is the identifier of the requested item.</description>
  </parameter>
  <parameter>
    <name>quantity</name>
    <description>Is the quantity of the in-app purchase to buy.</description>
  </parameter>
  <parameter>
    <name>developerPayload</name>
    <description>Is a string of less than 256 characters that is returned with the purchase details once the transaction is complete. It can later be used to identify a purchase response to a specific request. </description>
  </parameter>		</parameters>

	<value></value>
	<comments>The command <b>mobileStoreMakePurchase</b> is used to create and send a request for a new purchase.<p></p><p>The <i>productID </i>is the identifier of the in-app purchase you created and wish to buy in the vendor's App Store.</p><p>The <i>quantity</i> is the the quantity of the in-app purchase to buy. This is used for iOS, and should be used on consumable items. For Android, you must set the <i>quantity</i> to "1". If you want to buy more than one consumable item, you have to purchase them one at a time.</p><p>The <i>developerPayload</i> is a string that contains additional purchase information. This only is used for Android stores.</p><p></p><p></p><p></p><note> Before calling the <b>mobileStoreMakePurchase </b>command, set the product type using <command tag="mobileStoreSetProductType">mobileStoreSetProductType, and</command> enable receipt of the purchaseStateUpdate messages through <command tag="mobileStoreEnablePurchaseUpdates">mobileStoreEnablePurchaseUpdates</command>.</note><p>&#9;</p></comments>
	</description>
</doc>