{"action":"created","comment":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/58428630","id":58428630,"diff_hunk":"@@ -0,0 +1,329 @@\n+.. _Create Coupons:\n+\n+######################\n+Creating Coupon Codes\n+######################\n+\n+.. This feature is not in Dogwood.\n+\n+You can use coupons to provide discounted or free course enrollments to your\n+learners. Each coupon includes one or more coupon codes for learners to use.\n+Two types of coupon codes are available.\n+\n+* Discount code: These codes offer a discount of up to 99% off the cost of a\n+  course.\n+* Enrollment code: These codes offer a 100% discount off the cost of a course.\n+\n+Both discount codes and enrollment codes can be used in the following ways.\n+\n+* One time by one user.\n+* One time by multiple users.\n+* Multiple times by multiple users.\n+\n+When you create a coupon, the E-Commerce service generates an order. The\n+Invoice Payment Processor module records these orders and assumes out-of-band\n+payment for the coupons. The Invoice Payment Processor module also records\n+the transaction in the Invoice table for later reconciliation.\n+\n+**************\n+Create Coupons\n+**************\n+\n+You create coupons by using the coupon administration tool, which is located at\n+``http://localhost:8002/coupons/``.\n+\n+#. In your browser, go to ``http://localhost:8002/coupons/`` to open the coupon\n+   administration tool, and then select **Create Coupon**.\n+#. On the **Create New Coupon** page, enter the following information.\n+\n+   .. note::\n+     All of the following fields are required. After you create a coupon,\n+     you can only change the **Valid from** and **Valid until** dates.\n+\n+   * **Name**: The name you want to give the coupon, such as \"Holiday 2015 15%\n+     Promotion\". The name must have fewer than 255 characters.\n+   * **Course ID**: The ID of the course that you want to provide the coupon\n+     for. To find the course ID, open the course administration tool at\n+     ``localhost:8002/courses``, select your course name in the list of\n+     courses, and then locate the **Course ID** field on the page for the\n+     course.\n+   * **Code Type**: Select either **Discount Code** or **Enrollment Code**. An\n+     enrollment code covers the entire price of a course seat. A discount code\n+     covers up to 99% of the price of a course seat.\n+   * **Seat Type**: The type of \"seat\" in the course. For example, this may be\n+     \"verified\" or \"professional\". The options for this field appear after you\n+     enter a valid value in the **Course ID** field.\n+   * **Category**: Suggested categories for your coupon code. These categories\n+     can help you keep track of your codes.\n+   * **Valid from** and **Valid until**: The dates and times when you want to\n+     start and stop offering the coupon, respectively. The time zone is\n+     set to Universal Coordinated Time (UTC). You can edit these fields after\n+     you create the coupon.\n+   * **Discount Value**: This field is only visible if you select **Discount\n+     Code** for **Code Type**. Enter the percent or U.S. dollar amount of the\n+     discount that you want to offer, then select **Percent** or **Fixed**.\n+\n+#. (Optional) On the **Create New Coupon** page, enter the following\n+   information. All of these fields are optional.\n+\n+   * **Note**: Any additional information that you want to add to your coupon,\n+     such as why the coupon was created. The note is visible on the coupon page\n+     in the coupon administration tool and in the .csv file for the coupon. It\n+     is not visible to the learner.\n+   * **Usage Limitations**: The way your coupon can be used. Options are\n+     **Can be used once by one customer**, **Can be used once by multiple\n+     customers**, or **Can be used multiple times by multiple customers**.\n+   * **Number of codes**: This field is visible if you select **Can be used\n+     once by one customer**. This value specifies the number of individual\n+     codes you want to create. Make sure that you create enough codes so that\n+     each person receives one code.\n+   * **Code**: This field is visible if you select **Can be used once by\n+     multiple customers** or **Can be used multiple times by multiple\n+     customers**.\n+\n+     * If you select **Can be used once by multiple customers**, leave this\n+       field empty. The system generates the code for you when you select\n+       **Create Coupon**.\n+\n+     * If you select **Can be used multiple times by multiple customers**, you\n+       can either enter a value in this field or leave it empty. You can enter\n+       alphanumeric characters as well as special characters such as\n+       underscores (_). For example, you can enter ``HOLIDAY_15``. If you leave\n+       this field empty, the system generates a code for you.\n+\n+   * **Client**: The name of the organization that you create the codes for.\n+     This organization receives an invoice for the codes you create.\n+   * **Total Value of Coupon**: The value of all of the codes and course seats\n+     that are associated with this coupon, calculated as a product of the\n+     number of discount or enrollment codes, the number of course seats that\n+     each code applies to, and the discount amount per course seat. The system\n+     calculates this value automatically, and the value cannot be changed.\n+   * **Total to Invoice to Client**: The amount that the client pays for this\n+     coupon. If this value is the same as the value for **Total Value of\n+     Coupon**, you can leave this field blank. If you want to invoice the\n+     client for a different amount, enter that amount in this field.\n+\n+#. Select **Create Coupon**.\n+\n+When you select **Create Coupon**, a page for your coupon opens. This page\n+lists the information for your coupon, including any individual discount or\n+enrollment codes that the system generated as well as the URLs where users can\n+redeem each discount or enrollment code. To download a .csv file that lists\n+this information and additional information, select **Download**.","path":"en_us/install_operations/source/ecommerce/additional_features/create_coupons.rst","position":112,"original_position":112,"commit_id":"4f83c37c09e47dbb1aa91bf8e6354bf6b14151cd","original_commit_id":"4f83c37c09e47dbb1aa91bf8e6354bf6b14151cd","user":{"login":"catong","id":9041399,"avatar_url":"https://avatars.githubusercontent.com/u/9041399?v=3","gravatar_id":"","url":"https://api.github.com/users/catong","html_url":"https://github.com/catong","followers_url":"https://api.github.com/users/catong/followers","following_url":"https://api.github.com/users/catong/following{/other_user}","gists_url":"https://api.github.com/users/catong/gists{/gist_id}","starred_url":"https://api.github.com/users/catong/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/catong/subscriptions","organizations_url":"https://api.github.com/users/catong/orgs","repos_url":"https://api.github.com/users/catong/repos","events_url":"https://api.github.com/users/catong/events{/privacy}","received_events_url":"https://api.github.com/users/catong/received_events","type":"User","site_admin":false},"body":"Cross-ref to the \"Download\" procedure instead?","created_at":"2016-04-04T18:57:25Z","updated_at":"2016-04-04T18:57:25Z","html_url":"https://github.com/edx/edx-documentation/pull/911#discussion_r58428630","pull_request_url":"https://api.github.com/repos/edx/edx-documentation/pulls/911","_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/58428630"},"html":{"href":"https://github.com/edx/edx-documentation/pull/911#discussion_r58428630"},"pull_request":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/911"}}},"pull_request":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/911","id":62606189,"html_url":"https://github.com/edx/edx-documentation/pull/911","diff_url":"https://github.com/edx/edx-documentation/pull/911.diff","patch_url":"https://github.com/edx/edx-documentation/pull/911.patch","issue_url":"https://api.github.com/repos/edx/edx-documentation/issues/911","number":911,"state":"open","locked":false,"title":"Documentation for coupon codes","user":{"login":"srpearce","id":3493253,"avatar_url":"https://avatars.githubusercontent.com/u/3493253?v=3","gravatar_id":"","url":"https://api.github.com/users/srpearce","html_url":"https://github.com/srpearce","followers_url":"https://api.github.com/users/srpearce/followers","following_url":"https://api.github.com/users/srpearce/following{/other_user}","gists_url":"https://api.github.com/users/srpearce/gists{/gist_id}","starred_url":"https://api.github.com/users/srpearce/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/srpearce/subscriptions","organizations_url":"https://api.github.com/users/srpearce/orgs","repos_url":"https://api.github.com/users/srpearce/repos","events_url":"https://api.github.com/users/srpearce/events{/privacy}","received_events_url":"https://api.github.com/users/srpearce/received_events","type":"User","site_admin":false},"body":"","created_at":"2016-03-11T21:37:03Z","updated_at":"2016-04-04T18:57:25Z","closed_at":null,"merged_at":null,"merge_commit_sha":"fad03e6304e9b339c01b38b6ad517ebfcb92e4a4","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/edx/edx-documentation/pulls/911/commits","review_comments_url":"https://api.github.com/repos/edx/edx-documentation/pulls/911/comments","review_comment_url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments{/number}","comments_url":"https://api.github.com/repos/edx/edx-documentation/issues/911/comments","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/4f83c37c09e47dbb1aa91bf8e6354bf6b14151cd","head":{"label":"edx:sylvia/DOC-2516","ref":"sylvia/DOC-2516","sha":"4f83c37c09e47dbb1aa91bf8e6354bf6b14151cd","user":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"repo":{"id":23839256,"name":"edx-documentation","full_name":"edx/edx-documentation","owner":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/edx/edx-documentation","description":"For published versions of the edX documentation, visit:","fork":false,"url":"https://api.github.com/repos/edx/edx-documentation","forks_url":"https://api.github.com/repos/edx/edx-documentation/forks","keys_url":"https://api.github.com/repos/edx/edx-documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/edx/edx-documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/edx/edx-documentation/teams","hooks_url":"https://api.github.com/repos/edx/edx-documentation/hooks","issue_events_url":"https://api.github.com/repos/edx/edx-documentation/issues/events{/number}","events_url":"https://api.github.com/repos/edx/edx-documentation/events","assignees_url":"https://api.github.com/repos/edx/edx-documentation/assignees{/user}","branches_url":"https://api.github.com/repos/edx/edx-documentation/branches{/branch}","tags_url":"https://api.github.com/repos/edx/edx-documentation/tags","blobs_url":"https://api.github.com/repos/edx/edx-documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/edx/edx-documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/edx/edx-documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/edx/edx-documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/edx/edx-documentation/languages","stargazers_url":"https://api.github.com/repos/edx/edx-documentation/stargazers","contributors_url":"https://api.github.com/repos/edx/edx-documentation/contributors","subscribers_url":"https://api.github.com/repos/edx/edx-documentation/subscribers","subscription_url":"https://api.github.com/repos/edx/edx-documentation/subscription","commits_url":"https://api.github.com/repos/edx/edx-documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/edx/edx-documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/edx/edx-documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/edx/edx-documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/edx/edx-documentation/contents/{+path}","compare_url":"https://api.github.com/repos/edx/edx-documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/edx/edx-documentation/merges","archive_url":"https://api.github.com/repos/edx/edx-documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/edx/edx-documentation/downloads","issues_url":"https://api.github.com/repos/edx/edx-documentation/issues{/number}","pulls_url":"https://api.github.com/repos/edx/edx-documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/edx/edx-documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/edx/edx-documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/edx/edx-documentation/labels{/name}","releases_url":"https://api.github.com/repos/edx/edx-documentation/releases{/id}","deployments_url":"https://api.github.com/repos/edx/edx-documentation/deployments","created_at":"2014-09-09T15:29:04Z","updated_at":"2016-03-26T02:20:10Z","pushed_at":"2016-04-04T18:53:23Z","git_url":"git://github.com/edx/edx-documentation.git","ssh_url":"git@github.com:edx/edx-documentation.git","clone_url":"https://github.com/edx/edx-documentation.git","svn_url":"https://github.com/edx/edx-documentation","homepage":" http://docs.edx.org","size":99692,"stargazers_count":35,"watchers_count":35,"language":"Makefile","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":130,"mirror_url":null,"open_issues_count":33,"forks":130,"open_issues":33,"watchers":35,"default_branch":"master"}},"base":{"label":"edx:master","ref":"master","sha":"1f56d87f8c4d0ae8106cd130ee58841f25ae9346","user":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"repo":{"id":23839256,"name":"edx-documentation","full_name":"edx/edx-documentation","owner":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/edx/edx-documentation","description":"For published versions of the edX documentation, visit:","fork":false,"url":"https://api.github.com/repos/edx/edx-documentation","forks_url":"https://api.github.com/repos/edx/edx-documentation/forks","keys_url":"https://api.github.com/repos/edx/edx-documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/edx/edx-documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/edx/edx-documentation/teams","hooks_url":"https://api.github.com/repos/edx/edx-documentation/hooks","issue_events_url":"https://api.github.com/repos/edx/edx-documentation/issues/events{/number}","events_url":"https://api.github.com/repos/edx/edx-documentation/events","assignees_url":"https://api.github.com/repos/edx/edx-documentation/assignees{/user}","branches_url":"https://api.github.com/repos/edx/edx-documentation/branches{/branch}","tags_url":"https://api.github.com/repos/edx/edx-documentation/tags","blobs_url":"https://api.github.com/repos/edx/edx-documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/edx/edx-documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/edx/edx-documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/edx/edx-documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/edx/edx-documentation/languages","stargazers_url":"https://api.github.com/repos/edx/edx-documentation/stargazers","contributors_url":"https://api.github.com/repos/edx/edx-documentation/contributors","subscribers_url":"https://api.github.com/repos/edx/edx-documentation/subscribers","subscription_url":"https://api.github.com/repos/edx/edx-documentation/subscription","commits_url":"https://api.github.com/repos/edx/edx-documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/edx/edx-documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/edx/edx-documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/edx/edx-documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/edx/edx-documentation/contents/{+path}","compare_url":"https://api.github.com/repos/edx/edx-documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/edx/edx-documentation/merges","archive_url":"https://api.github.com/repos/edx/edx-documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/edx/edx-documentation/downloads","issues_url":"https://api.github.com/repos/edx/edx-documentation/issues{/number}","pulls_url":"https://api.github.com/repos/edx/edx-documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/edx/edx-documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/edx/edx-documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/edx/edx-documentation/labels{/name}","releases_url":"https://api.github.com/repos/edx/edx-documentation/releases{/id}","deployments_url":"https://api.github.com/repos/edx/edx-documentation/deployments","created_at":"2014-09-09T15:29:04Z","updated_at":"2016-03-26T02:20:10Z","pushed_at":"2016-04-04T18:53:23Z","git_url":"git://github.com/edx/edx-documentation.git","ssh_url":"git@github.com:edx/edx-documentation.git","clone_url":"https://github.com/edx/edx-documentation.git","svn_url":"https://github.com/edx/edx-documentation","homepage":" http://docs.edx.org","size":99692,"stargazers_count":35,"watchers_count":35,"language":"Makefile","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":130,"mirror_url":null,"open_issues_count":33,"forks":130,"open_issues":33,"watchers":35,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/911"},"html":{"href":"https://github.com/edx/edx-documentation/pull/911"},"issue":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/911"},"comments":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/911/comments"},"review_comments":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/911/comments"},"review_comment":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/911/commits"},"statuses":{"href":"https://api.github.com/repos/edx/edx-documentation/statuses/4f83c37c09e47dbb1aa91bf8e6354bf6b14151cd"}}}}