{"action":"created","comment":{"url":"https://api.github.com/repos/Sylius/Sylius/pulls/comments/76565446","id":76565446,"diff_hunk":"@@ -4,112 +4,136 @@\n Payments\n ========\n \n-Sylius contains a very flexible payments management system with support for many gateways. (payment providers)\n-We are using very powerful payment abstraction library, called [Payum], which handles all sorts of capturing, refunding and recurring payments logic.\n+Sylius contains a very flexible payments management system with support for many gateways (payment providers).\n+We are using a payment abstraction library - `Payum <https://github.com/Payum/Payum>`_, which handles all sorts of capturing, refunding and recurring payments logic.\n \n On Sylius side, we integrate it into our checkout and manage all the payment data.\n \n Payment\n -------\n \n-Every payment in Sylius, successful or failed, is represented by *Payment* model, which contains basic information and reference to appropriate order.\n+Every payment in Sylius, successful or failed, is represented by the **Payment** model, which contains basic information and a reference to appropriate order.\n \n-Payment has following attributes:\n+Payment State Machine\n+---------------------\n \n-* id\n-* currency (code)\n-* amount\n-* reference to *PaymentMethod*\n-* reference to *Order*\n-* state\n-* reference to [PaymentSource] (optional)\n-* createdAt\n-* updatedAt\n+A Payment that is assigned to an order will have it's own state machine with a few available states:\n+``cart``, ``new``, ``processing``, ``completed``, ``failed``, ``cancelled``, ``void``, ``refunded``.\n \n-All these properties are easily accessible through simple API:\n+The available transitions between these states are:\n \n-.. code-block:: php\n+.. code-block:: yaml\n \n-    <?php\n+    transitions:","path":"docs/book/payments.rst","position":40,"original_position":40,"commit_id":"cace50020c9f7007acb61bb28302ab7123904568","original_commit_id":"cace50020c9f7007acb61bb28302ab7123904568","user":{"login":"lchrusciel","id":6213903,"avatar_url":"https://avatars.githubusercontent.com/u/6213903?v=3","gravatar_id":"","url":"https://api.github.com/users/lchrusciel","html_url":"https://github.com/lchrusciel","followers_url":"https://api.github.com/users/lchrusciel/followers","following_url":"https://api.github.com/users/lchrusciel/following{/other_user}","gists_url":"https://api.github.com/users/lchrusciel/gists{/gist_id}","starred_url":"https://api.github.com/users/lchrusciel/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lchrusciel/subscriptions","organizations_url":"https://api.github.com/users/lchrusciel/orgs","repos_url":"https://api.github.com/users/lchrusciel/repos","events_url":"https://api.github.com/users/lchrusciel/events{/privacy}","received_events_url":"https://api.github.com/users/lchrusciel/received_events","type":"User","site_admin":false},"body":"Just an idea for later. I think it would be really useful, if we would provide a graphical interpretation of these graphs instead of yaml copy-paste.","created_at":"2016-08-29T07:44:53Z","updated_at":"2016-08-29T07:44:53Z","html_url":"https://github.com/Sylius/Sylius/pull/5816#discussion_r76565446","pull_request_url":"https://api.github.com/repos/Sylius/Sylius/pulls/5816","_links":{"self":{"href":"https://api.github.com/repos/Sylius/Sylius/pulls/comments/76565446"},"html":{"href":"https://github.com/Sylius/Sylius/pull/5816#discussion_r76565446"},"pull_request":{"href":"https://api.github.com/repos/Sylius/Sylius/pulls/5816"}}},"pull_request":{"url":"https://api.github.com/repos/Sylius/Sylius/pulls/5816","id":81625899,"html_url":"https://github.com/Sylius/Sylius/pull/5816","diff_url":"https://github.com/Sylius/Sylius/pull/5816.diff","patch_url":"https://github.com/Sylius/Sylius/pull/5816.patch","issue_url":"https://api.github.com/repos/Sylius/Sylius/issues/5816","number":5816,"state":"open","locked":false,"title":"[Documentation] Concepts: Payments","user":{"login":"TheMadeleine","id":13198869,"avatar_url":"https://avatars.githubusercontent.com/u/13198869?v=3","gravatar_id":"","url":"https://api.github.com/users/TheMadeleine","html_url":"https://github.com/TheMadeleine","followers_url":"https://api.github.com/users/TheMadeleine/followers","following_url":"https://api.github.com/users/TheMadeleine/following{/other_user}","gists_url":"https://api.github.com/users/TheMadeleine/gists{/gist_id}","starred_url":"https://api.github.com/users/TheMadeleine/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/TheMadeleine/subscriptions","organizations_url":"https://api.github.com/users/TheMadeleine/orgs","repos_url":"https://api.github.com/users/TheMadeleine/repos","events_url":"https://api.github.com/users/TheMadeleine/events{/privacy}","received_events_url":"https://api.github.com/users/TheMadeleine/received_events","type":"User","site_admin":false},"body":"| Q               | A\r\n| --------------- | ---\r\n| Doc fix?        | yes\r\n| New docs?    | no\r\n| BC breaks?      | no\r\n| Related tickets | partially #5275 \r\n| License         | MIT","created_at":"2016-08-17T11:26:10Z","updated_at":"2016-08-29T07:44:53Z","closed_at":null,"merged_at":null,"merge_commit_sha":"9d83e5694afc2c3a57dc5dfde3ff3a26799c27a2","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/Sylius/Sylius/pulls/5816/commits","review_comments_url":"https://api.github.com/repos/Sylius/Sylius/pulls/5816/comments","review_comment_url":"https://api.github.com/repos/Sylius/Sylius/pulls/comments{/number}","comments_url":"https://api.github.com/repos/Sylius/Sylius/issues/5816/comments","statuses_url":"https://api.github.com/repos/Sylius/Sylius/statuses/cace50020c9f7007acb61bb28302ab7123904568","head":{"label":"TheMadeleine:docs/payments","ref":"docs/payments","sha":"cace50020c9f7007acb61bb28302ab7123904568","user":{"login":"TheMadeleine","id":13198869,"avatar_url":"https://avatars.githubusercontent.com/u/13198869?v=3","gravatar_id":"","url":"https://api.github.com/users/TheMadeleine","html_url":"https://github.com/TheMadeleine","followers_url":"https://api.github.com/users/TheMadeleine/followers","following_url":"https://api.github.com/users/TheMadeleine/following{/other_user}","gists_url":"https://api.github.com/users/TheMadeleine/gists{/gist_id}","starred_url":"https://api.github.com/users/TheMadeleine/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/TheMadeleine/subscriptions","organizations_url":"https://api.github.com/users/TheMadeleine/orgs","repos_url":"https://api.github.com/users/TheMadeleine/repos","events_url":"https://api.github.com/users/TheMadeleine/events{/privacy}","received_events_url":"https://api.github.com/users/TheMadeleine/received_events","type":"User","site_admin":false},"repo":{"id":42736498,"name":"Sylius","full_name":"TheMadeleine/Sylius","owner":{"login":"TheMadeleine","id":13198869,"avatar_url":"https://avatars.githubusercontent.com/u/13198869?v=3","gravatar_id":"","url":"https://api.github.com/users/TheMadeleine","html_url":"https://github.com/TheMadeleine","followers_url":"https://api.github.com/users/TheMadeleine/followers","following_url":"https://api.github.com/users/TheMadeleine/following{/other_user}","gists_url":"https://api.github.com/users/TheMadeleine/gists{/gist_id}","starred_url":"https://api.github.com/users/TheMadeleine/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/TheMadeleine/subscriptions","organizations_url":"https://api.github.com/users/TheMadeleine/orgs","repos_url":"https://api.github.com/users/TheMadeleine/repos","events_url":"https://api.github.com/users/TheMadeleine/events{/privacy}","received_events_url":"https://api.github.com/users/TheMadeleine/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/TheMadeleine/Sylius","description":"Modern e-commerce for PHP, based on the Symfony2 framework.","fork":true,"url":"https://api.github.com/repos/TheMadeleine/Sylius","forks_url":"https://api.github.com/repos/TheMadeleine/Sylius/forks","keys_url":"https://api.github.com/repos/TheMadeleine/Sylius/keys{/key_id}","collaborators_url":"https://api.github.com/repos/TheMadeleine/Sylius/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/TheMadeleine/Sylius/teams","hooks_url":"https://api.github.com/repos/TheMadeleine/Sylius/hooks","issue_events_url":"https://api.github.com/repos/TheMadeleine/Sylius/issues/events{/number}","events_url":"https://api.github.com/repos/TheMadeleine/Sylius/events","assignees_url":"https://api.github.com/repos/TheMadeleine/Sylius/assignees{/user}","branches_url":"https://api.github.com/repos/TheMadeleine/Sylius/branches{/branch}","tags_url":"https://api.github.com/repos/TheMadeleine/Sylius/tags","blobs_url":"https://api.github.com/repos/TheMadeleine/Sylius/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/TheMadeleine/Sylius/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/TheMadeleine/Sylius/git/refs{/sha}","trees_url":"https://api.github.com/repos/TheMadeleine/Sylius/git/trees{/sha}","statuses_url":"https://api.github.com/repos/TheMadeleine/Sylius/statuses/{sha}","languages_url":"https://api.github.com/repos/TheMadeleine/Sylius/languages","stargazers_url":"https://api.github.com/repos/TheMadeleine/Sylius/stargazers","contributors_url":"https://api.github.com/repos/TheMadeleine/Sylius/contributors","subscribers_url":"https://api.github.com/repos/TheMadeleine/Sylius/subscribers","subscription_url":"https://api.github.com/repos/TheMadeleine/Sylius/subscription","commits_url":"https://api.github.com/repos/TheMadeleine/Sylius/commits{/sha}","git_commits_url":"https://api.github.com/repos/TheMadeleine/Sylius/git/commits{/sha}","comments_url":"https://api.github.com/repos/TheMadeleine/Sylius/comments{/number}","issue_comment_url":"https://api.github.com/repos/TheMadeleine/Sylius/issues/comments{/number}","contents_url":"https://api.github.com/repos/TheMadeleine/Sylius/contents/{+path}","compare_url":"https://api.github.com/repos/TheMadeleine/Sylius/compare/{base}...{head}","merges_url":"https://api.github.com/repos/TheMadeleine/Sylius/merges","archive_url":"https://api.github.com/repos/TheMadeleine/Sylius/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/TheMadeleine/Sylius/downloads","issues_url":"https://api.github.com/repos/TheMadeleine/Sylius/issues{/number}","pulls_url":"https://api.github.com/repos/TheMadeleine/Sylius/pulls{/number}","milestones_url":"https://api.github.com/repos/TheMadeleine/Sylius/milestones{/number}","notifications_url":"https://api.github.com/repos/TheMadeleine/Sylius/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/TheMadeleine/Sylius/labels{/name}","releases_url":"https://api.github.com/repos/TheMadeleine/Sylius/releases{/id}","deployments_url":"https://api.github.com/repos/TheMadeleine/Sylius/deployments","created_at":"2015-09-18T17:21:15Z","updated_at":"2016-01-12T12:07:54Z","pushed_at":"2016-08-29T06:59:00Z","git_url":"git://github.com/TheMadeleine/Sylius.git","ssh_url":"git@github.com:TheMadeleine/Sylius.git","clone_url":"https://github.com/TheMadeleine/Sylius.git","svn_url":"https://github.com/TheMadeleine/Sylius","homepage":"Sylius.org","size":43505,"stargazers_count":0,"watchers_count":0,"language":"PHP","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"Sylius:master","ref":"master","sha":"d40812e6e1dc9ce713e1fc7c603f730de89e80e2","user":{"login":"Sylius","id":719423,"avatar_url":"https://avatars.githubusercontent.com/u/719423?v=3","gravatar_id":"","url":"https://api.github.com/users/Sylius","html_url":"https://github.com/Sylius","followers_url":"https://api.github.com/users/Sylius/followers","following_url":"https://api.github.com/users/Sylius/following{/other_user}","gists_url":"https://api.github.com/users/Sylius/gists{/gist_id}","starred_url":"https://api.github.com/users/Sylius/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Sylius/subscriptions","organizations_url":"https://api.github.com/users/Sylius/orgs","repos_url":"https://api.github.com/users/Sylius/repos","events_url":"https://api.github.com/users/Sylius/events{/privacy}","received_events_url":"https://api.github.com/users/Sylius/received_events","type":"Organization","site_admin":false},"repo":{"id":2717549,"name":"Sylius","full_name":"Sylius/Sylius","owner":{"login":"Sylius","id":719423,"avatar_url":"https://avatars.githubusercontent.com/u/719423?v=3","gravatar_id":"","url":"https://api.github.com/users/Sylius","html_url":"https://github.com/Sylius","followers_url":"https://api.github.com/users/Sylius/followers","following_url":"https://api.github.com/users/Sylius/following{/other_user}","gists_url":"https://api.github.com/users/Sylius/gists{/gist_id}","starred_url":"https://api.github.com/users/Sylius/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Sylius/subscriptions","organizations_url":"https://api.github.com/users/Sylius/orgs","repos_url":"https://api.github.com/users/Sylius/repos","events_url":"https://api.github.com/users/Sylius/events{/privacy}","received_events_url":"https://api.github.com/users/Sylius/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/Sylius/Sylius","description":"eCommerce PHP framework built on top of Symfony with component-based architecture and format-agnostic rendering. (HTML/JSON/XML)","fork":false,"url":"https://api.github.com/repos/Sylius/Sylius","forks_url":"https://api.github.com/repos/Sylius/Sylius/forks","keys_url":"https://api.github.com/repos/Sylius/Sylius/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Sylius/Sylius/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Sylius/Sylius/teams","hooks_url":"https://api.github.com/repos/Sylius/Sylius/hooks","issue_events_url":"https://api.github.com/repos/Sylius/Sylius/issues/events{/number}","events_url":"https://api.github.com/repos/Sylius/Sylius/events","assignees_url":"https://api.github.com/repos/Sylius/Sylius/assignees{/user}","branches_url":"https://api.github.com/repos/Sylius/Sylius/branches{/branch}","tags_url":"https://api.github.com/repos/Sylius/Sylius/tags","blobs_url":"https://api.github.com/repos/Sylius/Sylius/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Sylius/Sylius/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Sylius/Sylius/git/refs{/sha}","trees_url":"https://api.github.com/repos/Sylius/Sylius/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Sylius/Sylius/statuses/{sha}","languages_url":"https://api.github.com/repos/Sylius/Sylius/languages","stargazers_url":"https://api.github.com/repos/Sylius/Sylius/stargazers","contributors_url":"https://api.github.com/repos/Sylius/Sylius/contributors","subscribers_url":"https://api.github.com/repos/Sylius/Sylius/subscribers","subscription_url":"https://api.github.com/repos/Sylius/Sylius/subscription","commits_url":"https://api.github.com/repos/Sylius/Sylius/commits{/sha}","git_commits_url":"https://api.github.com/repos/Sylius/Sylius/git/commits{/sha}","comments_url":"https://api.github.com/repos/Sylius/Sylius/comments{/number}","issue_comment_url":"https://api.github.com/repos/Sylius/Sylius/issues/comments{/number}","contents_url":"https://api.github.com/repos/Sylius/Sylius/contents/{+path}","compare_url":"https://api.github.com/repos/Sylius/Sylius/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Sylius/Sylius/merges","archive_url":"https://api.github.com/repos/Sylius/Sylius/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Sylius/Sylius/downloads","issues_url":"https://api.github.com/repos/Sylius/Sylius/issues{/number}","pulls_url":"https://api.github.com/repos/Sylius/Sylius/pulls{/number}","milestones_url":"https://api.github.com/repos/Sylius/Sylius/milestones{/number}","notifications_url":"https://api.github.com/repos/Sylius/Sylius/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Sylius/Sylius/labels{/name}","releases_url":"https://api.github.com/repos/Sylius/Sylius/releases{/id}","deployments_url":"https://api.github.com/repos/Sylius/Sylius/deployments","created_at":"2011-11-05T22:05:52Z","updated_at":"2016-08-28T22:47:21Z","pushed_at":"2016-08-29T07:27:54Z","git_url":"git://github.com/Sylius/Sylius.git","ssh_url":"git@github.com:Sylius/Sylius.git","clone_url":"https://github.com/Sylius/Sylius.git","svn_url":"https://github.com/Sylius/Sylius","homepage":"http://Sylius.org","size":77283,"stargazers_count":2428,"watchers_count":2428,"language":"PHP","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":909,"mirror_url":null,"open_issues_count":810,"forks":909,"open_issues":810,"watchers":2428,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/Sylius/Sylius/pulls/5816"},"html":{"href":"https://github.com/Sylius/Sylius/pull/5816"},"issue":{"href":"https://api.github.com/repos/Sylius/Sylius/issues/5816"},"comments":{"href":"https://api.github.com/repos/Sylius/Sylius/issues/5816/comments"},"review_comments":{"href":"https://api.github.com/repos/Sylius/Sylius/pulls/5816/comments"},"review_comment":{"href":"https://api.github.com/repos/Sylius/Sylius/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/Sylius/Sylius/pulls/5816/commits"},"statuses":{"href":"https://api.github.com/repos/Sylius/Sylius/statuses/cace50020c9f7007acb61bb28302ab7123904568"}}}}
{"actor":{"display_login":"lchrusciel"}}