Merge pull request #2318 from mercadopago/fix/basics-cho-api

fix/basics-cho-api

guides/additional-content/sales-processing/cancellations-and-refunds.en.md

@@ -12,7 +12,7 @@ In this documentation, you will find the necessary information to perform a full
 >
 > Important
 >
-> When running the APIs referenced in this documentation, you may encounter the attribute **X-Idempotency-Key**. Its completion is important to ensure the execution and re-execution of requests without side effects such as duplicate payments in refund cases.
+> When running the APIs referenced in this documentation, you may encounter the attribute **X-Idempotency-Key**. Sending it is mandatory to ensure the execution and re-execution of requests without side effects such as duplicate payments in refund cases. Update our [SDKs Library](/developers/en/docs/sdks-library/landing), or generate a UUID V4 and send it in the _header_ of your requests to avoid possible errors.
 
 ## Cancellations
 

guides/additional-content/sales-processing/cancellations-and-refunds.es.md

@@ -12,7 +12,7 @@ En esta documentación, encontrarás las instrucciones y los links de las APIs n
 >
 > Importante
 >
-> Al ejecutar las API a las que se hace referencia en esta documentación, es posible que encuentres el atributo **X-Idempotency-Key**. Completarlo es importante para asegurar la ejecución y re-ejecución de solicitudes sin efectos secundarios como pagos duplicados en casos de reembolso.
+> Al ejecutar las API a las que se hace referencia en esta documentación, es posible que encuentres el atributo **X-Idempotency-Key**. Su envío es obligatorio para asegurar la ejecución y reejecución de las solicitudes sin el riesgo de realizar la misma acción más de una vez por error. Actualiza [nuestra biblioteca de SDKs](/developers/es/docs/sdks-library/landing), o genera un UUID V4 y envíalo en los _header_ de tus llamados para evitar errores.
 
 ## Cancelaciones
 

guides/additional-content/sales-processing/cancellations-and-refunds.pt.md

@@ -12,7 +12,7 @@ Nesta documentação, você encontra as instruções e os links das APIs necess
 >
 > Importante
 >
-> Ao executar as APIs citadas nesta documentação, você deverá enviar o atributo **X-Idempotency-Key**. Seu preenchimento é importante para garantir a execução e re-execução de requisições sem que haja efeitos colaterais como por exemplo, pagamentos em duplicidade em casos de reembolso.
+> Ao executar as APIs citadas nesta documentação, você deverá enviar o atributo **X-Idempotency-Key**. Seu preenchimento é obrigatório para garantir a execução e re-execução de requisições sem que haja efeitos colaterais como por exemplo, pagamentos em duplicidade em casos de reembolso. Atualize [nossa biblioteca de SDK](/developers/pt/docs/sdks-library/landing) ou gere um UUID V4 e envie-o no _header_ de suas chamadas para evitar erros.
 
 ## Cancelamentos
 

guides/additional-content/sales-processing/go-live-requirements.en.md

@@ -1,31 +1,53 @@
 # Requirements to go to production
 
-When you have your integration ready and want to start receiving payments, you must [activate your credentials](/developers/en/guides/additional-content/your-integrations/credentials) for production and replace the test credentials if needed. 
+When completing the integration process, your environement will be ready to be set into production. In this documentation, you will find the necessary requirements you need to meet to do this in a secure and effective way, guaranteeing that your integration is ready to receive real payments.
 
-You must also test your [integration’s quality](/developers/en/guides/additional-content/homologator/homologator) to verify if you are meeting the Mercado Pago quality and security standards.
 
-## Do not forget to have an SSL certificate
+## Activate production credentials
 
-In order for you to be secure and to take care of the data, **it is necessary that you have an SSL certificate and that the payment form be made available on an HTTPS page**. This allows to protect the transactions carried out by buyers and their data.
-During the tests you may not have it, but it is mandatory in order to go to production.
+To start receiving payments, you must **activate your production credentials** and replace the test credentials. 
 
-### Why is this process necessary? 
+To do so, enter the [Dashboard](https://www.mercadopago[FAKER][URL][DOMAIN]/settings/account/credentials) and, in the side menu, access **Production > Production credentials**. There, you will find your productive _Public Key_ and _Access Token_, which should replace the test ones used in previous stages.
 
-With this process, you can guarantee the security of your customers' data, compliance with the regulations or legal provisions of each country and achieve the best shopping experience for your customers.
+![Production Credentials](/images/woocomerce/test-prod-credentials-es.png)
 
-[View the Terms and Conditions of Mercado Pago](/developers/en/guides/resources/legal/terms-and-conditions).
+For more information, check our [Credenctials documentation](/developers/en/guides/additional-content/your-integrations/credentials).
+
+## SSL Certificate
+
+To ensure the security of your integration and protect the data involved in transactions, **it is necessary that you have an SSL certificate and that the payment form be made available on an HTTPS page**. 
+
+This process aims to guarantee the security of your customer's data, comply with legal requirements in each country, and provide the best purchasing experience for your sales.
+
+Although an SSL certificate may not be required during the testing phase, it is mandatory when going live. For more information, [check the Terms and Conditions of Mercado Pago](/developers/en/guides/resources/legal/terms-and-conditions).
 
 ----[mlb]----
-# Receive payments with Pix
+# Pix key
 
-The Pix payment option will only be displayed if there is a Pix key registered] in Mercado Pago. If you haven't created it yet, [click here](https://www.youtube.com/watch?v=60tApKYVnkA) and check the necessary steps.
+The Pix payment option will only be displayed if there is a Pix key registered in Mercado Pago. If you haven't created it yet, [click here](https://www.youtube.com/watch?v=60tApKYVnkA) and check the necessary steps.
 
 ------------
 
 ## Additional considerations
 
-We share some points of attention to increase the quality of your integrations:
+### Homologation
+
+Before going to production, and to provide the best experience for both sellers and buyers,you must test your [integration’s quality](/developers/en/guides/additional-content/homologator/homologator) with our homologation tool. 
+
+This is a certification process that will allow you to verify if you are complying with **Mercado Pago's quality and security standards** before you start receiving real payments. You only need to provide the `payment ID` of a payment made with productive credentials, and the tool will take care of carrying out the measurement, considering fundamental aspects for your integration, such as improving payment approval, financial reconciliation or security, among others.
+
+If adjustments are required, necessary actions and good practices will be suggested to improve these evaluated aspects and, by doing so, guarantee that your integration meets the necessary standards.
+
+### Payment approval
+
+Get to know what measures you can take to improve your [payment approval](/developers/en/guides/additional-content/how-tos/payment-rejections), such as submitting the item and payer information, shipping data, and industry information, among others.
+
+### Notifications
+
+Keep the status of orders updated in your systems by using and processing notifications correctly [IPN](/developers/en/guides/additional-content/your-integrations/ipn) or [Webhooks](/developers/en/guides/additional-content/your-integrations/webhooks).
+
+### Reports
+
+[Mercado Pago reports](/developers/en/guides/additional-content/reports/introduction) provide financial information to track account transactions, such as available balance, movements, and liquidity. This facilitates the reconciliation of sales and other operations with your internal management systems.
 
-+ Improve the [payment approval](/developers/en/guides/additional-content/how-tos/payment-rejections) by submitting the item and payer information, shipping data, and industry information.
-+ Keep the status of orders updated in your systems by using and processing notifications correctly [IPN](/developers/en/guides/additional-content/your-integrations/ipn) or [Webhooks](/developers/en/guides/additional-content/your-integrations/webhooks).
-+ Use reconciliation reports via API to improve the financial management of the business.
+We recommend using the reports to improve your company's financial management once you go live.

guides/additional-content/sales-processing/go-live-requirements.es.md

@@ -1,31 +1,53 @@
 # Requisitos para salir a producción
 
-Cuando tengas lista tu integración y quieras comenzar a recibir pagos, [activa las credenciales](/developers/es/guides/additional-content/your-integrations/credentials) de producción y reemplaza las de prueba si hace falta. 
+Una vez finalizado el proceso de integración, el ambiente estará listo para ser colocado en producción. En esta documentación, detallaremos los requisitos necesarios para realizar este pasaje de manera eficaz y segura, garantizando que tu integración esté preparada para recibir pagos reales.
 
-Además, deberás evaluar la [calidad de tu integración](/developers/es/guides/additional-content/homologator/homologator) para verificar si estás cumpliendo con los estándares de calidad y seguridad de Mercado Pago.
+## Activar credenciales de producción
 
-## No te olvides de contar con un certificado SSL 
+Para comenzar a recibir pagos, deberás **activar las credenciales de producción** y reemplazar las de prueba. 
 
-Para que seas seguro y que puedas cuidar los datos, **es necesario que tengas un certificado SSL y que el formulario de pagos sea disponibilizado en una página HTTPS**. Esto permite proteger las transacciones que realicen los compradores y sus datos.
-Durante las pruebas puedes no tenerlo, pero es obligatorio para salir a producción.
+Para hacerlo, ingresa al [Panel del Desarrollador](https://www.mercadopago[FAKER][URL][DOMAIN]/settings/account/credentials) y, en el menú lateral, accede a **Producción > Credenciales de producción**. Allí encontrarás tu _Public Key_ y _Access Token_ productivos, que deberán reemplazar a los de prueba utilizados en etapas previas.
+
+![Credenciales de producción](/images/woocomerce/test-prod-credentials-es.png)
 
-### ¿Por qué es necesario este proceso?
+Para más información, consulta nuestra documemntación de [Credenciales](/developers/es/guides/additional-content/your-integrations/credentials).
 
-Con este proceso, se puede garantizar la seguridad de lo datos de tus clientes, el cumplimiento de las normas o disposiciones legales de cada país y lograr la mejor experiencia de compra para tus ventas.
+## Certificado SSL 
+
+Para que tu integración sea segura y cuide los datos involucrados en las transacciones, **es necesario que tengas un certificado SSL y que el formulario de pagos sea disponibilizado en una página HTTPS**. Esto permite proteger las transacciones que realicen los compradores y sus datos.
+Durante las pruebas puedes no tenerlo, pero es obligatorio para salir a producción.
 
-[Conoce los términos y condiciones de Mercado Pago](/developers/es/guides/resources/legal/terms-and-conditions).
+Con este proceso, se busca garantizar la seguridad de lo datos de tus clientes, el cumplimiento de las normas o disposiciones legales de cada país y lograr la mejor experiencia de compra para tus ventas. 
+
+Si bien durante la etapa de pruebas puedes no contar con el certificado, este es obligatorio para salir a producción. Para más información, conoce [los términos y condiciones de Mercado Pago](/developers/es/guides/resources/legal/terms-and-conditions).
 
 ----[mlb]----
-## Recibir pagos con Pix
+## Clave Pix
 
-La opción de pago por Pix solo se mostrará si existe una Clave de Pix registrada en Mercado Pago. Si aún no las creaste, [haz clic aquí](https://www.youtube.com/watch?v=60tApKYVnkA) y consulta el paso a paso.
+La opción de pago por Pix solo se mostrará si existe una Clave Pix registrada en Mercado Pago. Si aún no las creaste, [haz clic aquí](https://www.youtube.com/watch?v=60tApKYVnkA) y consulta el paso a paso.
 
 ------------
 
 ## Consideraciones adicionales
 
-Te compartimos algunos puntos a tener en cuenta para elevar la calidad de tus integraciones:
+### Homologación
+
+Antes de salir a producción, y para poder ofrecer tanto al vendedor como al comprador la mejor experiencia, deberás evaluar la [calidad de tu integración](/developers/es/guides/additional-content/homologator/homologator) con nuestra herramienta de homologación. 
+
+Se trata de un proceso de certificación que te permitirá verificar si estás cumpliendo con los **estándares de calidad y seguridad de Mercado Pago** antes de comenzar a recibir pagos reales. Al ingresar el `payment ID` de un pago realizado con credenciales productivas, nuestra herramienta se encarga de realizar la medición considerando aspectos fundamentales para la eficacia de tu integración, como la mejora en la aprobación de pagos, la conciliación financiera o la seguridad, entre otros.
+
+En caso de precisar ajustes, se te sugerirán acciones necesarias y buenas prácticas para mejorar estos aspectos evaluados y, de esa manera, garantizar que tu integración cumpla con los estándares necesarios.
+
+### Aprobación de pagos
+
+Conoce qué medidas puedes llevar adelante para mejorar la [aprobación de pagos](/developers/es/guides/additional-content/how-tos/payment-rejections), tales como el envío de información del ítem y del pagador, datos de envío e información de industria, entre otros.
+
+### Notificaciones
+
+Mantén actualizado el estado de las órdenes en tus sistemas usando y procesando de forma correcta las notificaciones [IPN](/developers/es/guides/additional-content/your-integrations/ipn) o [Webhooks](/developers/es/guides/additional-content/your-integrations/webhooks).
+
+### Reportes
+
+Los [reportes de Mercado Pago](/developers/es/guides/additional-content/reports/introduction) proporcionan información financiera para dar seguimiento a las transacciones de las cuentas, como el saldo disponible, los movimientos y la liquidez. Esto facilita la conciliación de las ventas y otras operaciones con sus sistemas de gestión internos.
 
-+ Mejora la [aprobación del pago](/developers/es/guides/additional-content/how-tos/payment-rejections) enviando información del ítem y del pagador, datos de envío e información de industria.
-+ Mantén actualizado el estado de las órdenes en tus sistemas usando y procesando de forma correcta las notificaciones [IPN](/developers/es/guides/additional-content/your-integrations/ipn) o [Webhooks](/developers/es/guides/additional-content/your-integrations/webhooks).
-+ Consume reportes de conciliación vía API para mejorar la gestión financiera del negocio.
+Te recomendamos utilizar los reportes para mejorar la gestión financiera empresarial una vez que hagas tu salida a producción.