diff --git a/guides/additional-content/reports/released-money/api.en.md b/guides/additional-content/reports/released-money/api.en.md index 4b52d42292..05aabb27db 100644 --- a/guides/additional-content/reports/released-money/api.en.md +++ b/guides/additional-content/reports/released-money/api.en.md @@ -35,7 +35,7 @@ You can configure your reports as needed. Below, we highlight the available API > Have the [Glossary of the Releases Report](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/en/guides/additional-content/reports/released-money/glossary) on hand for reference whenever needed or to check any technical terms. -## Create a new configuration +### Create a new configuration Customize your reports by assigning different creation properties by running the following _curl_: diff --git a/guides/additional-content/reports/released-money/api.es.md b/guides/additional-content/reports/released-money/api.es.md index 85f76413d4..27e925f63a 100644 --- a/guides/additional-content/reports/released-money/api.es.md +++ b/guides/additional-content/reports/released-money/api.es.md @@ -36,7 +36,7 @@ Puedes configurar tus reportes según sea necesario. A continuación, destacamos > Ten a mano el [Glossário del Reporte de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/glossary) para consultarlo siempre que sea necesario o para verificar algún término técnico. -## Crear una nueva configuración +### Crear una nueva configuración Personaliza tus reportes asignando diferentes propiedades de creación ejecutando el siguiente _curl_: diff --git a/guides/additional-content/reports/released-money/api.pt.md b/guides/additional-content/reports/released-money/api.pt.md index 25a1fbc0fe..f3041ec625 100644 --- a/guides/additional-content/reports/released-money/api.pt.md +++ b/guides/additional-content/reports/released-money/api.pt.md @@ -35,7 +35,7 @@ Você pode configurar seus relatórios conforme necessário. Abaixo, destacamos > Tenha o [Glossário do relatório de ----[mla]---- Liquidações ------------ ----[mlm, mlb, mlc, mco, mlu, mpe]---- Liberações ------------](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/pt/guides/additional-content/reports/released-money/glossary) à mão para consulta sempre que necessário ou para conferir algum termo técnico. -## Criar uma nova configuração +### Criar uma nova configuração Personalize seus relatórios atribuindo diferentes propriedades de criação executando o seguinte _curl_: diff --git a/guides/marketplace/integrate-marketplace.en.md b/guides/marketplace/integrate-marketplace.en.md index e49b89b9f6..80d0cd9cd5 100644 --- a/guides/marketplace/integrate-marketplace.en.md +++ b/guides/marketplace/integrate-marketplace.en.md @@ -4,10 +4,10 @@ Marketplace is an e-commerce site/platform that connects sellers and buyers in a In addition to the structure needed to make sales, some marketplaces take care of the arrangement of products, payment and shipping methods, optimizing the sales process and facilitating business management. -If you choose to sell through a Marketplace, it is possible to integrate **two types of Mercado Pago checkout** to process payments made. +If you choose to sell through a marketplace, it is possible to integrate **two types of Mercado Pago checkout** to process payments. * [Checkout Pro](/developers/en/guides/checkout-pro/landing): In this checkout model, the buyer is directed to a Mercado Pago page to complete the payment. -* [Checkout API](/developers/en/guides/checkout-api/introduction): This checkout model allows the buyer to make the payment within the marketplace environment. +* ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/en/guides/checkout-api/introduction)----------------[mlb]----[Checkout Transparente](/developers/en/guides/checkout-api/introduction)------------: This checkout model allows the buyer to make the payment within the marketplace environment. Both checkouts automatically split the amounts between the seller and the marketplace through the _split_ payment @@ -17,14 +17,53 @@ Both checkouts automatically split the amounts between the seller and the market > > The Mercado Pago commission is deducted from the amount received by the seller. In other words, the Mercado Pago commission is deducted first and the Marketplace commission is deducted from the remaining amount. -To perform the integration you will need to follow the usual integration flow of the chosen checkout necessarily using an access token for each seller, obtained through OAuth. Below we list the steps required to integrate a checkout with the marketplace. +To perform the integration, you will need to follow the usual integration flow of the chosen checkout, necessarily using an access token for each seller, obtained through OAuth. Below we list the steps required to integrate a checkout with the marketplace. 1. Follow the steps described in the [OAuth documentation](/developers/en/guides/additional-content/security/oauth/introduction) to get each `access_token`. This information will be needed during the checkout integration process into the marketplace. -2. Choose the type of checkout you want ([Checkout Pro](/developers/en/guides/checkout-pro/landing) or [Checkout API](/developers/en/guides/checkout-api/introduction) and follow the entire onboarding flow. -3. In the checkout integration, use the `public_key` of your integrator account in the frontend and insert the seller's `access_token` obtained in step 1, in the backend or in the request header. +2. Choose the type of checkout you want ([Checkout Pro](/developers/en/guides/checkout-pro/landing) or ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/en/guides/checkout-api/introduction)----------------[mlb]----[Checkout Transparente](/developers/en/guides/checkout-api/introduction)------------) and follow the entire onboarding flow. +3. In the checkout integration, use the `public_key` of your integrator account in the frontend and insert the seller's `access_token` (obtained in step 1) in the backend or in the request header. 4. To determine the marketplace commission percentage: - - If the checkout is Pro, fill the `marketplace_fee` parameter with the amount to be charged for each payment preference created in the **/checkout/preferences** API. - - If the checkout is API, fill the `application_fee` parameter with the amount to be charged for each payment created in the **/payments** API. + - If it's Checkout Pro, fill the `marketplace_fee` parameter with the amount to be charged for each payment preference created in the **/checkout/preferences** API. -Upon completing these steps, the checkout will have been integrated into the marketplace and will be ready to process payments. +
+ +#### Example + +```json + { + "items": [ + { + "id": "item-ID-1234", + "title": "Meu produto", + "currency_id": "BRL", + "quantity": 1, + "unit_price": 75.76 + } + ], + "marketplace_fee": 10 + } +``` + + - If it's Checkout ----[mla, mlu, mpe, mco, mlc, mlm]----API------------ ----[mlb]----Transparente------------, fill the `application_fee` parameter with the amount to be charged for each payment created in the **/payments** API. + +
+ +#### Example + +```json + { + "description": "API TRANSPARENTE MARKETPLACE", + "installments": 1, + "token": "{{card_token}}", + "payer": { + "id": "{{payer_id}}" + }, + "marketplace": "{{marketplace_id}}", + "payment_method_id": "master", + "application_fee": 2, + "transaction_amount": 10 + } +``` + +Upon completing these steps, the checkout will have been integrated into the marketplace and will be ready to process payments. \ No newline at end of file diff --git a/guides/marketplace/integrate-marketplace.es.md b/guides/marketplace/integrate-marketplace.es.md index 970487f5b5..1de4d38928 100644 --- a/guides/marketplace/integrate-marketplace.es.md +++ b/guides/marketplace/integrate-marketplace.es.md @@ -6,9 +6,8 @@ Además de la estructura necesaria para realizar las ventas, algunos _marketplac Si eliges vender a través de un _marketplace_, es posible integrar **dos tipos de checkout de Mercado Pago** para procesar los pagos realizados. - -* [Checkout Pro](/developers/es/guides/checkout-pro/landing): en este modelo de checkout, el comprador es dirigido a una página de Mercado Pago para completar el pago. -* ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/es/guides/checkout-api/introduction)------------ ----[mlb]----[Checkout Transparente](/developers/es/guides/checkout-api/introduction)------------: este modelo de pago permite al comprador realizar el pago dentro del entorno del _marketplace_. +* [Checkout Pro](/developers/es/guides/checkout-pro/landing): en este modelo de checkout, el comprador es dirigido a una página de Mercado Pago para completar el pago. +* ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/es/guides/checkout-api/introduction)----------------[mlb]----[Checkout Transparente](/developers/es/guides/checkout-api/introduction)------------: este modelo de pago permite al comprador realizar el pago dentro del entorno del _marketplace_. Ambos checkouts reparten automáticamente los importes entre el vendedor y el _marketplace_ a través del _split del pago_ sin necesidad de ninguna acción por parte del vendedor. @@ -16,16 +15,55 @@ Ambos checkouts reparten automáticamente los importes entre el vendedor y el _m > > Importante > -> La comisión de Mercado Pago se descuenta de los fondos recibidos por el vendedor. Es decir, primero se descuenta la comisión de Mercado Pago y la comisión del marketplace se descuenta del saldo restante. +> La comisión de Mercado Pago se descuenta de los fondos recibidos por el vendedor. Es decir, primero se descuenta la comisión de Mercado Pago, y la comisión del marketplace se descuenta del saldo restante. -Para realizar la integración deberás seguir el flujo de integración habitual del _checkout_ elegido, utilizando necesariamente un token de acceso para cada vendedor, obtenido a través de OAuth. A continuación, enumeramos los pasos necesarios para integrar una caja con el _mercado_. +Para realizar la integración deberás seguir el flujo de integración habitual del _checkout_ elegido, utilizando necesariamente el token de acceso para cada vendedor que fue obtenido a través de OAuth. A continuación, enumeramos los pasos necesarios para integrar una caja con el _marketplace_. 1. Sigue los pasos descritos en la [documentación de OAuth](/developers/es/guides/additional-content/security/oauth/introduction) para obtener cada `access_token`. Esta información será necesaria durante el proceso de integración de pago en el _marketplace_. -2. Elige el tipo de pago que desea ([Checkout Pro](/developers/es/guides/checkout-pro/landing) o ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/es/guides/checkout-api/introduction)------------ ----[mlb]----[Checkout Transparente](/developers/es/guides/checkout-api/introduction)------------) y sigue todo el flujo de integración. -3. En la integración del _checkout_, usa la `public_key` de tu cuenta de integrador en el frontend e inserta el `access_token` del vendedor obtenido en el paso 1, en el backend o en el _header_ de la solicitud. -4. Para determinar el porcentaje de comisión del mercado: +2. Elige el checkout que deseas ([Checkout Pro](/developers/es/guides/checkout-pro/landing) o ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/es/guides/checkout-api/introduction)------------ ----[mlb]----[Checkout Transparente](/developers/es/guides/checkout-api/introduction)------------) y sigue todo el flujo de integración. +3. En la integración del _checkout_, usa la `public_key` de tu cuenta de integrador en el _frontend_ e inserta el `access_token` del vendedor (obtenido en el paso 1) en el _backend_ o en el _header_ de la solicitud. +4. Para determinar el porcentaje de comisión del marketplace: + + - Si es Checkout Pro, completa el parámetro `marketplace_fee` con el monto que se cobrará por cada preferencia de pago creada en la API **/checkout/preferences**. + +
+ +#### Ejemplo + +```json + { + "items": [ + { + "id": "item-ID-1234", + "title": "Meu produto", + "currency_id": "BRL", + "quantity": 1, + "unit_price": 75.76 + } + ], + "marketplace_fee": 10 + } +``` + + - Si es Checkout ----[mla, mlu, mpe, mco, mlc, mlm]----API------------ ----[mlb]----Transparente------------, completa el parámetro `application_fee` con el monto que se cobrará por cada pago creado en la API **/payments**. + +
+ +#### Ejemplo - - Si el checkout es Pro, completa el parámetro `marketplace_fee` con el monto que se cobrará por cada preferencia de pago creada en la API **/checkout/preferences**. - - Si el checkout es transparente, completa el parámetro `application_fee` con el monto que se cobrará por cada pago creado en la API **/payments**. +```json + { + "description": "API TRANSPARENTE MARKETPLACE", + "installments": 1, + "token": "{{card_token}}", + "payer": { + "id": "{{payer_id}}" + }, + "marketplace": "{{marketplace_id}}", + "payment_method_id": "master", + "application_fee": 2, + "transaction_amount": 10 + } +``` -Al completar estos pasos, el pago se habrá integrado en el _marketplace_ y estará listo para procesar pagos. +Al completar estos pasos, el checkout se habrá integrado en el _marketplace_ y estará listo para procesar pagos. \ No newline at end of file diff --git a/guides/marketplace/integrate-marketplace.pt.md b/guides/marketplace/integrate-marketplace.pt.md index f64eebf98b..536237169a 100644 --- a/guides/marketplace/integrate-marketplace.pt.md +++ b/guides/marketplace/integrate-marketplace.pt.md @@ -4,28 +4,66 @@ Marketplace é um site/plataforma de e-commerce que conecta vendedores e comprad Além da estrutura necessária para realizar vendas, alguns _marketplaces_ cuidam da disposição dos produtos, métodos de pagamento e envio, otimizando o processo de venda e facilitando o gerenciamento do negócio. -Caso escolha vender através de um Marketplace, é possível integrar **dois tipos de checkout do Mercado Pago** para processar os pagamentos realizados. +Caso escolha vender através de um _marketplace_, é possível integrar **dois tipos de checkout do Mercado Pago** para processar os pagamentos realizados. -* [Checkout Pro](/developers/pt/guides/checkout-pro/landing): Neste modelo de checkout o comprador é direcionado para uma página do Mercado Pago para concluir o pagamento. -* ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/pt/guides/checkout-api/introduction)------------ ----[mlb]----[Checkout Transparente](/developers/pt/guides/checkout-api/introduction)------------: Este modelo de checkout permite ao comprador realizar o pagamento dentro do ambiente do _marketplace_. +* [Checkout Pro](/developers/pt/guides/checkout-pro/landing): Neste modelo de checkout, o comprador é direcionado para uma página do Mercado Pago para concluir o pagamento. +* ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/pt/guides/checkout-api/introduction)----------------[mlb]----[Checkout Transparente](/developers/pt/guides/checkout-api/introduction)------------: Este modelo de checkout permite ao comprador realizar o pagamento dentro do ambiente do _marketplace_. -Ambos checkouts realizam automaticamente a divisão dos valores entre o vendedor e o _marketplace_ por meio do _split_ de pagamento, sem a necessidade de qualquer ação por parte do vendedor. +Ambos os checkouts realizam automaticamente a divisão dos valores entre o vendedor e o _marketplace_ por meio do _split_ de pagamento, sem a necessidade de qualquer ação por parte do vendedor. > NOTE > > Importante > -> A comissão do Mercado Pago é descontada do valor recebido pelo vendedor. Ou seja, primeiro é descontada a comissão do Mercado Pago e sobre o valor restante se desconta a comissão do Marketplace. +> A comissão do Mercado Pago é descontada do valor recebido pelo vendedor. Ou seja, primeiro, a comissão do Mercado Pago é descontada e, em seguida, a comissão do Marketplace é descontada sobre o valor restante. -Para realizar a integração você precisará seguir o fluxo de integração usual do checkout escolhido necessariamente usando um access token para cada vendedor, obtido através de OAuth. Abaixo listamos as etapas necessárias para integrar um checkout ao _marketplace_. +Para realizar a integração você precisará seguir o fluxo de integração usual do checkout escolhido utilizando um _access token_ para cada vendedor, obtido através de OAuth. Abaixo, listamos as etapas necessárias para integrar um checkout ao _marketplace_. 1. Siga as etapas descritas na [documentação OAuth](/developers/pt/guides/additional-content/security/oauth/introduction) para obter cada `access_token`. Esta informação será necessária durante o processo de integração do checkout ao _marketplace_. -2. Escolha o tipo de checkout que deseja ([Checkout Pro](/developers/pt/guides/checkout-pro/landing) ou ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/pt/guides/checkout-api/introduction------------ ----[mlb]----[Checkout Transparente](/developers/pt/guides/checkout-api/introduction)------------) e siga todo o fluxo de integração. -3. Na integração do checkout, utilize a `public_key` da sua conta de integrador no frontend e insira o `access_token` do vendedor obtido na etapa 1, no backend ou no header da requisição. - +2. Escolha o tipo de checkout ([Checkout Pro](/developers/pt/guides/checkout-pro/landing) ou ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/pt/guides/checkout-api/introduction------------ ----[mlb]----[Checkout Transparente](/developers/pt/guides/checkout-api/introduction)------------)) e siga o fluxo de integração. +3. Na integração do checkout, utilize a `public_key` da sua conta de integrador no _frontend_ e insira o `access_token` do vendedor (obtido na etapa 1) no _backend_ ou no _header_ da requisição. 4. Para determinar a porcentagem de comissão do marketplace: - - Se o checkout for Pro, preencha o parâmetro `marketplace_fee` com o valor a ser cobrado para cada preferência de pagamento criada na API **/checkout/preferences**. - - Se o checkout for Transparente, preencha o parâmetro `application_fee` com o valor a ser cobrado para cada pagamento criado na API **/payments**. + - Se o checkout for Pro, preencha o parâmetro `marketplace_fee` com o valor a ser cobrado para cada preferência de pagamento criada na API **/checkout/preferences**. + +
+ +#### Exemplo + +```json + { + "items": [ + { + "id": "item-ID-1234", + "title": "Meu produto", + "currency_id": "BRL", + "quantity": 1, + "unit_price": 75.76 + } + ], + "marketplace_fee": 10 + } +``` + + - Se o checkout for ----[mla, mlu, mpe, mco, mlc, mlm]----API------------ ----[mlb]----Transparente------------, preencha o parâmetro `application_fee` com o valor a ser cobrado para cada pagamento criado na API **/payments**. + +
+ +#### Exemplo + +```json + { + "description": "API TRANSPARENTE MARKETPLACE", + "installments": 1, + "token": "{{card_token}}", + "payer": { + "id": "{{payer_id}}" + }, + "marketplace": "{{marketplace_id}}", + "payment_method_id": "master", + "application_fee": 2, + "transaction_amount": 10 + } +``` -Ao concluir essas etapas, o checkout terá sido integrado ao _marketplace_ e estará pronto para processar os pagamentos. +Ao finalizar essas etapas, a integração do checkout com o _marketplace_ estará concluída e pronta para processar os pagamentos. \ No newline at end of file diff --git a/guides/split-payment/configuration.en.md b/guides/split-payment/configuration.en.md new file mode 100644 index 0000000000..36cc173370 --- /dev/null +++ b/guides/split-payment/configuration.en.md @@ -0,0 +1,144 @@ +# Create configuration + +To configure the integration with the Split Payments solution, you will need to [create your application](#bookmark_create_application), [request permissions from your users](#bookmark_request_permission_from_users), and [obtain the credentials](#bookmark_obtain_credentials). Keep reading to create the required configuration. + +## Create application + +Create your application to integrate with the Split Payments solution by following the steps below. + + > NOTE + > + > Important + > + > During the creation of your application, it may be necessary to reauthenticate your identity. If you have already completed the verification, reauthentication will be requested. Otherwise, you will be redirected to submit the necessary documents. This additional step is essential to protect your account and ensure compliance with operations. You can refer to the [Developer dashboard documentation](/developers/es/docs/split-payment/additional-content/your-integrations/dashboard) if you have any questions on how to use it. + +1. Access [Your Integrations](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/panel/app). Once there, click on the **Create application** button, located in the upper right corner. +2. Enter a name to identify your application (you have a limit of 50 characters). +3. Choose the **Online Payments** solution. +4. When choosing the product to integrate, you can select "Checkout Pro" or "Checkout API". +5. Choose the **Marketplace** integration model. +6. Once you have completed the requested information, click on **Create application** and you're done! + +### Configure the Redirect URL + +In this step, it is necessary to configure the Redirect URL so that sellers can authorize the marketplace to carry out sales. + +After creating the application, it is necessary to go to the editing screen to fill in the Redirect URL field (in OAuth requests, it is displayed as redirect_uri), which must contain the URL of the marketplace site where the seller's token will be sent upon completing the linking process. + +![Redirect URL](/images/split-payment/redirect-url-es.png) + +## Request permission from users + +To request permission from your users to manage sales on their behalf, it is necessary to implement the authorization flow using OAuth. Follow the steps below: + +1. Redirect your users to the following URL to authorize sales management: + +| Value | Description | +|----------------------|----------------------------------------------------------------------------------------------------------------------| +| `` | Value obtained during [application creation](/developers/en/docs/split-payment/integration-configuration/create-application). | +| `` | Value entered in the Redirect URI field during [Redirect URL configuration](/developers/en/docs/split-payment/integration-configuration/create-application). | + +----[mla]---- +```curl +https://auth.mercadopago.com.ar/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ +----[mlb]---- +```curl +https://auth.mercadopago.com.br/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ +----[mlm]---- +```curl +https://auth.mercadopago.com.mx/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ +----[mlc]---- +```curl +https://auth.mercadopago.cl/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ +----[mco]---- +```curl +https://auth.mercadopago.com.co/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ +----[mlu]---- +```curl +https://auth.mercadopago.com.uy/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ +----[mpe]---- +```curl +https://auth.mercadopago.com.pe/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ + + +2. Once users authorize sales management, you will receive an authorization code in the URL you specified in the previous step. This code will be in the `code` parameter as follows: + +```curl +http://?code=AUTHORIZATION_CODE +``` + +> NOTE +> +> Nota +> +> The `AUTHORIZATION_CODE` is valid for 10 minutes and will be used to create the necessary credentials. + +## Obtain credentials + +Use the authorization code obtained in the previous step to acquire user credentials through the [OAuth API](/developers/en/reference/oauth/_oauth_token/post), enabling you to manage their sales. + +| Parameter | Description | +|--------------------------|--------------------------------------------------------------------------------------------------| +| `` | Value of APP_ID obtained in the details of your application. | +| `` | Your SECRET_KEY, also available in the details of your application. | +| `` | Authorization code obtained when redirecting the user back to your site. | +| `` | Should be the same Redirect URI configured in your application. | + +```curl +curl -X POST \ + -H 'accept: application/json' \ + -H 'content-type: application/x-www-form-urlencoded' \ + 'https://api.mercadopago.com/oauth/token' \ + -d 'client_id=' \ + -d 'client_secret=' \ + -d 'grant_type=authorization_code' \ + -d 'code=' \ + -d 'redirect_uri=' +``` + +#### Response + +```json +{ + "access_token": "SELLER_PAYER_TOKEN", + "public_key": "PUBLIC_KEY", + "refresh_token": "TG-XXXXXXXXX-XXXXX", + "live_mode": true, + "user_id": "COLLECTOR_ID DE PAGO", + "token_type": "bearer", + "expires_in": 15552000, + "scope": "offline_access payments write" +} +``` + +The response includes: +- `access_token` and `public_key` of the linked seller. +- `refresh_token`, which you should use to periodically renew the linkages. +- `user_id`, equal to the `collector_id` used to capture payments. + +> WARNING +> +> Important +> +> These credentials are valid for 6 months. If not renewed before that period, they will expire, and it will be necessary to repeat the linking process to authorize the seller again. To learn how to renew these credentials, consult the step-by-step in the [Renewal documentation.](/developers/en/docs/split-payments/additional-content/security/oauth/renewal) \ No newline at end of file diff --git a/guides/split-payment/configuration.es.md b/guides/split-payment/configuration.es.md new file mode 100644 index 0000000000..b1e8102d96 --- /dev/null +++ b/guides/split-payment/configuration.es.md @@ -0,0 +1,144 @@ +# Crear configuración + +Para configurar la integración con la solución de Split de Pagos, deberás [crear tu aplicación](#bookmark_crear_aplicación), [solicitar permisos a tus usuarios](#bookmark_solicitar_permiso_a_usuarios) y [obtener las credenciales](#bookmark_obtener_credenciales). Continúa leyendo para crear la configuración necesaria. + +## Crear aplicación + +Crea tu aplicación para integrar con la solución de Split de Pagos siguiendo los pasos a continuación. + + > NOTE + > + > Importante + > + > Durante la creación de tu aplicación, es posible que sea necesario reautenticar tu identidad. Si ya has completado la verificación, se solicitará la reautenticación. En caso contrario, serás redirigido para enviar los documentos necesarios. Este paso adicional es esencial para proteger tu cuenta y garantizar la conformidad de las operaciones. Puedes consultar la [documentación sobre el Panel del desarrollador](/developers/es/docs/split-payment/additional-content/your-integrations/dashboard) si tienes alguna pregunta sobre cómo utilizarlo. + +1. Accede a [Tus integraciones](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/panel/app). Una vez allí, haz clic en el botón **Crear aplicación**, ubicado en la esquina superior derecha. +2. Ingresa un nombre para identificar tu aplicación (tienes un límite de 50 caracteres). +3. Elige la solución de **Pagos online**. +4. A la hora de elegir el producto a integrar, puedes elegir “Checkout Pro” o ----[mla, mlm, mpe, mco, mlu, mlc]----“Checkout API” ------------ ----[mlb]----"Checkout Transparente" ------------. +5. Elige el modelo de integración **Marketplace**. +6. Una vez que hayas completado la información solicitada, haz clic en **Crear aplicación** y ¡listo! + +### Configurar Redirect URL + +En esta etapa, es necesario configurar la Redirect URL para que los vendedores autoricen al marketplace a realizar ventas. + +Después de crear la aplicación, es necesario dirigirse a la pantalla de edición para completar el campo de Redirect URL (en las solicitudes de OAuth se muestra como redirect_uri), el cual debe contener la URL del sitio del marketplace a donde se enviará el token del vendedor al completar el proceso de vinculación. + +![Redirect URL](/images/split-payment/redirect-url-es.png) + +## Solicitar permiso a usuarios + +Para gestionar ventas en nombre de otro usuario, debes solicitar permiso. Para esto, es necesario implementar el flujo de autorización utilizando OAuth, tal como indicamos en los pasos a continuación: + + 1. Redirige a tus usuarios a la siguiente URL para autorizar la gestión de ventas: + + | Valor | Descripción | +|--------------------------|--------------------------------------------------------------------------------------------------------------------------| +| `` | Valor obtenido durante la [creación de la aplicación](/developers/es/docs/split-payment/integration-configuration/create-application). | +| `` | Valor ingresado en el campo Redirect Uri durante la [configuración de la Redirect URL](/developers/es/docs/split-payment/integration-configuration/create-application). | + +----[mla]---- +```curl +https://auth.mercadopago.com.ar/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ +----[mlb]---- +```curl +https://auth.mercadopago.com.br/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ +----[mlm]---- +```curl +https://auth.mercadopago.com.mx/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ +----[mlc]---- +```curl +https://auth.mercadopago.cl/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ +----[mco]---- +```curl +https://auth.mercadopago.com.co/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ +----[mlu]---- +```curl +https://auth.mercadopago.com.uy/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ +----[mpe]---- +```curl +https://auth.mercadopago.com.pe/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ + + +2. Una vez que los usuarios autoricen la gestión de ventas, recibirás un código de autorización en la URL que especificaste en el paso anterior. Este código estará en el parámetro `code` de la siguiente manera: + +```curl +http://?code=AUTHORIZATION_CODE +``` + +> NOTE +> +> Nota +> +> El `AUTHORIZATION_CODE` tiene una validez de 10 minutos y será utilizado para crear las credenciales necesarias. + +## Obtener credenciales + +Utiliza el código de autorización obtenido en el paso anterior para adquirir las credenciales del usuario mediante la [API de OAuth](/developers/es/reference/oauth/_oauth_token/post), lo que te permitirá gestionar sus ventas. + +| Parámetro | Descripción | +|--------------------------|--------------------------------------------------------------------------------------------------| +| `` | Valor de APP_ID obtenido en los detalles de tu aplicación. | +| `` | Tu SECRET_KEY, también disponible en los detalles de tu aplicación. | +| `` | Código de autorización obtenido al redirigir al usuario de vuelta a tu sitio. | +| `` | Debe ser la misma Redirect URI configurada en tu aplicación. | + +```curl +curl -X POST \ + -H 'accept: application/json' \ + -H 'content-type: application/x-www-form-urlencoded' \ + 'https://api.mercadopago.com/oauth/token' \ + -d 'client_id=' \ + -d 'client_secret=' \ + -d 'grant_type=authorization_code' \ + -d 'code=' \ + -d 'redirect_uri=' +``` + +#### Respuesta + +```json +{ + "access_token": "SELLER_PAYER_TOKEN", + "public_key": "PUBLIC_KEY", + "refresh_token": "TG-XXXXXXXXX-XXXXX", + "live_mode": true, + "user_id": "COLLECTOR_ID DE PAGO", + "token_type": "bearer", + "expires_in": 15552000, + "scope": "offline_access payments write" +} +``` + +La respuesta incluye: +- `access_token` y `public_key` del vendedor vinculado. +- `refresh_token`, que debes utilizar para renovar periódicamente las vinculaciones. +- `user_id`, igual al `collector_id` que se utiliza para capturar pagos. + +> WARNING +> +> Importante +> +> Estas credenciales tienen una validez de 6 meses. En caso de no renovarlas antes de ese período, perderán vigencia y será necesario repetir el proceso de vinculación para autorizar nuevamente al vendedor. Para saber cómo renovar estas credenciales, consulta el paso a paso en la [documentación de Renovación.](/developers/es/docs/split-payments/additional-content/security/oauth/renewal) \ No newline at end of file diff --git a/guides/split-payment/configuration.pt.md b/guides/split-payment/configuration.pt.md new file mode 100644 index 0000000000..e9f25297f5 --- /dev/null +++ b/guides/split-payment/configuration.pt.md @@ -0,0 +1,144 @@ +# Criar configuração + +Para configurar a integração com a solução Split de Pagamentos, você deverá [criar sua aplicação](#bookmark_criar_aplicação), [solicitar permissões aos seus usuários](#bookmark_solicitar_permissão_aos_usuários) e [obter as credenciais](#bookmark_obter_credenciais). Continue lendo para criar a configuração necessária. + +## Criar aplicação + +Crie sua aplicação para integrar com a solução Split de Pagamentos seguindo os passos abaixo. + + > NOTE + > + > Importante + > + > Durante a criação da sua aplicação, talvez seja necessário reautenticar sua identidade. Se já concluiu a verificação, será solicitada a reautenticação. Caso contrário, será redirecionado para enviar os documentos necessários. Esse passo extra é essencial para proteger sua conta e garantir a conformidade das operações. Você pode consultar a [documentação sobre o Painel do desenvolvedor](/developers/pt/docs/split-payment/additional-content/your-integrations/dashboard) se tiver dúvidas sobre como usá-lo. + +1. Acesse [Suas integrações](https://www.mercadopago.com.br/developers/panel/app). Uma vez lá, clique no botão **Criar aplicação**, localizado no canto superior direito. +2. Insira um nome para identificar sua aplicação (você tem um limite de 50 caracteres). +3. Escolha a solução de **Pagamentos online**. +4. Ao escolher o produto a ser integrado, você pode optar por "Checkout Pro" ou "Checkout API". +5. Escolha o modelo de integração **Marketplace**. +6. Após preencher as informações solicitadas, clique em **Criar aplicação** e pronto! + +### Configurar Redirect URL + +Nesta etapa, é necessário configurar o Redirect URL para que os vendedores possam autorizar o marketplace a realizar vendas. + +Após criar a aplicação, é necessário ir para a tela de edição para preencher o campo de Redirect URL (nas solicitações de OAuth, é mostrado como redirect_uri), o qual deve conter a URL do site do marketplace para onde o token do vendedor será enviado ao concluir o processo de vinculação. + +![Redirect URL](/images/split-payment/redirect-url-pt-br.png) + +## Solicitar permissão aos usuários + +Para solicitar permissão aos seus usuários para gerenciar vendas em seu nome, é necessário implementar o fluxo de autorização usando o OAuth. Siga os passos abaixo: + +1. Redirecione seus usuários para a seguinte URL para autorizar o gerenciamento de vendas: + +| Valor | Descrição | +|--------------------------|----------------------------------------------------------------------------------------------------------------------| +| `` | Valor obtido durante a [criação da aplicação](/developers/pt/docs/split-payment/integration-configuration/create-application). | +| `` | Valor inserido no campo Redirect Uri durante a [configuração do Redirect URL](/developers/pt/docs/split-payment/integration-configuration/create-application). | + +----[mla]---- +```curl +https://auth.mercadopago.com.ar/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ +----[mlb]---- +```curl +https://auth.mercadopago.com.br/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ +----[mlm]---- +```curl +https://auth.mercadopago.com.mx/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ +----[mlc]---- +```curl +https://auth.mercadopago.cl/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ +----[mco]---- +```curl +https://auth.mercadopago.com.co/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ +----[mlu]---- +```curl +https://auth.mercadopago.com.uy/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ +----[mpe]---- +```curl +https://auth.mercadopago.com.pe/authorization?client_id=&response_type=code&platform_id=mp&redirect_uri= +``` + +------------ + + +2. Assim que os usuários autorizarem o gerenciamento de vendas, você receberá um código de autorização na URL que especificou no passo anterior. Este código estará no parâmetro `code` da seguinte forma: + +```curl +http://?code=AUTHORIZATION_CODE +``` + +> NOTE +> +> Nota +> +> O `AUTHORIZATION_CODE` tem uma validade de 10 minutos e será utilizado para criar as credenciais necessárias. + +## Obter credenciais + +Utilize o código de autorização obtido na etapa anterior para adquirir as credenciais do usuário por meio da [API de OAuth](/developers/pt/reference/oauth/_oauth_token/post), permitindo a gestão de suas vendas. + +| Parâmetro | Descrição | +|--------------------------|--------------------------------------------------------------------------------------------------| +| `` | Valor de APP_ID obtido nos detalhes de sua aplicação. | +| `` | Sua SECRET_KEY, também disponível nos detalhes de sua aplicação. | +| `` | Código de autorização obtido ao redirecionar o usuário de volta para o seu site. | +| `` | Deve ser a mesma Redirect URI configurada em sua aplicação. | + +```curl +curl -X POST \ + -H 'accept: application/json' \ + -H 'content-type: application/x-www-form-urlencoded' \ + 'https://api.mercadopago.com/oauth/token' \ + -d 'client_id=' \ + -d 'client_secret=' \ + -d 'grant_type=authorization_code' \ + -d 'code=' \ + -d 'redirect_uri=' +``` + +#### Resposta + +```json +{ + "access_token": "SELLER_PAYER_TOKEN", + "public_key": "PUBLIC_KEY", + "refresh_token": "TG-XXXXXXXXX-XXXXX", + "live_mode": true, + "user_id": "COLLECTOR_ID DE PAGO", + "token_type": "bearer", + "expires_in": 15552000, + "scope": "offline_access payments write" +} +``` + +A resposta inclui: +- `access_token` e `public_key` do vendedor vinculado. +- `refresh_token`, que deve ser utilizado para renovar periodicamente as vinculações. +- `user_id`, igual ao `collector_id` utilizado para capturar pagamentos. + +> WARNING +> +> Importante +> +> Essas credenciais têm uma validade de 6 meses. Caso não sejam renovadas antes desse período, perderão a validade, e será necessário repetir o processo de vinculação para autorizar novamente o vendedor. Para saber como renovar essas credenciais, consulte o passo a passo na [documentação de Renovação.](/developers/pt/docs/split-payments/additional-content/security/oauth/renewal) \ No newline at end of file diff --git a/guides/split-payment/integrate-marketplace.en.md b/guides/split-payment/integrate-marketplace.en.md new file mode 100644 index 0000000000..d7d8a64a31 --- /dev/null +++ b/guides/split-payment/integrate-marketplace.en.md @@ -0,0 +1,65 @@ +# Integrate checkout in Split Payments (marketplace) + +If you choose to sell through a marketplace, it is possible to integrate **two types of Mercado Pago checkout** to process payments. + +* [Checkout Pro](/developers/en/guides/checkout-pro/landing): In this checkout model, the buyer is directed to a Mercado Pago page to complete the payment. +* ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/en/guides/checkout-api/introduction)----------------[mlb]----[Checkout Transparente](/developers/en/guides/checkout-api/introduction)------------: This checkout model allows the buyer to make the payment within the marketplace environment. + +Both checkouts automatically split the amounts between the seller and the marketplace through the _split_ payment + +> NOTE +> +> Important +> +> The Mercado Pago commission is deducted from the amount received by the seller. In other words, the Mercado Pago commission is deducted first and the Marketplace commission is deducted from the remaining amount. + +To perform the integration, you will need to follow the usual integration flow of the chosen checkout, necessarily using an access token for each seller, obtained through OAuth. Below we list the steps required to integrate a checkout with the marketplace. + +1. Follow the steps described in the [OAuth documentation](/developers/en/guides/additional-content/security/oauth/introduction) to get each `access_token`. This information will be needed during the checkout integration process into the marketplace. +2. Choose the type of checkout you want ([Checkout Pro](/developers/en/guides/checkout-pro/landing) or ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/en/guides/checkout-api/introduction)----------------[mlb]----[Checkout Transparente](/developers/en/guides/checkout-api/introduction)------------) and follow the entire onboarding flow. +3. In the checkout integration, use the `public_key` of your integrator account in the frontend and insert the seller's `access_token` (obtained in step 1) in the backend or in the request header. +4. To determine the marketplace commission percentage: + + - If it's Checkout Pro, fill the `marketplace_fee` parameter with the amount to be charged for each payment preference created in the **/checkout/preferences** API. + +
+ +#### Example + +```json + { + "items": [ + { + "id": "item-ID-1234", + "title": "Meu produto", + "currency_id": "BRL", + "quantity": 1, + "unit_price": 75.76 + } + ], + "marketplace_fee": 10 + } +``` + + - If it's Checkout ----[mla, mlu, mpe, mco, mlc, mlm]----API------------ ----[mlb]----Transparente------------, fill the `application_fee` parameter with the amount to be charged for each payment created in the **/payments** API. + +
+ +#### Example + +```json + { + "description": "API TRANSPARENTE MARKETPLACE", + "installments": 1, + "token": "{{card_token}}", + "payer": { + "id": "{{payer_id}}" + }, + "marketplace": "{{marketplace_id}}", + "payment_method_id": "master", + "application_fee": 2, + "transaction_amount": 10 + } +``` + +Upon completing these steps, the checkout will have been integrated into the marketplace and will be ready to process payments. \ No newline at end of file diff --git a/guides/split-payment/integrate-marketplace.es.md b/guides/split-payment/integrate-marketplace.es.md new file mode 100644 index 0000000000..29a0aa6342 --- /dev/null +++ b/guides/split-payment/integrate-marketplace.es.md @@ -0,0 +1,65 @@ +# Integrar el checkout en Split de Pagos (marketplace) + +Si eliges vender a través de un _marketplace_, es posible integrar **dos tipos de checkout de Mercado Pago** para procesar los pagos realizados. + +* [Checkout Pro](/developers/es/guides/checkout-pro/landing): en este modelo de checkout, el comprador es dirigido a una página de Mercado Pago para completar el pago. +* ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/es/guides/checkout-api/introduction)----------------[mlb]----[Checkout Transparente](/developers/es/guides/checkout-api/introduction)------------: este modelo de pago permite al comprador realizar el pago dentro del entorno del _marketplace_. + +Ambos checkouts reparten automáticamente los importes entre el vendedor y el _marketplace_ a través del _split del pago_ sin necesidad de ninguna acción por parte del vendedor. + +> NOTE +> +> Importante +> +> La comisión de Mercado Pago se descuenta de los fondos recibidos por el vendedor. Es decir, primero se descuenta la comisión de Mercado Pago, y la comisión del marketplace se descuenta del saldo restante. + +Para realizar la integración deberás seguir el flujo de integración habitual del _checkout_ elegido, utilizando necesariamente el token de acceso para cada vendedor que fue obtenido a través de OAuth. A continuación, enumeramos los pasos necesarios para integrar una caja con el _marketplace_. + +1. Sigue los pasos descritos en la [documentación de OAuth](/developers/es/guides/additional-content/security/oauth/introduction) para obtener cada `access_token`. Esta información será necesaria durante el proceso de integración de pago en el _marketplace_. +2. Elige el checkout que deseas ([Checkout Pro](/developers/es/guides/checkout-pro/landing) o ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/es/guides/checkout-api/introduction)------------ ----[mlb]----[Checkout Transparente](/developers/es/guides/checkout-api/introduction)------------) y sigue todo el flujo de integración. +3. En la integración del _checkout_, usa la `public_key` de tu cuenta de integrador en el _frontend_ e inserta el `access_token` del vendedor (obtenido en el paso 1) en el _backend_ o en el _header_ de la solicitud. +4. Para determinar el porcentaje de comisión del marketplace: + + - Si es Checkout Pro, completa el parámetro `marketplace_fee` con el monto que se cobrará por cada preferencia de pago creada en la API **/checkout/preferences**. + +
+ +#### Ejemplo + +```json + { + "items": [ + { + "id": "item-ID-1234", + "title": "Meu produto", + "currency_id": "BRL", + "quantity": 1, + "unit_price": 75.76 + } + ], + "marketplace_fee": 10 + } +``` + + - Si es Checkout ----[mla, mlu, mpe, mco, mlc, mlm]----API------------ ----[mlb]----Transparente------------, completa el parámetro `application_fee` con el monto que se cobrará por cada pago creado en la API **/payments**. + +
+ +#### Ejemplo + +```json + { + "description": "API TRANSPARENTE MARKETPLACE", + "installments": 1, + "token": "{{card_token}}", + "payer": { + "id": "{{payer_id}}" + }, + "marketplace": "{{marketplace_id}}", + "payment_method_id": "master", + "application_fee": 2, + "transaction_amount": 10 + } +``` + +Al completar estos pasos, el checkout se habrá integrado en el _marketplace_ y estará listo para procesar pagos. \ No newline at end of file diff --git a/guides/split-payment/integrate-marketplace.pt.md b/guides/split-payment/integrate-marketplace.pt.md new file mode 100644 index 0000000000..c50e9e7ae7 --- /dev/null +++ b/guides/split-payment/integrate-marketplace.pt.md @@ -0,0 +1,65 @@ +# Integrar o checkout em Split de Pagamentos (marketplace) + +Caso escolha vender através de um _marketplace_, é possível integrar **dois tipos de checkout do Mercado Pago** para processar os pagamentos realizados. + +* [Checkout Pro](/developers/pt/guides/checkout-pro/landing): Neste modelo de checkout, o comprador é direcionado para uma página do Mercado Pago para concluir o pagamento. +* ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/pt/guides/checkout-api/introduction)----------------[mlb]----[Checkout Transparente](/developers/pt/guides/checkout-api/introduction)------------: Este modelo de checkout permite ao comprador realizar o pagamento dentro do ambiente do _marketplace_. + +Ambos os checkouts realizam automaticamente a divisão dos valores entre o vendedor e o _marketplace_ por meio do _split_ de pagamento, sem a necessidade de qualquer ação por parte do vendedor. + +> NOTE +> +> Importante +> +> A comissão do Mercado Pago é descontada do valor recebido pelo vendedor. Ou seja, primeiro, a comissão do Mercado Pago é descontada e, em seguida, a comissão do Marketplace é descontada sobre o valor restante. + +Para realizar a integração você precisará seguir o fluxo de integração usual do checkout escolhido utilizando um _access token_ para cada vendedor, obtido através de OAuth. Abaixo, listamos as etapas necessárias para integrar um checkout ao _marketplace_. + +1. Siga as etapas descritas na [documentação OAuth](/developers/pt/guides/additional-content/security/oauth/introduction) para obter cada `access_token`. Esta informação será necessária durante o processo de integração do checkout ao _marketplace_. +2. Escolha o tipo de checkout ([Checkout Pro](/developers/pt/guides/checkout-pro/landing) ou ----[mla, mlu, mpe, mco, mlc, mlm]----[Checkout API](/developers/pt/guides/checkout-api/introduction------------ ----[mlb]----[Checkout Transparente](/developers/pt/guides/checkout-api/introduction)------------)) e siga o fluxo de integração. +3. Na integração do checkout, utilize a `public_key` da sua conta de integrador no _frontend_ e insira o `access_token` do vendedor (obtido na etapa 1) no _backend_ ou no _header_ da requisição. +4. Para determinar a porcentagem de comissão do marketplace: + + - Se o checkout for Pro, preencha o parâmetro `marketplace_fee` com o valor a ser cobrado para cada preferência de pagamento criada na API **/checkout/preferences**. + +
+ +#### Exemplo + +```json + { + "items": [ + { + "id": "item-ID-1234", + "title": "Meu produto", + "currency_id": "BRL", + "quantity": 1, + "unit_price": 75.76 + } + ], + "marketplace_fee": 10 + } +``` + + - Se o checkout for ----[mla, mlu, mpe, mco, mlc, mlm]----API------------ ----[mlb]----Transparente------------, preencha o parâmetro `application_fee` com o valor a ser cobrado para cada pagamento criado na API **/payments**. + +
+ +#### Exemplo + +```json + { + "description": "API TRANSPARENTE MARKETPLACE", + "installments": 1, + "token": "{{card_token}}", + "payer": { + "id": "{{payer_id}}" + }, + "marketplace": "{{marketplace_id}}", + "payment_method_id": "master", + "application_fee": 2, + "transaction_amount": 10 + } +``` + +Ao finalizar essas etapas, a integração do checkout com o _marketplace_ estará concluída e pronta para processar os pagamentos. \ No newline at end of file diff --git a/guides/split-payment/integration-configuration.en.md b/guides/split-payment/integration-configuration.en.md new file mode 100644 index 0000000000..24d338bb52 --- /dev/null +++ b/guides/split-payment/integration-configuration.en.md @@ -0,0 +1,6 @@ +# Integration configuration + +To set up the integration with the Split Payments solution, follow the steps below: + + 1. [Create configuration](/developers/en/docs/split-payment/integration-configuration/create-configuration) + 2. [Integrate the checkout in Split Payments (marketplace)](/developers/en/docs/split-payment/integration-configuration/integrate-marketplace) \ No newline at end of file diff --git a/guides/split-payment/integration-configuration.es.md b/guides/split-payment/integration-configuration.es.md new file mode 100644 index 0000000000..84e0b16e4a --- /dev/null +++ b/guides/split-payment/integration-configuration.es.md @@ -0,0 +1,6 @@ +# Configuración de la integración + +Para configurar la integración con la solución Split de Pagos, sigue los pasos a continuación: + + 1. [Crear configuración](/developers/es/docs/split-payment/integration-configuration/create-configuration) + 4. [Integrar el checkout en Split de Pagos (marketplace)](/developers/es/docs/split-payment/integration-configuration/integrate-marketplace) \ No newline at end of file diff --git a/guides/split-payment/integration-configuration.pt.md b/guides/split-payment/integration-configuration.pt.md new file mode 100644 index 0000000000..5aa8fceb65 --- /dev/null +++ b/guides/split-payment/integration-configuration.pt.md @@ -0,0 +1,6 @@ +# Configuração da integração + +Para configurar a integração com a solução Split de Pagamentos, siga as etapas abaixo: + + 1. [Criar configuração](/developers/pt/docs/split-payment/integration-configuration/create-configuration) + 2. [Integrar o checkout em Split de Pagamentos (marketplace)](/developers/pt/docs/split-payment/integration-configuration/integrate-marketplace) \ No newline at end of file diff --git a/guides/split-payment/landing.en.md b/guides/split-payment/landing.en.md new file mode 100644 index 0000000000..8a00b17fcc --- /dev/null +++ b/guides/split-payment/landing.en.md @@ -0,0 +1,30 @@ +--- +content_section_with_media: + - title: Split Payments + - message: The Split Payments solution is designed to provide Payment Service Provider (PSP) services to sellers in marketplace models. Marketplaces are e-commerce platforms that connect sellers and buyers, offering a unified environment for online sales, expanding reach, and conversion. + - media_image: /split-payment/split-de-pago-01.png + +--- + +--- mini_landing_separator --- + +>>>> Availability by Country <<<< +--- +available_countries: mla, mlb, mlm, mlc, mpe + +--- + +--- +bullet_section_with_media: + - title: Advantages + - type: normal + - benefit_title: Simplify payment splitting + - benefit_message: We simplify your B2B and B2C management by splitting payments between your company and each participant in a transaction. Stop worrying about fees, taxes, and commission splitting – we do it for you. + - benefit_title: Monitor and track your sales + - benefit_message: With Split Payments, you have a 360-degree view of all your sellers' sales. Track in detail the payments and fees in detail for each vendor with real-time unified reports. + - benefit_title: Increase operational efficiency + - benefit_message: Reduce your operating costs through automation and efficient management of your payments and commissions. Split Payments divides the transaction money among the parties involved. + - benefit_title: Leverage the Mercado Pago ecosystem + - benefit_message: Count on the support of the financial products and sales platform of Mercado Libre and Mercado Pago, used by millions of users in Latin America. + - image: /split-payment/payment-split-03.png +--- diff --git a/guides/split-payment/landing.es.md b/guides/split-payment/landing.es.md new file mode 100644 index 0000000000..251e5e234f --- /dev/null +++ b/guides/split-payment/landing.es.md @@ -0,0 +1,29 @@ +--- +content_section_with_media: + - title: Split de Pagos + - message: La solución de Split de Pagos está diseñada para proporcionar servicios de Proveedor de Servicios de Pago (PSP) a vendedores en modelos de marketplace. Los marketplaces son plataformas de comercio electrónico que conectan vendedores y compradores, ofreciendo un entorno unificado para ventas en línea, ampliando el alcance y la conversión. + - media_image: /split-payment/split-de-pago-01.png +--- + +--- mini_landing_separator --- + +>>>> Disponibilidad por país <<<< +--- +available_countries: mla, mlb, mlm, mlc, mpe + +--- + +--- +bullet_section_with_media: + - title: Ventajas + - type: normal + - benefit_title: Simplifica la división de pagos + - benefit_message: Facilita tu gestión B2B y B2C, dividiendo el pago entre tu empresa y cada actor de una transacción. Deja de preocuparte por tasas, impuestos y división de comisiones, nosotros lo hacemos por ti. + - benefit_title: Controla y haz seguimiento a tus ventas + - benefit_message: Con Split de Pagos tienes visibilidad 360 de todas las ventas de tus sellers. Realiza un seguimiento detallado a los pagos y tasas por cada vendedor con reportes unificados en tiempo real. + - benefit_title: Aumenta tu eficiencia operacional + - benefit_message: Disminuye tus costos operativos por medio de la automatización y gestión eficiente de tus pagos y comisiones. Split de Pagos hace la división del dinero de la transacción entre las partes. + - benefit_title: Aprovecha el ecosistema Mercado Pago + - benefit_message: Cuenta con el respaldo de la plataforma de productos financieros y de venta de Mercado Libre y Mercado Pago, usada por millones de usuarios en América Latina. + - image: /split-payment/split-de-pago-03.png +--- \ No newline at end of file diff --git a/guides/split-payment/landing.pt.md b/guides/split-payment/landing.pt.md new file mode 100644 index 0000000000..7b598f45aa --- /dev/null +++ b/guides/split-payment/landing.pt.md @@ -0,0 +1,30 @@ +--- +content_section_with_media: + - title: Split de Pagamentos + - message: A solução de Split de Pagamentos foi projetada para fornecer serviços de Provedor de Serviços de Pagamento (PSP) a vendedores em modelos de marketplace. Os marketplaces são plataformas de comércio eletrônico que conectam vendedores e compradores, oferecendo um ambiente unificado para vendas online, ampliando o alcance e a conversão. + - media_image: /split-payment/split-de-pago-01.png + +--- + +--- mini_landing_separator --- + +>>>> Disponibilidade por país <<<< +--- +available_countries: mla, mlb, mlm, mlc, mpe + +--- + +--- +bullet_section_with_media: + - title: Vantagens + - type: normal + - benefit_title: Simplifique a divisão de pagamentos + - benefit_message: Facilite sua gestão B2B e B2C, dividindo o pagamento entre sua empresa e cada participante de uma transação. Pare de se preocupar com taxas, impostos e divisão de comissões, nós cuidamos disso para você. + - benefit_title: Controle e acompanhe suas vendas + - benefit_message: Com o Split de Pagamentos, você tem uma visão completa de todas as vendas dos seus vendedores. Acompanhe detalhadamente os pagamentos e taxas de cada vendedor com relatórios unificados em tempo real. + - benefit_title: Aumente sua eficiência operacional + - benefit_message: Reduza seus custos operacionais por meio da automação e gestão eficiente dos seus pagamentos e comissões. O Split de Pagamentos realiza a divisão do dinheiro da transação entre as partes. + - benefit_title: Aproveite o ecossistema Mercado Pago + - benefit_message: Conte com o suporte da plataforma de produtos financeiros e de vendas do Mercado Livre e Mercado Pago, usada por milhões de usuários na América Latina. + - image: /split-payment/split-de-pago-03.png +--- diff --git a/guides/split-payment/prerequisites.en.md b/guides/split-payment/prerequisites.en.md new file mode 100644 index 0000000000..94e51dd6ee --- /dev/null +++ b/guides/split-payment/prerequisites.en.md @@ -0,0 +1,18 @@ +# Prerequisites + +To integrate the Split Payments solution, it is important to meet the requirements shown below. + +> NOTE +> +> Important +> +> If it is necessary to make configurations regarding the commission release date (marketplace fee or application fee), contact your **assisted portfolio commercial executive**. + +| Requirement | Description | +|----------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Mercado Pago Seller Account | To integrate, you need a seller account on Mercado Pago with a KYC 6 level. This ensures a solid foundation of trust and security in transactions. If you don't have one, you can [create it](https://www.mercadopago[FAKER][URL][DOMAIN]/hub/registration/landing) for free. | +| Mercado Pago Application | It is necessary to have the Mercado Pago application to manage the received payments. You can download [its version for Android devices](https://play.google.com/store/apps/details?id=com.mercadopago.wallet&hl=es_419), or [for iOS devices](https://apps.apple.com/ar/app/mercado-pago/id925436649). | +| OAuth | Resellers in the Marketplace must go through the OAuth authorization process to establish a secure and authenticated connection. This procedure ensures the legitimacy of commercial transactions and protects the integrity of operations. Refer to the OAuth documentation for more information. | +| Integration with Mercado Pago | The Marketplace must integrate with Mercado Pago using Checkouts (1:1 model) or through the advanced_payments API (1:n model). | +| Credentials | Exclusive passwords used to identify an integration in your account and allow secure navigation and user data protection. Refer to the [Credentials documentation](/developers/en/docs/split-payment/additional-content/your-integrations/credentials) for more information. | +| Test Accounts | Test accounts allow you to perform tests in the application to ensure that everything is working correctly. You can create them in [Your Integrations](https://www.mercadopago[FAKER][URL][DOMAIN]developers/panel/app). | \ No newline at end of file diff --git a/guides/split-payment/prerequisites.es.md b/guides/split-payment/prerequisites.es.md new file mode 100644 index 0000000000..2d97dcb41b --- /dev/null +++ b/guides/split-payment/prerequisites.es.md @@ -0,0 +1,18 @@ +# Requisitos previos + +Para integrar la solución de Split de Pagos, es importante cumplir con los requisitos que se muestran a continuación. + +> NOTE +> +> Importante +> +> En caso de que sea necesario realizar configuraciones sobre la fecha de liberación de la comisión (*marketplace fee* o *application fee*), contacta a tu **ejecutivo comercial de cartera asesorada**. + +| Requisito | Descripción | +|----------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Cuenta de vendedor Mercado Pago | Para integrar, necesitas una cuenta de vendedor en Mercado Pago con un nivel de identificación KYC 6. Esto asegura una base sólida de confianza y seguridad en las transacciones. Si no tienes una, puedes [crearla](https://www.mercadopago[FAKER][URL][DOMAIN]hub/registration/landing) de manera gratuita. | +| Aplicación Mercado Pago | Es necesario contar con la aplicación Mercado Pago para gestionar los cobros realizados. Puedes descargar [su versión para dispositivos Android](https://play.google.com/store/apps/details?id=com.mercadopago.wallet&hl=es_419), o bien para [dispositivos iOS](https://apps.apple.com/ar/app/mercado-pago/id925436649). | +| OAuth | Los revendedores en el Marketplace deben pasar por el proceso de autorización OAuth para establecer una conexión segura y autenticada. Este procedimiento garantiza la legitimidad de las transacciones comerciales y protege la integridad de las operaciones. Consulta la documentación de OAuth para obtener más información. | +| Integración con Mercado Pago | El Marketplace debe integrarse a Mercado Pago utilizando los Checkouts (modelo 1:1) o a través de la API de `advanced_payments` (modelo 1:n). | +| Credenciales | Contraseñas exclusivas utilizadas para identificar una integración en tu cuenta y que permiten la navegación segura y la protección de datos de los usuarios. Consulta la [documentación de Credenciales](/developers/es/docs/split-payment/additional-content/your-integrations/credentials) para obtener más información. | +| Cuentas de prueba | Las cuentas de prueba te permiten realizar testeos en la aplicación para corroborar que todo está funcionando correctamente. Las puedes crear en [Tus Integraciones](https://www.mercadopago[FAKER][URL][DOMAIN]/developers/panel/app). | diff --git a/guides/split-payment/prerequisites.pt.md b/guides/split-payment/prerequisites.pt.md new file mode 100644 index 0000000000..e70baee160 --- /dev/null +++ b/guides/split-payment/prerequisites.pt.md @@ -0,0 +1,18 @@ +# Pré-requisitos + +Para integrar a solução Split de Pagamentos, é importante atender aos requisitos mostrados abaixo. + +> NOTE +> +> Importante +> +> Caso seja necessário realizar configurações sobre a data de liberação da comissão (marketplace fee ou application fee), entre em contato com o seu **executivo comercial de carteira assessorada**. + +| Requisito | Descrição | +|----------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Conta de vendedor Mercado Pago | Para integrar, você precisa ter uma conta de vendedor no Mercado Pago com um nível de identificação KYC 6. Isso assegura uma base sólida de confiança e segurança nas transações. Se você não tiver uma, pode [criá-la](https://www.mercadopago.com.br/hub/registration/landing) gratuitamente. | +| Aplicativo Mercado Pago | É necessário ter o aplicativo Mercado Pago para gerenciar os recebimentos realizados. Você pode baixar [a versão para dispositivos Android](https://play.google.com/store/apps/details?id=com.mercadopago.wallet&hl=es_419) ou [para dispositivos iOS](https://apps.apple.com/br/app/mercado-pago/id925436649). | +| OAuth | Os revendedores no Marketplace devem passar pelo processo de autorização OAuth para estabelecer uma conexão segura e autenticada. Este procedimento garante a legitimidade das transações comerciais e protege a integridade das operações. Consulte a documentação de OAuth para obter mais informações. | +| Integração com o Mercado Pago | O Marketplace deve se integrar ao Mercado Pago usando os Checkouts (modelo 1:1) ou por meio da API de advanced_payments (modelo 1:n). | +| Credenciais | Senhas exclusivas usadas para identificar uma integração em sua conta e permitir a navegação segura e a proteção de dados dos usuários. Consulte a [documentação de Credenciais](https://www.mercadopago.com.br/developers/pt/docs/split-payment/additional-content/your-integrations/credentials) para obter mais informações. | +| Contas de teste | Contas de teste permitem realizar testes na aplicação para garantir que tudo está funcionando corretamente. Você pode criá-las em [Suas Integrações](https://www.mercadopago.com.br/developers/panel/app). | \ No newline at end of file diff --git a/images/split-payment/redirect-url-es.png b/images/split-payment/redirect-url-es.png new file mode 100644 index 0000000000..5e6e084cc3 Binary files /dev/null and b/images/split-payment/redirect-url-es.png differ diff --git a/images/split-payment/redirect-url-pt-br.png b/images/split-payment/redirect-url-pt-br.png new file mode 100644 index 0000000000..ebe78f89cf Binary files /dev/null and b/images/split-payment/redirect-url-pt-br.png differ diff --git a/images/split-payment/split-de-pago-01.png b/images/split-payment/split-de-pago-01.png new file mode 100644 index 0000000000..f75ba37b5e Binary files /dev/null and b/images/split-payment/split-de-pago-01.png differ diff --git a/images/split-payment/split-de-pago-02.png b/images/split-payment/split-de-pago-02.png new file mode 100644 index 0000000000..32c5108757 Binary files /dev/null and b/images/split-payment/split-de-pago-02.png differ diff --git a/images/split-payment/split-de-pago-03.png b/images/split-payment/split-de-pago-03.png new file mode 100644 index 0000000000..8f47553619 Binary files /dev/null and b/images/split-payment/split-de-pago-03.png differ