Ambientes y llaves

Para integrar Wompi en tu comercio, debes tener siempre presente que existen llaves de autenticación. Estas llaves son la forma en la que Wompi te identifica como comercio a la hora de procesar transacciones y, en general, interactuar con todos nuestros servicios. Más abajo encontrarás una explicación detallada de los tipos de llaves que existen en Wompi.

Las llaves también definen si las operaciones que estás realizando son de prueba o con dinero real. En términos más precisos, la llave que utilices define el ambiente de ejecución que estás usando.

La forma de diferenciar cada ambiente es simplemente a través de dos cosas: la llave utilizada y la URL del API.

Llaves

En Wompi se tienen varios tipos de llaves los cuales se utilizan para dar seguridad al momento de enviar o recibir mensajes de Wompi.

Hay una de cada tipo de llave por cada ambiente de ejecución, es decir, una para Sandbox y otra para Producción. La diferencia está en el prefijo que usa cada una:

• Para Sandbox las llaves tienen el prefijo pub_test_, prv_test_, test_events_ y test_integrity_
• Para Producción las llaves tienen el prefijo pub_prod_ y prv_prod_, prod_events_ y prod_integrity_

Llaves de autenticación

En Wompi existen dos tipos de llaves:

1. Una llave pública que siempre tiene el prefijo pub_ y se ve como la siguiente, por ejemplo:

   pub_prod_Kw4aC0rZVgLZQn209NbEKPuXLzBD28Zx

2. Una llave privada que siempre tiene el prefijo prv_ y se ve como la siguiente, por ejemplo:

   prv_prod_434092Xa65F54dd6a181D1f87DFa03CzS

Secretos de integración

Además de las llaves de autenticación, también se tienen dos tipos de secretos:

1. Una llave de eventos que siempre tiene el prefijo prod_events_ y se ve como la siguiente, por ejemplo:

   prod_events_Y49rL5FGw4vTeiUaZaJ957hlpezdPQ0r

2. Una llave de integridad que siempre tiene el prefijo prod_integrity_ y se ve como la siguiente, por ejemplo:

   prod_integrity_ep4b3kSYJg2bWHwL7ulhPCDvaiyGDW7V

Consigue tus llaves

Si todavía no tienes un par de llaves de autenticación, regístrate en comercios.wompi.co y obtén tus llaves en segundos, para que comiences a integrar tu comercio.

Ambientes de ejecución

En Wompi existen dos ambientes de ejecución que cumplen distintos propósitos:

• Sandbox: Es el ambiente de pruebas, el cual puedes utilizar para realizar transacciones "falsas" y simular resultados (aprobada, declinada). Su uso se recomienda mientras se esté desarrollando la integración y haciendo pruebas en tus servidores locales o de pruebas.
• Producción: Es el ambiente sobre el cual se ejecutan transacciones con dinero real. Este lo debes usar una vez termines una integración con Wompi y quieras aceptar pagos.

Mientras integras, tienes la posibilidad de hacer operaciones que no son con dinero real u operaciones que sí lo son. Esto se logra gracias a que existe un ambiente de pruebas, llamado Sandbox y otro para operaciones reales, llamado ambiente de Producción.

Ambos ambientes pueden ser usados en cualquier momento, sólo debes tener presente que éstos son independientes y la información de uno no está disponible en el otro. Así por ejemplo si realizas transacciones o creas links de pago en Sandbox, esta información no estará disponible ni afectará de ninguna manera la que esté en Producción, ni viceversa.

Cada ambiente de ejecución es un API completamente separado del otro, sin embargo la especificación del API es exactamente la misma. Así que los endpoints (que puedes consultar en nuestra referencia del API) se mantienen; el único cambio es la URL base que se utiliza.

Para Sandbox la URL base que debes usar actualmente es:

https://sandbox.wompi.co/v1

Para Producción la URL base que debes usar actualmente es:

https://production.wompi.co/v1

Usa las llaves respectivas en cada entorno

Ten siempre presente que cuando usas la URL de un entorno, debes usar sus respectivas llaves. Así:

• Para la URL de Sandbox debes usar las llaves con prefijo pub_test_ y prv_test_
• Para la URL de Producción debes usar las llaves con prefijo pub_prod_ y prv_prod_