{"action":"created","comment":{"url":"https://api.github.com/repos/mercadopago/devsite-docs/pulls/comments/213483926","pull_request_review_id":150325985,"id":213483926,"node_id":"MDI0OlB1bGxSZXF1ZXN0UmV2aWV3Q29tbWVudDIxMzQ4MzkyNg==","diff_hunk":"@@ -0,0 +1,1637 @@\n+# Payment Split API Documentation\n+\n+## Introduction\n+The purpose of this document is to provide information of the endpoints that will allow offering the functionality of division of Payments to Mercado Pago clients.\n+\n+The types of client to which it is intended are:\n+- Marketplaces with shopping cart where there is one Payer and multiple Collectors.\n+- Applications for Marketplaces where there is a Payer and a Collector, for example Uber type with a driver.\n+\n+In both cases, the marketplace retains a part of the sale amount as commission.\n+\n+Aggregator mode means that each Merchant on the Marketplace has its own Pay Market account.\n+\n+## Status map\n+A Marketplace can be informed of the changes of status of a Splitter if it subscribes to the topic of \"Split of Payments\" in [Webhooks](https://www.mercadopago.com/mla/account/webhooks).\n+\n+![Status map](/images/split-de-pagos-status-map.png)\n+\n+## Idempotency\n+Sometimes, connection problems, service drops, etc. that could interrupt communication when sending or receiving data to create a Splitter may occur.\n+\n+To ensure the creation of the same, you can retry sending the same data, but it is possible that the Splitter has already been created and due to the interruption the correct answer was not received, causing that, when performing the retry, a new Splitter.\n+\n+To avoid duplication, you can send a unique key in the X-Idempotency-Key header that identifies the creation of a single Splitter no matter how many times the same data is sent.\n+\n+In this way, when the retry is done, the same key can be sent to indicate that it is the same process. If the Splitter was already created, the information is returned without creating a new one.\n+\n+```curl\n+curl -X POST \\\n+     -H 'X-Idempotency-Key: faDF8323asd298' \\\n+     -H 'accept: application/json' \\\n+     -H 'content-type: application/json' \\\n+     'https://api.mercadopago.com/v1/split_payments?access_token=ACCESS_TOKEN' \\\n+     -d '{...}'\n+```\n+\n+## Obtaining Merchant permissions and data\n+The Marketplace that wishes to integrate, must request permits from its Merchants in order to operate and make payments on its behalf. To do this, you must follow the steps of [MercadoPago Connect](https://www.mercadopago.com.ar/developers/es/solutions/payments/custom-checkout/mercadopago-connect/).\n+\n+By following these steps, the Marketplace may obtain the \"access_token\" with which you can obtain the \"email\" in the [API of \"Users\"](https://developers.mercadolibre.com/en_us/usuarios-y-aplicaciones) of Mercado Livre and the \"user_id\" that should be used as \"collector_id\" in each \"disbursement\" that you want to create in the Splitter. It is important to save the user_id and the merchant's email in order to identify the owner of the Mercado Pago account in case it is necessary.\n+\n+## Creating a Splitter\n+Splitters are entities that have 1 entry payment and several exit payments. The PAYER can make the entrance payment with several payment methods (credit card, tickets, etc.). Each payment method has its required fields, for example, to pay with credit cards you have to generate a card token as indicated in the [documentation](https://www.mercadopago.com.ar/developers/es/guides /payments/api/receiving-payment-by-card/) of Mercado Pago.\n+\n+Keep in mind that all merchants specified in each \"disbursement\" must be associated to the Marketplace through [MercadoPago Connect](https://www.mercadopago.com.ar/developers/es/solutions/payments/custom-checkout/mercadopago-connect/) (each Merchant must explicitly give permission to the Marketplace). Otherwise, the Splitter can not be created.","path":"reference/split_pagos/splitter-off-integration.en.md","position":45,"original_position":45,"commit_id":"666932c6ba346c2a6d13c6a55b49846f43a71498","original_commit_id":"666932c6ba346c2a6d13c6a55b49846f43a71498","user":{"login":"mminestrelli","id":8038535,"node_id":"MDQ6VXNlcjgwMzg1MzU=","avatar_url":"https://avatars3.githubusercontent.com/u/8038535?v=4","gravatar_id":"","url":"https://api.github.com/users/mminestrelli","html_url":"https://github.com/mminestrelli","followers_url":"https://api.github.com/users/mminestrelli/followers","following_url":"https://api.github.com/users/mminestrelli/following{/other_user}","gists_url":"https://api.github.com/users/mminestrelli/gists{/gist_id}","starred_url":"https://api.github.com/users/mminestrelli/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mminestrelli/subscriptions","organizations_url":"https://api.github.com/users/mminestrelli/orgs","repos_url":"https://api.github.com/users/mminestrelli/repos","events_url":"https://api.github.com/users/mminestrelli/events{/privacy}","received_events_url":"https://api.github.com/users/mminestrelli/received_events","type":"User","site_admin":false},"body":"- Escribir Mercado Pago separado.\r\n- El link es incorrecto (al devsite viejo), utilizar \"/guides/marketplace/api/create-marketplace.en.md\"","created_at":"2018-08-28T21:49:07Z","updated_at":"2018-08-28T21:57:11Z","html_url":"https://github.com/mercadopago/devsite-docs/pull/197#discussion_r213483926","pull_request_url":"https://api.github.com/repos/mercadopago/devsite-docs/pulls/197","author_association":"COLLABORATOR","_links":{"self":{"href":"https://api.github.com/repos/mercadopago/devsite-docs/pulls/comments/213483926"},"html":{"href":"https://github.com/mercadopago/devsite-docs/pull/197#discussion_r213483926"},"pull_request":{"href":"https://api.github.com/repos/mercadopago/devsite-docs/pulls/197"}}},"pull_request":{"url":"https://api.github.com/repos/mercadopago/devsite-docs/pulls/197","id":208284182,"node_id":"MDExOlB1bGxSZXF1ZXN0MjA4Mjg0MTgy","html_url":"https://github.com/mercadopago/devsite-docs/pull/197","diff_url":"https://github.com/mercadopago/devsite-docs/pull/197.diff","patch_url":"https://github.com/mercadopago/devsite-docs/pull/197.patch","issue_url":"https://api.github.com/repos/mercadopago/devsite-docs/issues/197","number":197,"state":"open","locked":false,"title":"Documentacion split de pagos","user":{"login":"phgoncalves","id":37298694,"node_id":"MDQ6VXNlcjM3Mjk4Njk0","avatar_url":"https://avatars2.githubusercontent.com/u/37298694?v=4","gravatar_id":"","url":"https://api.github.com/users/phgoncalves","html_url":"https://github.com/phgoncalves","followers_url":"https://api.github.com/users/phgoncalves/followers","following_url":"https://api.github.com/users/phgoncalves/following{/other_user}","gists_url":"https://api.github.com/users/phgoncalves/gists{/gist_id}","starred_url":"https://api.github.com/users/phgoncalves/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/phgoncalves/subscriptions","organizations_url":"https://api.github.com/users/phgoncalves/orgs","repos_url":"https://api.github.com/users/phgoncalves/repos","events_url":"https://api.github.com/users/phgoncalves/events{/privacy}","received_events_url":"https://api.github.com/users/phgoncalves/received_events","type":"User","site_admin":false},"body":"Añadimos la documentación de la API de split de pagos.","created_at":"2018-08-14T13:36:48Z","updated_at":"2018-08-28T21:57:11Z","closed_at":null,"merged_at":null,"merge_commit_sha":"1f4d10378579709ea30fb7ab20ee38d394f4abbd","assignee":{"login":"mminestrelli","id":8038535,"node_id":"MDQ6VXNlcjgwMzg1MzU=","avatar_url":"https://avatars3.githubusercontent.com/u/8038535?v=4","gravatar_id":"","url":"https://api.github.com/users/mminestrelli","html_url":"https://github.com/mminestrelli","followers_url":"https://api.github.com/users/mminestrelli/followers","following_url":"https://api.github.com/users/mminestrelli/following{/other_user}","gists_url":"https://api.github.com/users/mminestrelli/gists{/gist_id}","starred_url":"https://api.github.com/users/mminestrelli/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mminestrelli/subscriptions","organizations_url":"https://api.github.com/users/mminestrelli/orgs","repos_url":"https://api.github.com/users/mminestrelli/repos","events_url":"https://api.github.com/users/mminestrelli/events{/privacy}","received_events_url":"https://api.github.com/users/mminestrelli/received_events","type":"User","site_admin":false},"assignees":[{"login":"mminestrelli","id":8038535,"node_id":"MDQ6VXNlcjgwMzg1MzU=","avatar_url":"https://avatars3.githubusercontent.com/u/8038535?v=4","gravatar_id":"","url":"https://api.github.com/users/mminestrelli","html_url":"https://github.com/mminestrelli","followers_url":"https://api.github.com/users/mminestrelli/followers","following_url":"https://api.github.com/users/mminestrelli/following{/other_user}","gists_url":"https://api.github.com/users/mminestrelli/gists{/gist_id}","starred_url":"https://api.github.com/users/mminestrelli/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mminestrelli/subscriptions","organizations_url":"https://api.github.com/users/mminestrelli/orgs","repos_url":"https://api.github.com/users/mminestrelli/repos","events_url":"https://api.github.com/users/mminestrelli/events{/privacy}","received_events_url":"https://api.github.com/users/mminestrelli/received_events","type":"User","site_admin":false}],"requested_reviewers":[],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/mercadopago/devsite-docs/pulls/197/commits","review_comments_url":"https://api.github.com/repos/mercadopago/devsite-docs/pulls/197/comments","review_comment_url":"https://api.github.com/repos/mercadopago/devsite-docs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/mercadopago/devsite-docs/issues/197/comments","statuses_url":"https://api.github.com/repos/mercadopago/devsite-docs/statuses/666932c6ba346c2a6d13c6a55b49846f43a71498","head":{"label":"mercadopago:splitter-off","ref":"splitter-off","sha":"666932c6ba346c2a6d13c6a55b49846f43a71498","user":{"login":"mercadopago","id":900583,"node_id":"MDEyOk9yZ2FuaXphdGlvbjkwMDU4Mw==","avatar_url":"https://avatars3.githubusercontent.com/u/900583?v=4","gravatar_id":"","url":"https://api.github.com/users/mercadopago","html_url":"https://github.com/mercadopago","followers_url":"https://api.github.com/users/mercadopago/followers","following_url":"https://api.github.com/users/mercadopago/following{/other_user}","gists_url":"https://api.github.com/users/mercadopago/gists{/gist_id}","starred_url":"https://api.github.com/users/mercadopago/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mercadopago/subscriptions","organizations_url":"https://api.github.com/users/mercadopago/orgs","repos_url":"https://api.github.com/users/mercadopago/repos","events_url":"https://api.github.com/users/mercadopago/events{/privacy}","received_events_url":"https://api.github.com/users/mercadopago/received_events","type":"Organization","site_admin":false},"repo":{"id":79264072,"node_id":"MDEwOlJlcG9zaXRvcnk3OTI2NDA3Mg==","name":"devsite-docs","full_name":"mercadopago/devsite-docs","owner":{"login":"mercadopago","id":900583,"node_id":"MDEyOk9yZ2FuaXphdGlvbjkwMDU4Mw==","avatar_url":"https://avatars3.githubusercontent.com/u/900583?v=4","gravatar_id":"","url":"https://api.github.com/users/mercadopago","html_url":"https://github.com/mercadopago","followers_url":"https://api.github.com/users/mercadopago/followers","following_url":"https://api.github.com/users/mercadopago/following{/other_user}","gists_url":"https://api.github.com/users/mercadopago/gists{/gist_id}","starred_url":"https://api.github.com/users/mercadopago/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mercadopago/subscriptions","organizations_url":"https://api.github.com/users/mercadopago/orgs","repos_url":"https://api.github.com/users/mercadopago/repos","events_url":"https://api.github.com/users/mercadopago/events{/privacy}","received_events_url":"https://api.github.com/users/mercadopago/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/mercadopago/devsite-docs","description":"Repositorio de la documentación del sitio para desarrolladores de mercado pago","fork":false,"url":"https://api.github.com/repos/mercadopago/devsite-docs","forks_url":"https://api.github.com/repos/mercadopago/devsite-docs/forks","keys_url":"https://api.github.com/repos/mercadopago/devsite-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/mercadopago/devsite-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/mercadopago/devsite-docs/teams","hooks_url":"https://api.github.com/repos/mercadopago/devsite-docs/hooks","issue_events_url":"https://api.github.com/repos/mercadopago/devsite-docs/issues/events{/number}","events_url":"https://api.github.com/repos/mercadopago/devsite-docs/events","assignees_url":"https://api.github.com/repos/mercadopago/devsite-docs/assignees{/user}","branches_url":"https://api.github.com/repos/mercadopago/devsite-docs/branches{/branch}","tags_url":"https://api.github.com/repos/mercadopago/devsite-docs/tags","blobs_url":"https://api.github.com/repos/mercadopago/devsite-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/mercadopago/devsite-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/mercadopago/devsite-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/mercadopago/devsite-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/mercadopago/devsite-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/mercadopago/devsite-docs/languages","stargazers_url":"https://api.github.com/repos/mercadopago/devsite-docs/stargazers","contributors_url":"https://api.github.com/repos/mercadopago/devsite-docs/contributors","subscribers_url":"https://api.github.com/repos/mercadopago/devsite-docs/subscribers","subscription_url":"https://api.github.com/repos/mercadopago/devsite-docs/subscription","commits_url":"https://api.github.com/repos/mercadopago/devsite-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/mercadopago/devsite-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/mercadopago/devsite-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/mercadopago/devsite-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/mercadopago/devsite-docs/contents/{+path}","compare_url":"https://api.github.com/repos/mercadopago/devsite-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/mercadopago/devsite-docs/merges","archive_url":"https://api.github.com/repos/mercadopago/devsite-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/mercadopago/devsite-docs/downloads","issues_url":"https://api.github.com/repos/mercadopago/devsite-docs/issues{/number}","pulls_url":"https://api.github.com/repos/mercadopago/devsite-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/mercadopago/devsite-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/mercadopago/devsite-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/mercadopago/devsite-docs/labels{/name}","releases_url":"https://api.github.com/repos/mercadopago/devsite-docs/releases{/id}","deployments_url":"https://api.github.com/repos/mercadopago/devsite-docs/deployments","created_at":"2017-01-17T19:35:07Z","updated_at":"2018-08-23T20:32:53Z","pushed_at":"2018-08-24T20:31:54Z","git_url":"git://github.com/mercadopago/devsite-docs.git","ssh_url":"git@github.com:mercadopago/devsite-docs.git","clone_url":"https://github.com/mercadopago/devsite-docs.git","svn_url":"https://github.com/mercadopago/devsite-docs","homepage":"http://beta.mercadopago.com/developers","size":204255,"stargazers_count":11,"watchers_count":11,"language":"HTML","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":22,"mirror_url":null,"archived":false,"open_issues_count":26,"license":{"key":"mit","name":"MIT License","spdx_id":"MIT","url":"https://api.github.com/licenses/mit","node_id":"MDc6TGljZW5zZTEz"},"forks":22,"open_issues":26,"watchers":11,"default_branch":"master"}},"base":{"label":"mercadopago:master","ref":"master","sha":"f35ed4e1848a05b02a8cfd8f45f321a347620764","user":{"login":"mercadopago","id":900583,"node_id":"MDEyOk9yZ2FuaXphdGlvbjkwMDU4Mw==","avatar_url":"https://avatars3.githubusercontent.com/u/900583?v=4","gravatar_id":"","url":"https://api.github.com/users/mercadopago","html_url":"https://github.com/mercadopago","followers_url":"https://api.github.com/users/mercadopago/followers","following_url":"https://api.github.com/users/mercadopago/following{/other_user}","gists_url":"https://api.github.com/users/mercadopago/gists{/gist_id}","starred_url":"https://api.github.com/users/mercadopago/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mercadopago/subscriptions","organizations_url":"https://api.github.com/users/mercadopago/orgs","repos_url":"https://api.github.com/users/mercadopago/repos","events_url":"https://api.github.com/users/mercadopago/events{/privacy}","received_events_url":"https://api.github.com/users/mercadopago/received_events","type":"Organization","site_admin":false},"repo":{"id":79264072,"node_id":"MDEwOlJlcG9zaXRvcnk3OTI2NDA3Mg==","name":"devsite-docs","full_name":"mercadopago/devsite-docs","owner":{"login":"mercadopago","id":900583,"node_id":"MDEyOk9yZ2FuaXphdGlvbjkwMDU4Mw==","avatar_url":"https://avatars3.githubusercontent.com/u/900583?v=4","gravatar_id":"","url":"https://api.github.com/users/mercadopago","html_url":"https://github.com/mercadopago","followers_url":"https://api.github.com/users/mercadopago/followers","following_url":"https://api.github.com/users/mercadopago/following{/other_user}","gists_url":"https://api.github.com/users/mercadopago/gists{/gist_id}","starred_url":"https://api.github.com/users/mercadopago/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mercadopago/subscriptions","organizations_url":"https://api.github.com/users/mercadopago/orgs","repos_url":"https://api.github.com/users/mercadopago/repos","events_url":"https://api.github.com/users/mercadopago/events{/privacy}","received_events_url":"https://api.github.com/users/mercadopago/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/mercadopago/devsite-docs","description":"Repositorio de la documentación del sitio para desarrolladores de mercado pago","fork":false,"url":"https://api.github.com/repos/mercadopago/devsite-docs","forks_url":"https://api.github.com/repos/mercadopago/devsite-docs/forks","keys_url":"https://api.github.com/repos/mercadopago/devsite-docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/mercadopago/devsite-docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/mercadopago/devsite-docs/teams","hooks_url":"https://api.github.com/repos/mercadopago/devsite-docs/hooks","issue_events_url":"https://api.github.com/repos/mercadopago/devsite-docs/issues/events{/number}","events_url":"https://api.github.com/repos/mercadopago/devsite-docs/events","assignees_url":"https://api.github.com/repos/mercadopago/devsite-docs/assignees{/user}","branches_url":"https://api.github.com/repos/mercadopago/devsite-docs/branches{/branch}","tags_url":"https://api.github.com/repos/mercadopago/devsite-docs/tags","blobs_url":"https://api.github.com/repos/mercadopago/devsite-docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/mercadopago/devsite-docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/mercadopago/devsite-docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/mercadopago/devsite-docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/mercadopago/devsite-docs/statuses/{sha}","languages_url":"https://api.github.com/repos/mercadopago/devsite-docs/languages","stargazers_url":"https://api.github.com/repos/mercadopago/devsite-docs/stargazers","contributors_url":"https://api.github.com/repos/mercadopago/devsite-docs/contributors","subscribers_url":"https://api.github.com/repos/mercadopago/devsite-docs/subscribers","subscription_url":"https://api.github.com/repos/mercadopago/devsite-docs/subscription","commits_url":"https://api.github.com/repos/mercadopago/devsite-docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/mercadopago/devsite-docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/mercadopago/devsite-docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/mercadopago/devsite-docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/mercadopago/devsite-docs/contents/{+path}","compare_url":"https://api.github.com/repos/mercadopago/devsite-docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/mercadopago/devsite-docs/merges","archive_url":"https://api.github.com/repos/mercadopago/devsite-docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/mercadopago/devsite-docs/downloads","issues_url":"https://api.github.com/repos/mercadopago/devsite-docs/issues{/number}","pulls_url":"https://api.github.com/repos/mercadopago/devsite-docs/pulls{/number}","milestones_url":"https://api.github.com/repos/mercadopago/devsite-docs/milestones{/number}","notifications_url":"https://api.github.com/repos/mercadopago/devsite-docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/mercadopago/devsite-docs/labels{/name}","releases_url":"https://api.github.com/repos/mercadopago/devsite-docs/releases{/id}","deployments_url":"https://api.github.com/repos/mercadopago/devsite-docs/deployments","created_at":"2017-01-17T19:35:07Z","updated_at":"2018-08-23T20:32:53Z","pushed_at":"2018-08-24T20:31:54Z","git_url":"git://github.com/mercadopago/devsite-docs.git","ssh_url":"git@github.com:mercadopago/devsite-docs.git","clone_url":"https://github.com/mercadopago/devsite-docs.git","svn_url":"https://github.com/mercadopago/devsite-docs","homepage":"http://beta.mercadopago.com/developers","size":204255,"stargazers_count":11,"watchers_count":11,"language":"HTML","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":22,"mirror_url":null,"archived":false,"open_issues_count":26,"license":{"key":"mit","name":"MIT License","spdx_id":"MIT","url":"https://api.github.com/licenses/mit","node_id":"MDc6TGljZW5zZTEz"},"forks":22,"open_issues":26,"watchers":11,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/mercadopago/devsite-docs/pulls/197"},"html":{"href":"https://github.com/mercadopago/devsite-docs/pull/197"},"issue":{"href":"https://api.github.com/repos/mercadopago/devsite-docs/issues/197"},"comments":{"href":"https://api.github.com/repos/mercadopago/devsite-docs/issues/197/comments"},"review_comments":{"href":"https://api.github.com/repos/mercadopago/devsite-docs/pulls/197/comments"},"review_comment":{"href":"https://api.github.com/repos/mercadopago/devsite-docs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/mercadopago/devsite-docs/pulls/197/commits"},"statuses":{"href":"https://api.github.com/repos/mercadopago/devsite-docs/statuses/666932c6ba346c2a6d13c6a55b49846f43a71498"}},"author_association":"CONTRIBUTOR"}}
{"actor":{"display_login":"mminestrelli"}}