# README

¡Bienvenido/a a nuestra documentación oficial!

Estamos encantados de tenerte aquí y agradecemos tu interés en conocer más sobre nuestra empresa. En esta documentación, encontrarás información detallada y recursos valiosos para guiarte a través de nuestras soluciones y servicios. Nos comprometemos a proporcionarte información clara y accesible.

La documentación está dividida por nuestros productos. Dentro de cada sección, encontrarás una guía específica de Preguntas Frecuentes (FAQ).

![MYMOID-Docs-transp.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-212c6e5dec55d7a6dddbe3f78b45fb459e6bac34%2FMYMOID-Docs-transp.png?alt=media)


# MYMOID-Suite


# MYMOID-Suite

Nuestra estrategia, centrada en la mejora continua, la optimización de pagos y la simplificación, nos lleva a colocar al desarrollador, junto al cliente, en el centro de nuestro negocio. Esto refleja nuestro compromiso de proporcionar soluciones más efectivas y eficientes para nuestros clientes y socios.

MYMOID-Suite representa un paso adelante en nuestra misión de ofrecer un servicio de calidad superior y fortalecer nuestra relación con aquellos que confían en nuestros productos y servicios.

## ¿Qué es MYMOID-SUITE?

**MYMOID-Suite** es un conjunto de aplicaciones que simplifican la integración con el API de pagos de MYMOID y la posterior visualización de datos relacionados con todas las operaciones generadas mediante ella (el API). Está diseñada para ayudar a las empresas, organizaciones y usuarios individuales a colaborar, comunicarse y gestionar su trabajo de manera más eficiente.

MYMOID-Suite engloba diversas aplicaciones y herramientas, incluyendo:

![mymoid-suite.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-14de4b2428217f2d2b5cb9a8a4dfff7e54dfa7fc%2Fmymoid-suite.png?alt=media)

* **API payments:** herramienta para integrar cualquier solución de pago con el mínimo esfuerzo.
* **Accounts:** aplicación que permite registrar tu cuenta en MYMOID. Y con tu cuenta, podrás crear organizaciones, invitar usuarios y gestionar permisos a usuarios en los entornos (de producción y de prueba) en el resto de las aplicaciones dentro de cada organización.
* **Developers:** aplicación que permite crear y gestionar APP, es decir, claves de acceso al API de MYMOID. *En el contexto de una organización, solo podrá acceder a esta información aquel usuario que se le haya concedido permisos.*
* **Collection:** aplicación que permite crear y enviar órdenes de pago y campañas de ordenes de pago con la finalidad de facilitar su posterior procesamiento y pago. *En el contexto de una organización, solo podrá acceder a esta información aquel usuario que se le haya concedido permisos.*
* **Payment form:** Herramienta/interfaz que representa una orden de pago. Permite visualizar los detalles de la orden e introducir datos del medio de pago para efectuar el pago como tal.
* **Payment gateway:** aplicación que permite visualizar información de todas las operaciones (detalle de órdenes de pago y detalle de transacciones) realizadas. *En el contexto de una organización, solo podrá acceder a esta información aquel usuario que se le haya concedido permisos.*

## ¿Qué debo hacer para ser parte? ¿Cómo opero en cada aplicación?

Ser parte de MYMOID es fácil y rápido. Solo debes de crearte [una cuenta en Accounts](https://accounts.mymoid.com/) y una vez que hayas verificado tu cuenta, podrás disfrutar de todos los productos de MYMOID-Suite.

### Sigue los siguientes pasos:

### Crea una cuenta:

Accede a Accounts y [crea tu cuenta](https://accounts.mymoid.com):

1. Haz clic en “Register”:

![register\_1.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-791012a9dbda79a96c2adefb4f5e1c625205fd6e%2Fregister_1.png?alt=media) 2. Completa el formulario de usuario con email y contraseña:

![register\_2.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-d1270d34bf62b5cb84ce85d5e243230f3c0c8af9%2Fregister_2.png?alt=media) 3. Valida tu cuenta y vuelve a hacer Log In.

![register\_4.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-60f4a34f55d3b56d46eaa7f6db077f1044065b18%2Fregister_4.png?alt=media)

![register\_3.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-7e3822e6628202f49ed96234cb061f034d6300e4%2Fregister_3.png?alt=media)

### Crea una organización:

Una vez logueado, desde aplicación [Accounts](https://accounts.mymoid.com/dashboard), crea al menos una organización. *Puedes crear tantas organizaciones como necesites.*

1. Haz clic en “Create Organization”. Esta opción la puedes encontrar en la Home o en la sección de “My organization”

![create\_account\_1.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-791012a9dbda79a96c2adefb4f5e1c625205fd6e%2Fcreate_account_1.png?alt=media) 2. Escribe el nombre de tu organización y haz clic en el botón de “Create”

![create\_account\_2.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-2b566a94a63535350c327ec2ed57f9aaab9591db%2Fcreate_account_2.png?alt=media) 3. En la sección de “My organizations” podrás visualizar todas las organizaciones creadas.

![create\_account\_3.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-25ea427f29e18afc9b76d568f8da6380d154658d%2Fcreate_account_3.png?alt=media)

### Crea tu primer orden de pago

Para crear una orden de pago, puedes hacerlo de las siguientes maneras:

* Integrandote directamente a nuestra [API](/por-producto/developers/que-es-el-api-reference) (te recomendamos usar nuestro [playground](https://developers.mymoid.com/api-reference#/operations/Create)).
* desde el producto [Collection](/por-producto/collection/como-creo-una-orden-de-pago-individual).
* o, como explicaremos a continuación, desde el producto [Paymentgateway](https://paymentgateway.mymoid.com)

**Crea tu primer orden de pago desde Payment Gateway**

Navega a [Paymentgateway](https://paymentgateway.mymoid.com)

1. Inicia sesión en tu cuenta y selecciona la organización posteriormente creada desde Accounts.

{% hint style="info" %}
Recuerda que para utilizar los servicios de MYMOID, debes [crear una cuenta](http://accounts.mymoid.com). ¡Es totalmente gratis!
{% endhint %}

![create\_PO\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-b68a7529be8cc84d818cc86f3167361491f6fdb4%2Fcreate_PO_1.png?alt=media)

2. Ve a la sección de "Payment Orders" y haz clic en el botón "Create Payment Order" para abrir el panel lateral.

![create\_PO\_2](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-669a0f91a1241f2b9d794b2800534b24eba101eb%2Fcreate_PO_2.png?alt=media)

*Ten en cuenta que, si tu organización ya tiene órdenes de pago creadas, el botón se encuentra en el margen superior derecho.*

3. Completa todos los campos requeridos de la orden de pago:

* Concepto (Concept)
* Referencia (Reference)
* Moneda y Monto (Currency & Amount)

Recuerda que los campos `Concept`, `Reference`, `Currency` & `Amount` son visibles para el usuario final y aparecerán en el Formulario de Pago de la siguiente manera:

![create\_PO\_3](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-25c20e2523c7a527b827ae61bfe25bb0d4a94922%2Fcreate_PO_3.png?alt=media)

4. \[Opcional] Fecha de expiración: indica hasta qué fecha y hora la orden de pago estará disponible para ser pagada. Por defecto, está configurada a 24 horas, pero puedes personalizarla eligiendo una fecha y hora posteriores a la fecha de creación y menores a 15 días.

![create\_PO\_4](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-65fcf0815855c275e7861c3177a0c74d0547b5fa%2Fcreate_PO_4.png?alt=media)

6. \[Opcional] Payment Points: configuración de los métodos de pago y el procesador. Por defecto, se selecciona el configurado previamente (puedes ver esta información en la sección de Payment Points). Si deseas elegir uno en particular, puedes hacerlo.

Haz clic en el botón "Create" y podrás visualizar la orden de pago (en estado disponible).

![create\_PO\_6](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-57fdfa9dcea0344221b550d82b62e4fc00650bba%2Fcreate_PO_6.png?alt=media)

6. Si lo deseas, puedes compartir el enlace de la orden de pago. Haz clic en el botón "Copy Link" y ¡listo!

{% hint style="info" %}
💡 **Ten en cuenta:**

* A todas las aplicaciones se accede con el mismo usuario y contraseña.
* Al crearte un organización en MYMOID, automáticamente podrás acceder en entorno de prueba a las aplicaciones: Accounts, Developers, API y Payment Gateway.
* La aplicación Collection solo opera en entorno de producción.
  {% endhint %}

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Accounts


# Accounts: Funcionalidades y beneficios

## ¿Qué es Accounts?

La aplicación [**Accounts**](https://accounts.mymoid.com/) es un aplicación dentro de MYMOID-Suite que permite a cualquier usuarios crear y gestionar una cuenta en MYMOID que, a su vez, les brinda acceso a una variedad de servicios y aplicaciones de MYMOID-Suite.

Adicionalmente, esta aplicación ha sido concebida con el propósito de asistir a las empresas en la creación de sus estructuras organizativas y en la gestión de los permisos de acceso de los usuarios a las diversas aplicaciones, de una manera simple y fácil.

## Funcionalidades:

* Creación de cuenta en MYMOID.
* Creación y gestión de organizaciones. Puedes crear N cantidad de organizaciones.
* Invitación de usuarios a cada organización y gestión de permisos de usuarios a cada entorno de cada producto dentro de cada organización.
* Edición de perfil de cuenta y configuración de privacidad.

## Beneficios:

Poseer una cuenta de MYMOID, permite:

* **Centralización de acceso** a las distintas aplicaciones en una sola cuenta.
* **Comunicación eficiente** entre las distintas aplicaciones de MYMOID: Puedes navegar fácil entre los distintos productos de MYMOID ([Accounts](https://accounts.mymoid.com/), [Payment Gateway](https://paymentgateway.mymoid.com), [Developers](https://developers.mymoid.com) & [Collection](https://collection.mymoid.com).)
* **Escalabilidad de la cuenta**: puedes agregar o quitar organizaciones según sea necesario.
* **Escalabilidad de cada organización**: puedes agregar o quitar usuarios según sea necesario a medida que cada organización crece o cambia.

Para crear una cuenta en MYMOID, solo debes [registrarte](https://accounts.mymoid.com/). Una vez que hayas verificado la cuenta, podrás empezar a probar las aplicaciones de MYMOID en entorno de prueba.

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Creación de cuenta MYMOID

Ser parte de MYMOID es fácil y rápido. Solo debes crear [una cuenta en Accounts](https://accounts.mymoid.com/) y una vez que hayas verificado tu cuenta, podrás integrarte con el API y comenzar a probar en un entorno de prueba el flujo de pagos en todas nuestras aplicaciones.

### Sigue los siguientes pasos:

**👉 Crea una** [**cuenta**](https://accounts.mymoid.com) **en MYMOID:**

1. Haz clic en “Register”:

![create\_account\_1.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-791012a9dbda79a96c2adefb4f5e1c625205fd6e%2Fcreate_account_1.png?alt=media)

2. Completa el formulario de usuario con email y contraseña:

![create\_account\_2.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-e54318f0dde9426abba668a7576d4a5369738fa0%2Fcreate_account_2.png?alt=media)

3. Ahora debes verificar tu cuenta. Para ello, revisa tu correo electrónico y haz clic en el link de verificación que te enviamos.

![create\_account\_3.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-a1c7da9f08bca3a5f3d48490af480289ce34de1b%2Fcreate_account_3.png?alt=media)

4. Finalmente, recibirás un mensaje de confirmación de que tu cuenta ha sido verificada.

![create\_account\_4.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-7e3822e6628202f49ed96234cb061f034d6300e4%2Fcreate_account_4.png?alt=media)

¡y listo! ya tienes tu cuenta en MYMOID.

{% hint style="info" %}
Al crear una cuenta en MYMOID, puedes probar las distintas aplicaciones en entorno de prueba hasta que **solicites el alta de tu organización en producción.**
{% endhint %}

## ¿Qué significa tener una cuenta en MYMOID?

Con tu cuenta en MYMOID podrás explorar y probar los servicios y aplicaciones de MYMOID-Suite sin procesar transacciones reales ni recibir pagos reales hasta la activación de tu organización en producción.

**Ten en cuenta:**

* A todas las aplicaciones debes acceder con el mismo usuario y contraseña.
* Al crear una organización en MYMOID, automáticamente podrás acceder en entorno de prueba a las aplicaciones: Accounts, Developers, API y Payment Gateway.
* La aplicación Collection solo opera en entorno de producción.

De esta manera, te permite familiarizarte con todas las capacidades de MYMOID, probar la integración y garantizar que todo funcione sin problemas antes de comenzar a procesar pagos en un entorno de producción real. Esto es especialmente útil para asegurarte de que estás listo para manejar transacciones reales y brindar una experiencia de pago fluida a tus clientes.

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Creación de organización

La creación de una organización es un paso fundamental para empezar a operar en MYMOID. No existe un límite en la cantidad, puedes crear cuantas organizaciones quieras. Ten en cuenta algunos aspectos:

* Al crear una organización, automáticamente puedes empezar a probar las aplicaciones de MYMOID-Suite en un entorno de prueba (sandbox). Y apenas estés listo, ¡te esperamos para que des de alta tu organización en entorno de producción!
* Al crear una organización, podrás acceder a las aplicaciones:
* Developers: para gestionar tus claves de acceso al API.
* Payment Gateway: para visualizar y controlar todas las operaciones que se generen en la organización.
* Integrar nuestra API: para crear, devolver órdenes de pago.

{% hint style="info" %}
La aplicación de Collection, solo está disponible para cuentas con el entorno de producción activado.
{% endhint %}

Al crear una organización, eres el propietario (owner), y tendrás permisos ilimitados sobre la misma. Puedes cambiarle el nombre, invitar usuarios (con el rol `guest`) y seguidamente limitar sus accesos a cada entorno en cada aplicación.

### Sigue los siguientes pasos:

1. Haz clic en “Create Organization”. Esta opción la puedes encontrar en la pagina principal o en la sección de “My organization”

![create\_org\_1.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-1789bd1a3606199543f61ecaaf0bef0f8bf90884%2Fcreate_org_1.png?alt=media)

2. Escribe el nombre de tu organización y haz clic en el botón de “Create”. *Puedes crear N cantidad de organizaciones pero recuerda que deben tener diferentes nombres entre cada una de ellas.*

![create\_org\_2.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-2b566a94a63535350c327ec2ed57f9aaab9591db%2Fcreate_org_2.png?alt=media)

3. En la sección de “My organizations” podrás visualizar todas las organizaciones creadas.

![create\_org\_3.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-25ea427f29e18afc9b76d568f8da6380d154658d%2Fcreate_org_3.png?alt=media)

4. Haz clic en la fila correspondiente a una organización específica para visualizar el detalle: editar el nombre, copiar el ID de la organización o gestionar los permisos de usuarios.

## Al crear una organización, ¿ya estoy operando en producción?

Al crear una organización no estás operando en producción. Como se comentó anteriormente, la creación de una organización permite operar y probar el flujo de pago en las aplicaciones de MYMOID-Suite bajo el ID de organización creada.

En el momento que estés listo, puedes dar el alta de tu organización en entorno de producción y empezar a operar con información real. [Comunicate con nuestro equipo de soporte](https://support.mymoid.com/support/home) y te guiaremos en los pasos a seguir.

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# ID de organización

### Desde el producto [Accounts](https://accounts.mymoid.com):

En la sección de “[My Organizations](https://accounts.mymoid.com/dashboard/organizations)” podrás visualizar todas las organizaciones a las que tienes acceso. Haz clic en la fila de la organización de tu interés y podrás visualizar el ID en el panel que se abre. Además, puedes copiarlo fácilmente con un solo clic en el icono de copiar.

![where\_is\_ID\_1.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-c3f9b245a38d32cfad7c59a217f1e4222a34215e%2Fwhere_is_ID_1.png?alt=media)

### Desde cualquier productos dentro de MYMOID-Suite:

Si te encuentras en otro producto, como [Developers](https://developers.mymoid.com/dashboard), [Payment Gateway](https://paymentgateway.mymoid.com/dashboard) o [Collection](https://collection.mymoid.com/dashboard/organizations), simplemente dirígete a la barra de menú y busca la lista desplegable que muestra todas las organizaciones a las que tienes acceso. Al hacer clic en el icono de más, se abrirá una pequeña ventana donde podrás ver el ID de la organización que estás buscando.

![where\_is\_ID\_2.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-5c7f84d5b32015d6d88bda45ef99a834760bf1c5%2Fwhere_is_ID_2.png?alt=media)

***

#### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Gestión de invitaciones

MYMOID ofrece la capacidad de colaborar con otros usuarios de MYMOID mediante la invitación a tu organización, asignación de roles y permisos específicos. Antes de comenzar, es importante resaltar que, todos los usuarios que desees invitar a tu organización, deben [poseer una cuenta en MYMOID activa.](/por-producto/accounts/como-creo-mi-cuenta-en-mymoid)

Sigue los siguientes pasos:

**Usuario owner de la organización:**

1. Desde la sección de [“My Organizations”](https://accounts.mymoid.com/dashboard/organizations), abre el detalle de la organización que deseas invitar usuarios.

   ![invite\_user\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-e78a6cb83576548865739a9686236379a6e66b78%2Finvite_user_1.png?alt=media)

   ![invite\_user\_2](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-50c56469ed50b6157e0836eb7c8830ee23a8202b%2Finvite_user_2.png?alt=media)
2. Al final del panel, encontrarás la sección de `Active users` y el botón de `Invite users`. Haz clic en este botón.

   ![invite\_user\_3](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-e3f49cadce40f2c6f6d2b8eab19df868125fb499%2Finvite_user_3.png?alt=media)
3. Se abrirá un modal, donde debes ingresar las direcciones de correo electrónico de las personas que desees invitar. Si deseas invitar más de una persona, debes escribir los correos electrónicos separados con una coma (”`,`”).

   ![invite\_user\_4](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-aec40b695743bb6a228040103079637046361761%2Finvite_user_4.png?alt=media)

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>Antes de enviar la solicitud, asegúrate que todos los correos electrónicos escritos estén dados de alta y posean una cuenta en MYMOID.</p></div>
4. Una vez la solicitud sea enviada, el usuario invitado recibirá la invitación a su correo electrónico. Hasta que el usuario invitado acepte la invitación, podrá ver la invitación en el listado de "pending users". Haz clic en el dropdown de "active users" y navega al listado de "pending users".

   ![invite\_user\_5](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-ad544ece30c715966fcfa78a94563757e71fd0af%2Finvite_user_5.png?alt=media)

   ![invite\_user\_6](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-411ca0d33a85660f61ccdd0db8a579c1a6d9a38b%2Finvite_user_6.png?alt=media)

**Usuario invitado:**

1. Al recibir un correo electrónico con una invitación a una organización, debes hacer clic en el link "I accept the invitation" y automáticamente se te redirigirá al producto MYMOID-Accounts para continuar con el proceso.

   ![recive\_invitation\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-80b48a05b938afe584d5858b41d7accb9198b0ec%2Frecive_invitation_1.png?alt=media)
2. Si no tienes la sesión abierta, deberás hacer login (si no posees una cuenta, deberás crearte una). Al ingresar, te aparecerá un modal de confirmación para aceptar o rechazar la invitación.

   ![recive\_invitation\_2](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-d3066ccac86c974a4f11af9be393c3ee38edf636%2Frecive_invitation_2.png?alt=media)

   ![recive\_invitation\_3](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-4d46a3e99005ab0c1526f60d5426b56651ace22e%2Frecive_invitation_3.png?alt=media)

**Usuario owner y usuario invitado:**\
Al aceptar la invitación:

* El usuario invitado podrá visualizar la organización a la cuál ha sido invitada en el listado de organizaciones y su rol de `“guest”`.

  ![recive\_invitation\_4](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-df6ad835f2805f7328f7a6c35d071081c6312503%2Frecive_invitation_4.png?alt=media)
* El usuario owner podrá visualizar al usuario invitado dentro del listado de "Active users (n)" y desaparecerá del listado de "Pending users(n)".

  ![invite\_user\_7](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-dec796cc74123077a076f4907a3b87d5555562fe%2Finvite_user_7.png?alt=media)

  ![invite\_user\_8](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-9d8466b810901fab37ea26b285db76c36bfe59d3%2Finvite_user_8.png?alt=media)

Al tener los usuarios invitados (rol `“guest”`) en tu organización, puedes darle permisos de acceso a los entornos de cada aplicación de MYMOID-Suite.

{% hint style="info" %}
Importante: un usuario `guest` podrá ver en el listado de organizaciones, las organizaciones a las que pertenece pero no podrá visualizar información sensible de la organización. Solo su nombre y ID.
{% endhint %}

### Consideraciones:

* Para eliminar un usuario "guest" de tu organización, haz clic en el icono de tacho de basura y confirma su eliminación. Al eliminarlo, perderá el acceso a todos los productos bajo esa organización. El usuario eliminado, recibirá una notificación a su email.
* Puedes eliminar una invitación en estado pendiente desde el listado de "pending users". Haz clic en el icono de tacho de basura y confirma su eliminación. Al eliminarlo, el link de invitación previamente enviado, pierde validez automáticamente.

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Gestión de permisos a miembros en productos

Como `owner` de una organización, puedes asignarle a tus usuarios invitados `guest` permisos de acceso a cada entorno en cada aplicación según tus necesidades. Asegúrate de revisar detenidamente los permisos que otorgas, ya que determinarán qué acciones pueden realizar en tu organización.

Sigue los siguientes pasos:

1. En el detalle de una organización específica, sobre el listado de usuarios activos `Active users`, haz clic sobre el usuario que deseas asignar/Editar los permisos.

   ![add rol.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-5aece50a874a06862a9aa30bbe4d6b529308f6c2%2Fadd_rol.png?alt=media)
2. En el detalle del usuario, podrás visualizar el listado de aplicaciones disponibles para darle o quitarle acceso en cada entorno. Solo debes hacer clic en el checkbox correspondiente y en cuestión de segundos el usuario obtiene los permisos otorgados. Seguidamente verás un mensaje de confirmación.

   ![add rol 2.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-4ca60e4950dc88d746bfb67c8c29855c80925538%2Fadd_rol_2.png?alt=media)

¡y listo! Puedes editar los permisos las veces que quieras.

### Algunas consideraciones:

* Por defecto, el usuario `owner` tiene permisos a todas tus aplicaciones en todos tus entornos. Este permiso no puede ser removido.
* Por defecto, el usuario `guest` no tiene permiso a ningún entorno de cada aplicación. El usuario “owner” será quién debe darle o quitarle permisos.
* Al asignarle el permiso de acceso a un entorno de una aplicación, el usuario podrá realizar cualquier actividad dentro de esa aplicación en ese entorno **de la misma forma que un owner.**

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Reestablecer contraseña

Para restablecer tu contraseña, sigue los siguientes pasos:

1. Navega a la sección [“My profile”](https://accounts.mymoid.com/dashboard/profile/info) y haz clic en la subsección de [“Security”](https://accounts.mymoid.com/dashboard/profile/security)
2. Haz clic en `Change password` y recibirás un correo para continuar con el proceso de cambio de contraseña.

   ![change\_password\_1.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-c790cf048e1f2648e5675d330e595305fdbb9d1d%2Fchange_password_1.png?alt=media)

¡y listo!

{% hint style="info" %}
Sugerimos que, antes de cambiar contraseña, cierre sesión en todas las ventanas abiertas del navegador con aplicaciones de MYMOID.
{% endhint %}

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Eliminación de cuenta MYMOID

Si, aunque lamentamos que tomes esta decisión, puedes eliminar una cuenta de MYMOID. Sigue los siguientes pasos:

1. Navega a la sección [My profile](https://accounts.mymoid.com/dashboard/profile/info)
2. Haz clic en `Delete Account` y confirma la solicitud de eliminación de cuenta.

   ![delete\_account\_1.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-25d4f18ee466d978a922e66c635543c854791f9c%2Fdelete_account_1.png?alt=media)

{% hint style="warning" %}
Ten en cuenta que el proceso de eliminación no es **inmediato**. Debido a que una cuenta puede tener información sensible, nuestro equipo de soporte debe analizar la información vinculada. Este proceso puede durar hasta 30 días. Te mantendremos informado.
{% endhint %}

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Eliminación de organización

No, de momento no puedes eliminar una organización. Si necesitas hacerlo, [Escribe un ticket](https://support.mymoid.com/support/home) a nuestro equipo de soporte y te ayudaremos a resolver el caso.

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Developers


# Developers: Funcionalidades y Beneficios.

[Developers](https://developers.mymoid.com/) es una innovadora aplicación diseñada para guiar y optimizar la integración con el API de pagos de MYMOID. Está dividida en dos partes:

* Developers Portal.
* Developers Privado (Solo acceso con cuenta MYMOID)

## Developers Portal

Documentación, manuales y tutoriales que proporcionan información detallada sobre el procedimiento de creación de una cuenta en MYMOID, de la integración al API de pagos y del funcionamiento/respuestas de la pasarela de pagos. Adicionalmente, puedes encontrar el API-Reference, una herramienta segura e intuitiva, que te permitirá explorar y probar el API directamente desde la interfaz y conocer su estado en [API Status](https://developers.mymoid.com/api-status).

<figure><img src="https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-2287e2231e7a2b1a1a4652dde3928f6304d28252%2Fdevelopers_dashboard_1.png?alt=media" alt=""><figcaption></figcaption></figure>

## Developers Private \[dashboard de gestión]

Dashboard privado (sólo se puede acceder si posees una cuenta en MYMOID) que permite la creación y gestión de APPs (claves de acceso al API de MYMOID). Esta herramienta se convierte en un recurso invaluable para las organizaciones que buscan aprovechar al máximo las capacidades de MYMOID en su entorno digital.

Al crear una organización desde [Accounts](https://accounts.mymoid.com/), sólo los usuarios con los permisos correspondientes, podrán acceder a Developers bajo esa organización. Esto asegura **la confidencialidad y la integridad de los datos**, al tiempo que se facilita una administración precisa de quién puede acceder y realizar cambios en las configuraciones.

<figure><img src="https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-3d1ca0d50582615408a2730e52ea7753ea0747c5%2Fdevelopers_dashboard_3.png?alt=media" alt=""><figcaption></figcaption></figure>

## Funcionalidades:

* Documentación y procedimientos sobre flujos relevantes en MYMOID.
* Herramienta API-Reference intuitiva y segura.
* Visualización del estado del API (API Status).
* Creación y gestión de APPs (claves de acceso para integrarse al API de pago de MYMOID).
* Configuración de Webhooks.

## Beneficios:

Un producto especializado diseñado para integrarse facilmente con el API de MYMOID:

1. **Documentación centralizada y detallada** Toda la información necesaria para conocer, aprender y guiarte en la integración del API de MYMOID.
2. **Creación de APPs de manera autónoma y por entornos:** Sin recurrir al equipo de MYMOID, podrás crear cuantas API keys quieras para integrarte con el entorno de sandbox o de producción del API de pagos de MYMOID.
3. **Control de acceso preciso:** Desde la aplicación Accounts, se puede asignar permisos de acceso de manera específica a usuarios autorizados. Esto significa que solo las personas designadas podrán ingresar a un entorno de Developers y copiar las API keys.
4. **Seguridad reforzada y almacenamiento seguro:** Al restringir el acceso solo a usuarios autorizados, se fortalece la seguridad de las API keys. Esto reduce significativamente el riesgo de que las claves caigan en manos equivocadas o compartir las mismas por canales no encriptados.
5. **Gestión centralizada:** Facilita la gestión centralizada de todas las API keys en un solo lugar. Esto simplifica la administración y actualización de las claves.

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Guías de Developers Portal

[Developers Portal](https://developers.mymoid.com/) ofrece toda la documentación, manuales y tutoriales sobre el procedimiento de creación de una cuenta en MYMOID, de la integración al API de pagos y del funcionamiento/respuestas de la pasarela de pagos. Estando dividida en 5 secciones:

![developers\_section\_1.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-b9460dc3cfb962205204ed905e72bb29cfdb444d%2Fdevelopers_section_1.png?alt=media)

* **Guides**: Proporciona instrucciones, tutoriales, y explicaciones detalladas sobre cómo utilizar MYMOID y cómo integrarse al API de pagos. Incluye ejemplos de código, consejos de uso, buenas prácticas con el objetivo de crear una documentación intuitiva y fácil de leer. Está dividida en subsecciones, donde podrás navegar entre ellas según la información que desees conocer.

{% hint style="info" %}
Si es tu primera vez, recomendamos que comiences leyendo el "Getting started" donde encontraras una guía detallada con el paso a paso a seguir para, de manera rápida y fácil, ser parte de MYMOID.
{% endhint %}

* **Api Reference:** Proporciona detalles técnicos y exhaustivos sobre cada endpoint, método, parámetro y respuesta del API de pagos. Describe cómo interactuar con el API de manera precisa y técnica, incluyendo ejemplos de solicitudes y respuestas.
* **Changelog:** Donde se registra los cambios y actualizaciones realizados en el API, permitiendo a los desarrolladores mantenerse al tanto de las modificaciones realizadas y entender cómo pueden afectar a su trabajo o al uso de la aplicación.
* **Api Status:** Presenta la condición operativa actual de una API en términos de disponibilidad y rendimiento. Proporciona información sobre si la API está funcionando correctamente o si hay problemas, como caídas del servicio o tiempos de respuesta lentos.
* **Librería de aplicaciones:** Puedes navegar al resto de aplicaciones de MYMOID-Suite.

Por otro lado, si posees cuenta en MYMOID, puedes acceder al [dashboard privado](https://developers.mymoid.com/dashboard/organizations) para la gestión de claves de integración al API.

***

### Links de interés

Vistia nuestro [Api-Reference](https://developers.mymoid.com/api-reference)

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Estado del API

El estado del API lo puedes encontrar en la sección de [API STATUS](https://developers.mymoid.com/api-status) en el Developers Public.

El **API STATUS** presenta la condición operativa actual del API en términos de disponibilidad y rendimiento. Proporciona información sobre si la API está funcionando correctamente o si hay problemas, como caídas del servicio o tiempos de respuesta lentos.

![api\_status.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-4a805d325c06e8e5f2f10e396a652d33ffa56656%2Fapi_status.png?alt=media)

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Integración a MYMOID-API

Integrarte con el API de MYMOID es muy simple. Para ello debes estar registrado en MYMOID y tener creada una organización.

{% hint style="info" %}
El registro de la cuenta y la creación de una organización (en entorno de prueba) se realiza de forma autónoma desde la aplicación [Accounts](https://accounts.mymoid.com/dashboard). Para más información acerca del paso a paso [consulta esta guía](https://docs.mymoid.com/por-producto/accounts/como-creo-una-organizacion).
{% endhint %}

Si ya tienes una organización creada, sigue los siguientes pasos:

1. **Accede a** [**Developers Private**](https://developers.mymoid.com/dashboard): Con el usuario creado, accede al producto Developers y selecciona la organización.

<figure><img src="https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-a1a7166cdfed7b2aca3d55df559d04559fea6c31%2Fcreate_app_1.png?alt=media" alt=""><figcaption></figcaption></figure>

2. Verifica que estás en el entorno deseado (sandbox o producción) y, dentro de la sección "Apps", haz clic en el botón "Create App":

<figure><img src="https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-ea547b07e5170762784483162882e1dc41709be9%2Fcreate_app_2.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
si no posees el alta en producción, solo podrás crear aplicaciones en el entorno de sandbox.
{% endhint %}

3. Se abrirá un panel lateral para la creación de la App. Completa los siguientes campos:

* Un nombre de identificación de la APP,
* Una descripción.

<figure><img src="https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-5bdbf1a066fb62f3681e1e60a19614ae52ed8451%2Fcreate_app_3.png?alt=media" alt=""><figcaption></figcaption></figure>

¡Y listo! Una vez creada, podrás visualizar y editar la aplicación, copiar tu API key.

{% hint style="warning" %}
Recuerda que una aplicación contiene **información sensible y confidencial.** Revelar dicha información, a personas no autorizadas podría tener consecuencias negativas en términos de seguridad y privacidad. Es por eso que, si deseas compartir esta información, desde [Accounts](https://accounts.mymoid.com), invita a usuarios a tu organización y otórgales el acceso necesario para que puedan acceder.
{% endhint %}

4. **Intégrate con nuestra API y crea tu primera orden de pago:** Con el API-KEY copiada, navega a [nuestro API-Reference](https://developers.mymoid.com/api-reference#/operations/Create) y utiliza el playground para integrarse con nuestra API:
5. Pega el API Key copiado en el campo correspondiente (`”x-api-key”`).
6. Completa los campos de la orden de pago a crear según preferencia (`"reference"`, `"concept"`, `"amount"`, `"currency"`, `"expiration_date"`)
7. Envía la petición al API haciendo clic en “Send API Request”\
   *(Asegurate de que estés operando en el mismo entorno donde se ha creado la APP. Si todavía no tienes cuenta en producción, entonces será “Sandbox Server”*)
8. Verifica que la orden de pago haya sido correctamente creada en el apartado de “Response Example”. *En caso de error, verifica en la respuesta el tipo de error.*

<figure><img src="https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-7df0e302e137301ff1c991a9e82855f4ea6a0e02%2Fapi_reference_1.png?alt=media" alt=""><figcaption></figcaption></figure>

¡Listo! ya tienes creada tu orden de pago. Puedes repetir el proceso y crear cuantas órdenes de pago quieras.

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# APP: ¿Qué es y dónde creo una APP?

## ¿Qué es una APP?

Una aplicación (APP) es una entidad que representa el acceso a las APIs de MYMOID. La misma viene definida por un API-KEY (clave de acceso) y, según su configuración, permite integrarse con una o varias APIs de MYMOID en un entorno específico (sandbox o producción)

{% hint style="info" %}
Por el momento, sólo permite acceso al API de Pagos.
{% endhint %}

## ¿Cómo creo una APP?

La creación de una aplicación (APP) se realiza desde el [Developers Private](https://developers.mymoid.com/dashboard).

{% hint style="info" %}
Recuerda que antes de ingresar al Developers, debes contar con una [cuenta de MYMOID](https://accounts.mymoid.com) y una organización creada (como`owner`) o asignada (como invitado `guest`).
{% endhint %}

Una vez que ingreses al dashboard del Developers, sigue los siguientes pasos:

1. Selecciona la organización que deseas integrar.

<figure><img src="https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-a1a7166cdfed7b2aca3d55df559d04559fea6c31%2Fcreate_app_1.png?alt=media" alt=""><figcaption></figcaption></figure>

2. Verifica que estás en el entorno deseado (sandbox o producción) y, dentro de la sección "Apps", haz clic en el botón "Create App":

<figure><img src="https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-ea547b07e5170762784483162882e1dc41709be9%2Fcreate_app_2.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
si no posees el alta en producción, solo podrás crear aplicaciones en el entorno de sandbox.
{% endhint %}

3. Se abrirá un panel lateral para la creación de la App. Completa los siguientes campos:

* Un nombre de identificación de la APP,
* Una descripción.

<figure><img src="https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-5bdbf1a066fb62f3681e1e60a19614ae52ed8451%2Fcreate_app_3.png?alt=media" alt=""><figcaption></figcaption></figure>

¡Y listo! Una vez creada, podrás visualizar y editar la aplicación, copiar tu API key.

<figure><img src="https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-075eff5557a7b79069754f310ea9cd1f75bdd376%2Fcreate_app_4.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Recuerda que una APP representa un API key, por lo tanto es **información sensible y confidencial.** Revelar una APP a personas no autorizadas podría tener consecuencias negativas en términos de seguridad y privacidad. Es por eso que, si deseas compartir esta información, desde [Accounts](https://accounts.mymoid.com), invita a usuarios a tu organización y otórgales el acceso necesario para que puedan acceder.
{% endhint %}

**¿Deseas configurar el Webhook de la app creada?** [**Lee este artículo**](/por-producto/developers/que-es-un-webook)

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Configuración de Webhook

## ¿Qué es un webhook?

Un **webhook** es un mecanismo que permite que una aplicación o sistema envíe datos en tiempo real a otra aplicación o sistema cuando ocurre un evento específico. Después de intentar realizar un pago, MYMOID solicitará la URL del webhook de la organización para notificar el éxito o el fracaso del intento de pago.

### Firma del Webhook

Por seguridad y confidencialidad de datos, MYMOID emplea un proceso de firma electrónica que se aplica a las propiedades más relevantes del mensaje. Un **"sign key"** en el contexto de un webhook se refiere a una clave criptográfica utilizada para firmar los datos enviados a través del webhook. Esta firma digital es un mecanismo de seguridad que permite a la parte receptora del webhook verificar la autenticidad e integridad de los datos recibidos, asegurando que provienen de la fuente esperada y que no han sido modificados en tránsito.

Para lograr esto, MYMOID utiliza el algoritmo de codificación SHA-256 junto con la codificación HEX para generar la firma. Seguidamente, la firma resultante se codifica en formato Base64. Se incluye en el cuerpo del mensaje bajo el atributo "app\_signature".

## ¿Cómo y dónde lo configuro?

La configuración del Webhook la puedes realizar de manera autónoma desde el Dashboard de Developers. Realizando los siguientes pasos:

1. Navega a la sección de "Webhooks" y haz clic en el botón "New Webhook"

   ![webhook\_creation\_1.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-cd3b1fd48888dce5809488a39f529adfe5076453%2Fwebhook_creation_1.png?alt=media)
2. En el panel lateral que se abre, debes completar los campos:

   * URL del webhook (El URL que debes colocar es la dirección a la que la plataforma enviará las solicitudes HTTP POST cuando ocurra un evento)
   * Nombre de identificación del webhook
   * Source (refiere a las apps o usuarios que crean ordenes de pago): Por defecto, está seleccionado "all", lo que significa que recibirás datos de todas las fuentes. Si lo deseas, puedes modificar esta opción y elegir solo las fuentes específicas que prefieras.

   ![webhook\_creation\_2.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-5c79efa07879f76c0729588f2c62187e0e3aec12%2Fwebhook_creation_2.png?alt=media)

{% hint style="info" %}
Puedes crear múltiples webhooks y configurar distintas fuentes de datos para cada uno, asegurando que la información se envíe a la URL correspondiente.
{% endhint %}

3. Haz clic en el botón "Save".

Por último, verifica que los eventos provengan de MYMOID y no de un tercero, viendo en la respuesta del código, la correspondencia con el sign-key.

![webhook\_creation\_3.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-b2ac9091fdb0923d2d104a8e879a4a737c8457d3%2Fwebhook_creation_3.png?alt=media)


# Payment Gateway


# Payment Gateway: Funcionalidades y beneficios.

## ¿Qué es la aplicación Payment Gateway?

**Payment Gateway** es una de las aplicaciones dentro de MYMOID-Suite, que permite visualizar de manera centralizada y organizada todas las operaciones realizadas bajo una organización.

*Para tener acceso, el usuario debe tener creada previamente una cuenta (desde la aplicación* [*Accounts*](https://accounts.mymoid.com) *y ser parte de una organización (ya sea como owner o guest).*

## Funcionalidades

Ofrece los siguientes servicios:

* Visualizar el listado de todas las órdenes de pago y su detalle.
* Monitorear y administrar el ciclo de vida de cada orden de pago.
* Visualizar el listado de todas las transacciones y su detalle.
* Monitorear y administrar cada transacción.
* Realizar reembolsos.
* Realizar reembolso masivo (automatización).
* Creación y configuración de Payments Points (configuración de procesador -gateways- y método de pagos disponibles)
* Descargar informes actualizados.

## Beneficios

* **Visión global**: Proporciona una visión completa y en tiempo real de todas las operaciones y transacciones en un solo lugar, lo que facilita la comprensión de la situación actual de la empresa.
* **Toma de decisiones informadas**: Permite a los usuarios acceder a datos actualizados y relevantes de manera rápida y eficiente, lo que les ayuda a tomar decisiones más acertadas.
* **Ahorro de tiempo**: Reduce la necesidad de buscar información en múltiples sistemas o fuentes, lo que ahorra tiempo y permite una gestión más eficiente.
* **Mejora de la eficiencia operativa**: Facilita el seguimiento y la gestión de las operaciones, lo que puede llevar a una mayor eficiencia en los procesos empresariales.
* **Conciliación de cuentas**: Descarga de reportes necesarios para realizar correspondiente conciliaciones y asegurarse de que las transacciones registradas por la empresa coincidan con las registradas por el banco.

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Orden de pago: ciclo de vida

## ¿Qué es una orden de pago?

Una orden de pago es una entidad (acta/compromiso/documento) de pago electrónica/o que una organización emite para solicitar la transferencia de fondos desde una cuenta bancaria de un externo a su cuenta propia.

Está definida por las siguientes propiedades:

* ID (Payment\_order\_id)
* Shortcode
* Moneda (Currency)
* Importe (Amount)
* Referencia (Reference)
* Concepto (Concept)
* Estado (Status)
* Fecha de creación (Creation\_time)
* Fecha de expiración (Expiration\_time)

*Consulte nuestro* [*API-Reference*](https://developers.mymoid.com/api-reference#/operations/GetPaymentOrderByPaymentOrderId) *para ver en detalle de cada propiedad.*

{% hint style="info" %}
El `short_code` y el `payment_order_id` son propiedades únicas para identificar una orden de pago.
{% endhint %}

## ¿Cuál es el ciclo de vida de una orden de pago?

El ciclo de vida de una orden de pago consta de varias etapas: desde el momento en que se crea hasta su liquidación final.

Según la acción que se realice sobre ella, puede seguir diferentes caminos e irá cambiando de estado. Tener en cuenta que la orden de pago puede tener un estado único asociado. A continuación el detalle:

![payment\_order\_lifecycling\_1.svg](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-5543ba1b3718c11989bf1ce41ee1886ad215df37%2Fpayment_order_lifecycling_1.svg?alt=media)

| Acción                                                                                                            | Estado de la orden de pago |
| ----------------------------------------------------------------------------------------------------------------- | -------------------------- |
| La organización crea una orden de pago.                                                                           | Available                  |
| Usuario paga la orden de pago vía Formulario de pago.                                                             | Paid                       |
| La orden de pago, cumple su fecha de expiración, y se expira.                                                     | Expired                    |
| La organización cancela una orden de pago.                                                                        | Cancelled                  |
| La organización realiza un reembolso parcial sobre una orden de pago \[en estado pagada]                          | Partial Refunded           |
| La organización realiza un reembolso total sobre una orden de pago \[en estado pagada o parcialmente reembolsada] | Refunded                   |

Por otro lado, es importante saber que, en cada intento de pago se crea una transacción. Es por eso que decimos que, **una orden de pago puede tener asociada una o más de una transacción pero siempre mantendrá un estado único.**

### Ejemplo

Veamos el siguiente ejemplo:

![payment\_order\_lifecycling\_example.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-13eae1c6143db4104f0e51d7f496ceef2e3519d7%2Fpayment_order_lifecycling_example.png?alt=media)

<table><thead><tr><th width="176">Acción (paso a paso)</th><th width="141">Estado de la orden de pago</th><th>Transacciones asociadas</th></tr></thead><tbody><tr><td>La organización crea una orden de pago.</td><td>Available</td><td>-</td></tr><tr><td>Usuario paga la orden de pago vía Formulario de pago.</td><td>Paid</td><td>Payment</td></tr><tr><td>La organización realiza un reembolso total sobre una orden de pago pagada.</td><td>Refunded</td><td>Payment (anterior) + Refund</td></tr></tbody></table>

El resultado final de este ciclo de vida de la orden de pago será: orden de pago con estado “Refunded” y dos transacciones asociadas: una transacción de pago (Payment) y una transacción de reembolso (Refunded).

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Transacción y su relación con la orden de pago

Una transacción representa el intento de hacer una acción sobre una orden de pago.

Un intento de pago se puede dar en los siguientes casos:

**👉 Caso 1: El cliente introduce la tarjeta, realiza el proceso de 3DS y el pago se realiza correctamente.**

![what\_is\_trx\_1.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-ceb7ff15bd74d75cfe0bdd9dcfa8466d1a5fe48f%2Fwhat_is_trx_1.png?alt=media)

*Luego del intento de pago, la orden de pago queda en estado disponible (”Paid”) y se asocia una transacción de pago (”Payment”)*

**👉 Caso 2: El cliente introduce la tarjeta, realiza el proceso de 3DS y la tarjeta no tiene dinero.**

![what\_is\_trx\_2.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-9c78e76269e248f2d21497ec18f4174bd22d7a65%2Fwhat_is_trx_2.png?alt=media)

*Luego del intento de pago, la orden de pago queda en estado disponible (”available”) y se asocia una transacción de denegación (”Denial”)*

**👉 Caso 3: El cliente introduce la tarjeta, inicia el proceso de 3DS y cancela la acción por su cuenta antes de que se concrete el pago.**

![what\_is\_trx\_3.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-9c78e76269e248f2d21497ec18f4174bd22d7a65%2Fwhat_is_trx_3.png?alt=media)

*Luego del intento de pago, la orden de pago queda en estado disponible (”available”) y se asocia una transacción de denegación (”Denial”)*

**👉 Caso 4: La organización realiza un reembolso total o un reembolso parcial sobre una orden de pago pagada.**

![what\_is\_trx\_4.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-2565e09989d165c10f63533e4c885e6d8fb2a09b%2Fwhat_is_trx_4.png?alt=media)

*Luego del intento de pago, la orden de pago queda en estado disponible (”Refunded” o “Partial refunded”) y se asocia una transacción de denegación (”Refund”)*

### Algunas consideraciones:

* Una transacción está asociada a una única orden de pago. *Pero una orden de pago puede tener asociada más de una transacción (una por cada intento de pago).*

![what\_is\_trx\_5.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-13eae1c6143db4104f0e51d7f496ceef2e3519d7%2Fwhat_is_trx_5.png?alt=media)

* La transacción no tiene estados cambiantes, si no que está definida por tipos: de pago (”Payment”), de devolución (”Refund”) o de Denegación (”Denial”).

![what\_is\_trx\_6.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-896a3af8d03d06410fbea81f725f7f459cf12b30%2Fwhat_is_trx_6.png?alt=media)

* La transacción tiene asociada siempre un medio de pago.

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Creación de orden de pago

Para crear una orden de pago, puedes hacerlo de las siguientes maneras:

* [A través de la API](/por-producto/developers/que-es-el-api-reference) (te recomendamos usar nuestro [playground](https://developers.mymoid.com/api-reference#/operations/Create)).
* [Desde el producto Collection](/por-producto/collection/como-creo-una-orden-de-pago-individual).
* O, como explicaremos a continuación, desde el producto [PaymentGateway](https://paymentgateway.mymoid.com)

*Ten en cuenta* que, desde el producto PaymentGateway, podrás realizar la creación de la orden de pago y copiar el link para compartir. Si deseas funcionalidades avanzadas de creación de orden de pago y envío por distintos canales, realice este proceso en el producto [Collection](/por-producto/collection/como-creo-una-orden-de-pago-individual).

## ¿Cómo crear una orden de pago desde PaymentGateway?

1. Accede al producto [PaymentGateway](https://paymentgateway.mymoid.com) e inicia sesión en tu cuenta.

{% hint style="info" %}
Recuerda que para utilizar los servicios de MYMOID, debes [crear una cuenta](http://accounts.mymoid.com). ¡Es totalmente gratis!
{% endhint %}

![create\_PO\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-b68a7529be8cc84d818cc86f3167361491f6fdb4%2Fcreate_PO_1.png?alt=media)

2. Ve a la sección de "Payment Orders" y haz clic en el botón "Create Payment Order" para abrir el panel lateral.

![create\_PO\_2](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-669a0f91a1241f2b9d794b2800534b24eba101eb%2Fcreate_PO_2.png?alt=media)

*Ten en cuenta que, si tu organización ya tiene órdenes de pago creadas, el botón se encuentra en el margen superior derecho.*

3. Completa todos los campos requeridos de la orden de pago:

* Concepto (Concept)
* Referencia (Reference)
* Moneda y Monto (Currency & Amount)

Recuerda que los campos `Concept`, `Reference`, `Currency` & `Amount` son visibles para el usuario final y aparecerán en el Formulario de Pago de la siguiente manera:

![create\_PO\_3](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-25c20e2523c7a527b827ae61bfe25bb0d4a94922%2Fcreate_PO_3.png?alt=media)

4. \[Opcional] Fecha de expiración: indica hasta qué fecha y hora la orden de pago estará disponible para ser pagada. Por defecto, está configurada a 24 horas, pero puedes personalizarla eligiendo una fecha y hora posteriores a la fecha de creación y menores a 15 días.

![create\_PO\_4](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-65fcf0815855c275e7861c3177a0c74d0547b5fa%2Fcreate_PO_4.png?alt=media)

6. \[Opcional] Payment Points: configuración de los métodos de pago y el procesador. Por defecto, se selecciona el configurado previamente (puedes ver esta información en la sección de Payment Points). Si deseas elegir uno en particular, puedes hacerlo.

![create\_PO\_5](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-896fa29a8b707b5750b7b2f09eb96d0c098d9771%2Fcreate_PO_5.png?alt=media)

Haz clic en el botón "Create" y podrás visualizar la orden de pago (en estado disponible).

![create\_PO\_6](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-57fdfa9dcea0344221b550d82b62e4fc00650bba%2Fcreate_PO_6.png?alt=media)

6. Si lo deseas, puedes compartir el enlace de la orden de pago. Haz clic en el botón "Copy Link" y ¡listo!

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Detalle de orden de pago

## ¿Cómo visualizo el detalle de una orden de pago?

Para visualizar el detalle de una orden de pago desde la aplicación Payment Gateway es muy simple. Sigue los siguientes pasos:

1. Ingresa a la sección “Payment Orders” donde encontrarás el listado de todas las ordenes de pago (y su estado).

   ![view\_PO\_1.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-2c7427d718acc3f172f9f96dce37ae6c78f7e627%2Fview_PO_1.png?alt=media)
2. Si conoces algún parámetro de la orden de pago que quieres visualizar como el ID, su estado o la fecha de creación, [puedes aplicar filtros.](/por-producto/payment-gateway/como-filtro-el-listado-de-ordenes-de-pago)
3. Dentro del listado, haz clic en la fila de la orden de pago que quieres visualizar y se te abrirá un panel lateral con el detalle.

   ![view\_PO\_2.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-57fdfa9dcea0344221b550d82b62e4fc00650bba%2Fview_PO_2.png?alt=media)

## ¿Qué información puedo obtener?

Como se visualiza en la imagen, en el detalle podrás encontrar:

* Información general de la orden:
  * Concepto(”Concept”): Customizable por la organización, se utiliza como identificación.
  * Referencia(”Reference”): Customizable por la organización, se utiliza para identificar el producto/servicio que se quiere cobrar.
  * Importe(”Amount”): Customizable por la organización, valor por el cuál se ha creado la orden de pago.
  * Saldo disponible (serán diferente al importe si se ha realizado un reembolso total o parcial),
  * Estado(”Status”).
  * ID.
  * Fuente "Source": Quién creó la Orden. Puede ser el email de persona lo ha creado (si se creó por medio de la interfaz de nuestro producto) o el nombre de la APP (si se realizó directamente desde el API).
  * Shortcode: identificador que permite cruzar información con las transacciones asociadas y con el formulario de pago.
* Fechas relevantes:
  * De Creación(”Created date”).
  * De Expiración(”Expiration date”).
  * De actualización(”Last update date”): existe sólo si se ha realizado un intento de pago sobre la misma.
* El listado de transacciones asociadas: según [el ciclo de vida de la orden de pago.](/por-producto/payment-gateway/que-es-una-transaccion)

El detalle de una orden de pago, también se puede visualizar haciendo una [consulta al API](https://developers.mymoid.com/api-reference#/operations/GetPaymentOrderByPaymentOrderId).

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Medios de pago asociado a una orden de pago

**Para saber con qué medio de pago se ha pagado o intentado pagar una orden de pago, tendrás que identificar la transacción (de tipo “payment” o "denial") que tiene asociada esa orden de pago y visualizar su detalle.**

*Repasando el ciclo de vida de una orden de pago, cuando tiene estado disponible (status: “Available”) y se intenta realizar un pago sobre ella, se asocia una transacción. **Cada transacción es quién tiene un medio de pago asociado.** Es decir, para que exista un medio de pago, tiene que existir una transacción, y para que exista una transacción debe haber un intento de pago sobre una orden de pago.*

## Casos típicos:

👉 **Caso 1: La organización crea una orden de pago (status “available”), le comparte el formulario de pago a su cliente. El cliente completa los datos del medio del pago y se realiza el pago correctamente.**

![payment\_method\_case\_1.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-66fb655b46014f521d92663fdd90878475c66bc9%2Fpayment_method_case_1.png?alt=media)

*En esta situación, la orden de pago toma un estado “paid” y se le asocia una transacción de tipo “payment” (de pago) que tiene asociado un medio de pago (payment\_method).*

👉 **Caso 2: La organización crea una orden de pago (status “available”), le comparte el formulario de pago a su cliente. El cliente completa los datos del medio del pago y el pago no se realiza correctamente porque hay un error del sistema**

![payment\_method\_case\_2.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-f8783ad0940d2896181e289c7c9c6674ff2eef4c%2Fpayment_method_case_2.png?alt=media)

*En esta situación, la orden de pago siga en estado “available” pero se le asocia una transacción de tipo “denial” (denegación) que tiene asociado un medio de pago (payment\_method).*

👉 **Caso 3\[sin transacción asociada]: La organización crea una orden de pago (status “available”), le comparte el formulario de pago a su cliente. La orden de pago se expira antes que se realice cualquier intento de pago.**

![payment\_method\_case\_3.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-266f7e5ee66233bb0da356ccc7d13664e6d23f2a%2Fpayment_method_case_3.png?alt=media)

*En esta situación, la orden de pago pasa a estado “expired” y no tiene transacciones asociadas, por lo tanto no existe medio de pago.*

### Pasos para conocer el medio de pago de una transacción asociada a una orden de pago:

1. Del listado de ordenes de pago, copia el `shortcode` de la orden específica y pegalo en el buscador del listado de transacciones.

   ![payment\_method\_case\_4.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-c11c2a392f64c6ee96047c32e7a1e7e8708d5097%2Fpayment_method_case_4.png?alt=media)
2. Haz clic en la fila de la transacción (transacción asociada a ese shortcode) y podrás visualizar el detalle del medio de pago.

   ![payment\_method\_case\_5.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-461397c7329625b90bf10a010cba19fc5cc5e85f%2Fpayment_method_case_5.png?alt=media)

   ¡y listo!

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Filtrado de listado de órdenes de pago

Para poder identificar y seleccionar rápidamente las órdenes de pago que cumplen con ciertos criterios, y así, facilitar la localización de información relevante dentro de la lista extensa, contamos con **el buscador** y **los filtros.**

**Un listado de órdenes de pago se puede buscar por:**

* Shortcode
* Concepto (Concept)
* Referencia (Reference)

**Un listado de órdenes de pago se puede filtrar por:**

* Payment Points
* Fecha de inicio (start date)
* Fecha de fin (end date)
* Estado (Status)
* Importe: mayor que (amount: greater than)
* Importe: menor que (amount: less than)

## ¿Cómo filtro el listado de órdenes de pago?

Puedes buscar una orden específica escribiendo en el buscador “search” o puedes aplicar filtros.

### Por buscador

1. Haz clic en el buscador “search”

![search\_PO\_1.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-a89a2b41c49dcb8c4cd87ebd11cd2148bbe7b911%2Fsearch_PO_1.png?alt=media)

2. Escribe el `Concepto`, `Referencia` o `Shortcode` de la transacción que estás buscando. A medida que escribes, la lista se actualiza automáticamente.

Para lograr coincidencias efectivas, debes tener en cuenta los parámetros de búsqueda:

| Parámetro  | Cantidad de caracteres    |
| ---------- | ------------------------- |
| Concepto   | por lo menos 3 caracteres |
| Referencia | por lo menos 3 caracteres |
| Shortcode  | por lo menos 3 caracteres |

![search\_PO\_2.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-588e4a3e2ca7b60798a31c00922802838905d264%2Fsearch_PO_2.png?alt=media)

### Por filtros

1. Haz clic en “filters” en la barra de herramientas del listado y, se abrirá el panel de filtros:

![filter\_PO\_1.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-3814fd1e355044588f592f196734e32af77cf8d8%2Ffilter_PO_1.png?alt=media)

2. Aplica los filtros necesarios. A medida que seleccionas los filtros, la lista se actualiza automáticamente. ¡y listo!

![filter\_PO\_2.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-b432ea1535f4def9f84e642ea4a9a4e502143e54%2Ffilter_PO_2.png?alt=media)

### Plus:

* Si quieres **restablecer todos los filtros** seleccionados, haz clic en el botón “reset” que se encuentra a la derecha del panel de filtros.

  ![filter\_PO\_3.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-7c781d8d26afde4a515c1fb160a5738c8c04bb5a%2Ffilter_PO_3.png?alt=media)
* Si quieres **cerrar el panel de filtros**, haz clic en el botón “filters” o en el botón “close” que se encuentra a la derecha del panel de filtros. *Los filtros no serán eliminados, solo se oculta el panel.*

  ![filter\_PO\_4.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-13ec47bfffce26f4086ec006429b18d125c9d646%2Ffilter_PO_4.png?alt=media)

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Exportación de listado de órdenes de pago

## ¿Qué información obtengo al exportar un listado de órdenes de pago?

Exportar el listado de órdenes de pago es muy simple e intuitivo. Al final del proceso de exportación, obtendrás un reporte en formato .CSV con el listado de órdenes de pago que hayas filtrado. Este reporte contiene la siguiente información de cada orden de pago:

* Last update (Fecha de última actualización)
* Payment Order Id (ID de a orden de pago)
* Creation Date (Fecha de creación)
* Shortcode
* Concept (Concepto)
* Reference (Referencia)
* Amount (Importe)
* Currency (Moneda)
* Status (Estado)

El formato .CSV es ampliamente compatible y puede ser importado e integrado fácilmente en la mayoría de las herramientas de análisis de datos. Esto permite a los analistas de datos trabajar, manipular, cruzar los datos de manera eficiente.

## ¿Cómo exporto el listado de transacciones?

1. Localiza el botón de “export” en la barra de herramientas del listado. Si no has aplicado ningún filtro previo, seguramente el botón de “export” aparece desactivado, esto es porque el rango de exportación debe ser igual o inferior a un año.

![export\_PO\_1.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-ffaa550a907c77f2155ed9a32b6ef7c609a70f5d%2Fexport_PO_1.png?alt=media)

2. Haz clic en el botón de “Filters”

![export\_PO\_2.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-2e663f1756a20174d588942387e7ee43444b69d9%2Fexport_PO_2.png?alt=media)

3. Selecciona un rango (start date - end date) igual o menor a un año y automáticamente el botón de “Export” se habilitará. *Puedes seleccionar más filtros si deseas.*

Seguidamente, haz clic en el botón de “Export”.

![export\_PO\_3.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-b7ee1a5ffa59840c6cf475c0b157a9f6cdb778a0%2Fexport_PO_3.png?alt=media)

4. Seguidamente que el reporte se genere, haz clic sobre en “Download” ¡y listo! ya lo tienes en tu ordenador.

![export\_PO\_4.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-50b73e288115ab2e1e91d36af3b9aba1f692c34b%2Fexport_PO_4.png?alt=media)

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Cancelación de orden de pago

Si, es posible cancelar una orden de pago en estado “available” pero no desde la aplicación Payment Gateway. Para lograrlo, [debes enviarle una petición al API.](https://developers.mymoid.com/api-reference#/operations/Cancel)

*Una vez cancelada, podrás validar desde la aplicación Payment Gateway que la orden de pago toma de estado “Cancelled”.*

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Transacciones asociadas a una orden de pago

Para visualizar las transacciones asociadas a una orden de pago desde la aplicación Payment Gateway es muy simple. Sigue los siguientes pasos:

**OPCIÓN 1: Solo visualizar el listado de transacciones a una orden de pago**

1. Ingresa a la sección “Payment Orders” donde encontrarás el listado de todas las ordenes de pago (y su estado).

   ![trx\_details\_1.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-7710a7628bd81a0a8963cae772126c0cb047da23%2Ftrx_details_1.png?alt=media)
2. Si conoces algún propiedad de la orden de pago que quieres visualizar (como el ID, su estado o la fecha de creación) [puedes aplicar filtros.](/por-producto/payment-gateway/como-filtro-el-listado-de-ordenes-de-pago)
3. Dentro del listado, haz clic en la fila de la orden de pago que quieres visualizar y se te abrirá un panel lateral con el detalle. Al final encontrarás el listado de transacciones asociadas (solo puedes visualizar)

   ![trx\_details\_2.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-0bd9b629281bf2a7c33b117a1efeafeabfc3087b%2Ftrx_details_2.png?alt=media)

**OPCIÓN 2: Visualizar el listado de transacciones a una orden de pago y conocer el detalle de una transacción.**

1. Del listado de ordenes de pago, copia el `shortcode` de la orden específica y págalo en el buscador del listado de transacciones. Si la orden de pago tiene más de una transacción asociada, aparecerá más de un resultado.

   ![trx\_details\_3.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-c11c2a392f64c6ee96047c32e7a1e7e8708d5097%2Ftrx_details_3.png?alt=media)

   *También puedes realizar la búsqueda por el `transaction ID`, propiedad que se encuentra en el detalle de una orden de pago, en la sección de “transactions associated”*
2. Para visualizar el detalle de la transacción, haz clic en la fila de la transacción específica y un panel lateral se te abrirá con todo el detalle.

   ![trx\_details\_4.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-66363b2573a635909204110ee51ba15bb2bdcccb%2Ftrx_details_4.png?alt=media)

   ¡y listo! Ahora ya sabes cómo visualizar las transacciones asociadas a una orden de pago.

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Detalle de una transacción

## ¿Cómo visualizo el detalle de una transacción?

Para visualizar el detalle de una transacción desde la aplicación Payment Gateway es muy simple. Sigue los siguientes pasos:

1. Ingresa a la sección “Transaction" donde encontrarás el listado de todas las transacciones (con sus parámetros).

   ![trx\_view\_details\_1.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-9a49ce17abe596c2ac4f6c51a8dcef051ca8416a%2Ftrx_view_details_1.png?alt=media)
2. Si conoces algún parámetro de la transacción como el ID, su tipo o la fecha de creación, [puedes aplicar filtros.](/por-producto/payment-gateway/como-filtro-el-listado-de-transacciones)
3. Dentro del listado, haz clic en la fila de la transacción que quieres visualizar y se te abrirá un panel lateral con el detalle.

   ![trx\_view\_details\_2.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-8f842dc4d8ea1c0814c9d972d8987338b8328f13%2Ftrx_view_details_2.png?alt=media)

   ![trx\_view\_details\_3.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-6b6d36eb5ffe5377072d95f1214a1ef87a25f27a%2Ftrx_view_details_3.png?alt=media)

## ¿Qué información puedo obtener?

Como se visualiza en la imagen anterior, en el detalle podrás encontrar:

* Información general y característica de la transacción:
  * Importe ("amount")
  * ID (identificador de la transacción)
  * Tipo ("type"): puede ser de pago "Payment", de devolución "Refund" o de Denegación "Denial".
  * ID de Orden de compra ("Purchase order")
  * Fecha de creación ("created date")
* Información sobre el medio de pago con que se pagó/reembolsó la orden de pago.
* Información del Procesador del pago ("Payment Processor"): nombre del procesador y TPV configurado.
* Información del Payment Point ("Payment Point"): configuración de la organización en relación al TPV.
* Información sobre la Conciliación ("Conciliation"): datos obtenidos y transversales a los del adquirente.
* Detalles de la orden de pago ("Payment Order"), de donde nace la transacción.

{% hint style="info" %}
Recuerda: una orden de pago puede tener N transacciones asociadas, pero una transacción depende de una (y solo una) orden de pago.
{% endhint %}

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Exportación de listado de transacción

## ¿Qué información obtengo al exportar un listado de transacciones?

Exportar el listado de transacciones es muy simple e intuitivo. Al final del proceso de exportación, obtendrás un reporte en formato .CSV con el listado de órdenes y sus atributos:

* Fecha de pago (Payment Date)
* ID de transacción (Transaction ID)
* Código de Orden de pago (Payment Order Code)
* Tipo de transacción (Type)
* Importe (Amount)
* Orden de compra (Purchase Order)
* Moneda (Currency)
* Número de tarjeta (Card Number)
* Titular de tarjeta (Holder Name)
* Fecha de expiración de tarjeta (Expiration)
* Código de conciliación (Conciliation id)
* Nombre del procesador (Processor name)
* Referencia (Reference)

El formato .CSV es ampliamente compatible y puede ser importado e integrado fácilmente en la mayoría de las herramientas de análisis de datos. Esto permite a los analistas de datos trabajar, manipular, cruzar los datos de manera eficiente.

## ¿Cómo exporto el listado de transacciones?

1. Localiza el botón de “export” en la barra de herramientas del listado. Si no has aplicado ningún filtro previo, seguramente el botón de “export” aparece desactivado, esto es porque el rango de exportación debe ser igual o inferior a un año.

![export\_trx\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-04eaead6ad13d04455205cac6ae3ac0d7f9a2967%2Fexport_trx_1.png?alt=media)

2. Haz clic en el botón de “Filters” y el panel de filtros se abrirá.

![export\_trx\_2](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-b56e1ae1359e8f176b1c9581a090b26d7d8d2fb6%2Fexport_trx_2.png?alt=media)

3. Selecciona un rango (start date - end date) igual o menor a un año y automáticamente el botón de “Export” se habilitará. *Puedes seleccionar más filtros si deseas.*

Seguidamente, haz clic en el botón de “Export”.

![export\_trx\_3](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-b36cdb1998bfe8f008b748abef40c495640b3b2d%2Fexport_trx_3.png?alt=media)

4. Seguidamente que el reporte se genere, haz clic sobre en “Download” ¡y listo! ya lo tienes en tu ordenador.

![export\_trx\_4](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-92349bd0d2b3fbf41a5a3c9ac592bc25c47f8ef7%2Fexport_trx_4.png?alt=media)

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Filtrado de listado de transacciones

Para poder identificar y seleccionar rápidamente las transacciones que cumplen con ciertos criterios de búsqueda, y así, facilitar la localización de información relevante dentro de la lista extensa, contamos con **el buscador** y **filtros.**

**Un listado de transacciones se puede buscar por:**

* Transaction ID
* Purchase Order
* Shortcode

**Un listado de ordenes de pago se puede filtrar por:**

* Payment Points
* Fecha de inicio (start date)
* Fecha de fin (end date)
* Tipo (Type)
* Importe: mayor que (Amount: greater than)
* Importe: menor que (Amount: less than)
* Medio de pago (Payment Method) y si es tarjeta (“card”):
  * Tipo de tarjeta (Card type)
  * Marca (Card brand)
  * Primeros 6 dígitos del PAN de la tarjeta
  * Últimos 4 dígitos del PAN de la tarjeta

## ¿Cómo filtro el listado de transacciones?

Puedes buscar una transacción específica escribiendo en el buscador “search” o puedes aplicar filtros.

### Por buscador

1. Haz clic en el buscador “search”.

![search\_trx\_1.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-29bdf4dcd18f47d91c7fdf571830cac603da4382%2Fsearch_trx_1.png?alt=media)

2. Escribe el `Transaction ID`, `Purchase Order` o `Shortcode` de la transacción que estás buscando. *A medida que escribes, la lista se actualiza automáticamente.*

Para lograr coincidencias efectivas, debes tener en cuenta los parámetros de búsqueda:

| parámetro       | cantidad de caracteres    |
| --------------- | ------------------------- |
| Transaction\_id | totalidad de caracteres   |
| Purchase order  | por lo menos 3 caracteres |
| Shortcode       | por lo menos 3 caracteres |

![search\_trx\_2.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-ec451f61d502a832ad7816404ea6808959aa32f9%2Fsearch_trx_2.png?alt=media)

¡y listo!

### Por filtros

1. Haz clic en “filters” en la barra de herramientas del listado y, se abrirá el panel de filtros:

![filter\_trx\_1.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-7e84604b2476254c0d1093bd934fc8a800254739%2Ffilter_trx_1.png?alt=media)

2. Aplica los filtros necesarios. A medida que seleccionas los filtros, la lista se actualiza automáticamente. Recuerda que, al filtrar por tipo de medio de pago de tarjeta, aparecerán subfiltros relacionados a ese medio de pago.

![filter\_trx\_2.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-2b0c1629ca60e44749c8a21fc7a93712e31e427a%2Ffilter_trx_2.png?alt=media)

¡y listo!

### Plus:

* Si quieres **restablecer todos los filtros** seleccionados, haz clic en el botón “reset” que se encuentra a la derecha del panel de filtros.

  ![filter\_trx\_3.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-699891df842a1bb5a6a39fbc807d3e03658d7097%2Ffilter_trx_3.png?alt=media)
* Si quieres **cerrar el panel de filtros**, haz clic en el botón “filters” o en el botón “close” que se encuentra a la derecha del panel de filtros. *Los filtros no serán eliminados, solo se oculta el panel.*

  ![filter\_trx\_4.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-a025f8f9559dd5554415a045c2f991a8e82ab7ed%2Ffilter_trx_4.png?alt=media)

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Devolución de una orden de pago

Para realizar una devolución parcial o total de una orden de pago en estado “paid” o "partial refund" es muy fácil, solo sigue las siguientes instrucciones:

1. Desde el listado de Ordenes de pago (Payment Order list), haz clic sobre la orden de pago que quieres devolver.

   ![refund\_po\_1.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-172e71395368542771e702b8f25854e029d41d45%2Frefund_po_1.png?alt=media)
2. En el detalle de la orden de pago, haz clic sobre el botón “Refund”.

   ![refund\_po\_2.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-c8a3baea5648150a4876867cc90912bd8b5b9c45%2Frefund_po_2.png?alt=media)
3. Se abrirá un modal que, por defecto, toma el valor total de la orden de pago. En caso de querer realizar una devolución parcial, modifica el monto al deseado.

   ![refund\_po\_3.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-31419ff770ae1a917046ea9d2ed5e93049861f9e%2Frefund_po_3.png?alt=media)
4. Confirma el monto a devolver escribiendo el texto REFUND y haz clic en el botón "Refund":

   ![refund\_po\_4.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-51196b7b69f5cea7f53ae8ae6df233e782f0abb2%2Frefund_po_4.png?alt=media)

¡y listo! la devolución ha sido realizada.

## Mi cliente no ha recibido el pago ¿Qué ha pasado?

{% hint style="info" %}
Recuerda que la devolución no es instantánea y el tiempo en verlo reflejado en la cuenta del destinatario depende 100% del banco emisor.
{% endhint %}

Sin embargo, puedes validar que la devolución se haya hecho efectiva al final del detalle de la orden de pago, en la sección de “transactions associated” deberá de existir una transacción de devolución “Refund”:

![refund\_po\_5.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-0dd367297bef66eccef5d63eea9f1104de74f342%2Frefund_po_5.png?alt=media)

o, ingresar a la sección principal de “Transactions” y visualizar la existencia de la transacción de devolución "Refund":

![refund\_po\_6.png](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-66916f8a6a35defb82ba13d4d54dda0804bcc46a%2Frefund_po_6.png?alt=media)

{% hint style="info" %}
Ten en cuenta que se puede realizar una devolución de una orden de pago dentro del año de la fecha de pago de la misma. Pasado el año, no se podrá devolver.
{% endhint %}

{% hint style="info" %}
Ten en cuenta que, si has realizado una devolución parcial, podrás seguir haciendo devolución del monto disponible.
{% endhint %}

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# API KEYs¿Donde se encuentran?

Las API KEY se encuentran dentro de la aplicación [Developers - Parte privada](https://developers.mymoid.com/dashboard/organizations). **Para poder navegar desde Payment Gateway a Developers** puedes seguir dos caminos:

1. Ingresa a la sección de "Integrations" y haz clic en el link de "go to Developers Portal". Si posees permisos, podrás visualizar el listado de APPs y en el detalle de cada una de ellas, tu API KEY.

![integration\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-f0f6b9383ec3bfb2fae4be1deaaec90c33736c17%2Fintegration_1.png?alt=media)

2. Desde el menu de productos ubicado en la barra superior al lado del avatar, puedes navegar al producto Developers.

![integration\_2](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-bfd111078db85047a2ef757aee7446fbaf528970%2Fintegration_2.png?alt=media)

{% hint style="info" %}
Recuerda que solo puedes acceder a los datos de la organización si eres propietario o cuentas con permiso de acceso otorgado.
{% endhint %}

{% hint style="info" %}
Recuerda que la API KEY es un dato sensible y no debe ser compartido con terceros.
{% endhint %}

\---

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Devolución en lote de órdenes de pago

## ¿Qué es un reembolso en lote? ¿Cómo la realizo?

Reembolso en lote ("Bulk Refunds"), es una funcionalidad que permite realizar reembolsos de una o más ordenes de pago a partir del ID de conciliación del banco adquirente en la transacción de pago asociada. ¿Qué refiere esto?

Repasando [el ciclo de vida de una orden de pago](/por-producto/payment-gateway/que-es-una-orden-de-pago), puede existir N transacciones asociadas a una misma orden de pago. En el caso que, una orden de pago en estado disponible ("available") se paga exitosamente, la misma pasa a estado pagada ("paid") y se le asocia una transacción de pago ("payment"). Esta transacción de pago tiene asociado un ID de Conciliación (`conciliation_id`), es decir, un identificador único que representa la sincronización entre las cuentas bancarias entre el usuario y la organización.*Es un dato proveniente del banco adquirente.*

![ciclo\_de\_vida\_ids](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-4962070990cbef21b4b413fe45f73ba073e8f720%2Fciclo_de_vida_ids.png?alt=media)

Con el listado de IDs de conciliación obtenido del banco adquirente, MYMOID puede identificar a qué orden de pago pertenece, y realizar el reembolso de una o más ordenes de pago que necesites. ¡Simple y en muy pocos pasos!

### ¿Por que utilizar el listado de IDs de Conciliación como fuente?

**MYMOID se esfuerza por ayudar a reducir los chargebacks, evitando cargos adicionales por solicitudes de reembolso de parte de los clientes finales.** En muchas ocasiones, los bancos adquirentes envían a las organizaciones un listado que contiene identificadores de transacciones sujetas a devolución. Las organizaciones, a su vez, deben procesar manualmente cada una de estas devoluciones antes de la fecha límite establecida.

Dentro de la lista de transacciones sujetas a chargebacks proporcionada por el adquirente, uno de los campos cruciales es el `Request ID`.

El `Request ID` es equivalente al ID de conciliación (`Conciliation_ID`), es decir, un identificador único que refleja la conciliación entre las cuentas bancarias del usuario y la organización.

Al recopilar todos los ID de conciliación y generar un archivo .CSV, los comerciantes tienen la capacidad de llevar a cabo el reembolso de todas las transacciones con chargebacks con tan solo un click. Esta eficiente práctica simplifica el proceso de manejo de chargebacks, mejorando la eficacia y reduciendo posibles complicaciones asociadas con las devoluciones.

*Por el momento, solo se puede hacer reembolso en lote a partir del listado de ID de conciliación referido a la transacción de pago asociado a la cuenta.*

## ¿Cómo realizo un reembolso en lote?

Inicia sesión en la aplicación [Payment Gateway](https://paymentgateway.mymoid.com/dashboard) y sigue los siguientes pasos.

*Recuerda que solo tendrán acceso los usuarios con perfil owner o aquellos que se te ha otorgado el acceso a esa aplicación bajo una organización. En caso que no puedas acceder, pide acceso al owner de tu organización.*

Navega a la sección de Automatizaciones / "Automations" donde encontrarás la tarjeta de "Bulk Refunds". Haz clic en el botón "start".

![Automations](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-b770d9ab2c5ba1db9e87f2eded2f3b8c7aa3f067%2FAutomations.png?alt=media)

**1. \[source] carga el archivo .CSV con el listado de ID Conciliación en una sola columna. Puedes seguir el formato del ejemplo proporcionado haciendo clic en "*****we have a sample code for you*****".**

![Bulk\_refunds\_source\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-c5f4e5af71bd709836dd35e73b4ee87ca00b68dd%2FBulk_refunds_source_1.png?alt=media)

![Bulk\_refunds\_source\_2](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-6ee3d87669b426205950180e84bc019868c876b0%2FBulk_refunds_source_2.png?alt=media)

Al cargarlo correctamente, podrás validar la cantidad de entradas que se están detectando.

![Bulk\_refunds\_source\_3](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-22b4a82539692412f3db53ce11e460868ffe1361%2FBulk_refunds_source_3.png?alt=media)

¿Qué indica el "Summary"?

La cantidad de entradas ("entries") solo hace referencia a la cantidad de celdas con datos pero no valida qué tipo de datos se incluyen. Es decir, si existen celdas con datos duplicados o celdas con ids inexistentes, se contarán igual como parte del resultado ("Summary"). No obstante, en el siguiente paso se realiza la validación pertinente a la relación de ids-transacción.

**2. \[preview & refund] Haz clic en el botón "next" y podrás previsualizar todas las transacciones asociadas a los ID de conciliación encontrados.**

![Bulk\_refunds\_preview\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-6741fccdeab0a4645ed5833657f07a4101788f88%2FBulk_refunds_preview_1.png?alt=media)

{% hint style="info" %}
Consideraciones sobre validación de IDs:

* Solo se muestran datos asociados a ID de conciliación existentes.
* Para aquellos IDs duplicados se mostrarán la información una sola vez.
* Para aquellos casos que no se identifique una transacción asociada a ese ID, no se mostrará en el listado.
  {% endhint %}

{% hint style="info" %}
El campo "amount" puede ser un valor distinto al disponible para reembolsar: ya que para aquellas ordenes de pago que tienen un estado de "partially refund", el campo importe ("amount") toma el valor del importe inicial por la cuál fue creada la orden de pago y no el importe disponible (inicial - ya reembolsado parcialmente).
{% endhint %}

Una vez que validada la información, haz clic en el botón "Refund" y confirma la acción completando en el input del modal con la palabra "REFUND". Al confirmar, comienza el proceso automático de reembolso de cada una de las ordenes de pago.

![Bulk\_refunds\_preview\_2](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-1e5577c493c21c84f977515973c1dfa66301268b%2FBulk_refunds_preview_2.png?alt=media)

**3. \[results] Una vez terminado el proceso, podrás visualizar el resultado.** En la última columna de la tabla se muestra el resultado:

* En verde y con un check aquellas ordenes de pago que se han reembolsado y completado correctamente.
* En rojo con una cruz, aquellas que no han podido ser reembolsadas correctamente. En este caso, existe un error.

![Bulk\_refunds\_results\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-e7890fc9b29d263da1f541a9f13c685a29548789%2FBulk_refunds_results_1.png?alt=media)

![Bulk\_refunds\_error](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-4cd50649cd09ea234133d7ac8055e668df915574%2FBulk_refunds_error.png?alt=media)

Recomendamos que antes de cerrar el proceso de automatización, descarga los resultados en formato .CSV como fuente evidencia del proceso.

![Bulk\_refunds\_results\_2](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-601299a51b16e6ec013b897e482897891f0fa035%2FBulk_refunds_results_2.png?alt=media)

**\[Otra validaciones]** Para confirmar que las ordenes de pago han sido reembolsadas correctamente, navega a la sección del listado de "Payment Orders" y valida que su estado es "refunded". Puedes hacer una búsqueda por el `shortcode`. Adicionalmente, al hacer clic en ella puedes visualizar su detalle, donde podrás ver la transacción de "refunded" asociada.

![Payments\_refunded](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-66073eb1aaf8f3aca600eac00a4dab15178d495b%2FPayments_refunded.png?alt=media)

### Consideraciones:

**1. Sin coincidencias de IDs cargados**

Puede suceder que, al cargar el archivo .CSV, el apartado de "Summary" muestre N cantidad de entradas (entries) del archivo adjunto pero, al previsualizar el listado de pagos, no arroja coincidencias. Esto puede suceder porque los datos del archivo adjunto no coinciden con IDs existentes. ¿Qué puedo hacer? Revisa nuevamente el archivo cargado o vuelve a cargarlo.

![notfound](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-39ccc93cb5758441ea5eb472363e0b579f14a1a9%2Fnotfound.png?alt=media)

**2. La cantidad de entradas del archivo (paso 1 Source) no coincide con la cantidad de Pagos del listado de pagos (paso 2 Preview\&Refund)**

Puede suceder que, al cargar el archivo .CSV, el apartado de "Summary" muestre N cantidad de entradas (entries) del archivo adjunto pero, al previsualizar el listado de pagos, muestre Y (distinto a X) cantidad de pagos. Esto puede suceder porque en el archivo adjunto existe IDs inexistentes o una duplicación de los mismos. ¿Qué puedo hacer? Revisa nuevamente el archivo cargado o vuelve a cargarlo.

![duplicated](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-16030bcd2c155b9ce16e45571ad2893da918a1ed%2Fduplicated.png?alt=media)

**3. El importe de un pago no coincide con el disponible para pagar**

Puede suceder que, en el listado de pagos, existan importes de ordenes de pago diferentes al disponible para reembolsar. Esto es porque en el listado de pagos se muestra el importe inicial de la orden de pago. En el caso que una orden de pago haya sufrido un importe parcial, no se ve reflejado aquí aunque el reembolso será por el monto disponible para reembolsar. Vamos a un ejemplo: se crea una orden de pago con un importe de 50. Se paga esa orden de pago. Se realiza un reembolso de 20 (quedando 30 disponible). En el listado de pagos se seguirá viendo el importe de 50, aunque al hacer el reembolso se reembolsará los 30 disponibles.

![notmatches](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-0e172e544a5dac69f8da6f6ff26f9dddf54db443%2Fnotmatches.png?alt=media)

**4. Error al procesar el reembolso**

Puede suceder que, al procesar el reembolso, existan ciertas ordenes de pago que no han podido completarse correctamente el reembolso. Esto se indica con una X en rojo en la última columna del listado. Esto ocurre porque se intentó realizar un reembolso sobre una orden de pago que ya estaba totalmente reembolsada y no tenia saldo disponible a reembolsar o porque el medio de pago asociado no admite reembolsos. ¿Qué puedo hacer? con el shortcode de la orden de pago, revisa el detalle desde la sección de órdenes de pago, y valida si alguna de estos motivos es correcto. Si no contacta con soporte.

![Bulk\_refunds\_error](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-4cd50649cd09ea234133d7ac8055e668df915574%2FBulk_refunds_error.png?alt=media)

***

#### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Payment Point: ¿Qué es y cómo lo configuro?

Un [Payment Point](/general/general/que-es-un-pp) es un punto de venta, es decir, es el encargado de ejecutar el pago. Según cómo viene configurado, es quién, a la hora de realizar un intento de pago, decide por cuál gateway se ejecutará dicho pago y, a su vez, cuál será el nivel de seguridad empleado en el mismo (3DS, No 3DS, MoTo, etc.)

{% hint style="info" %}
Una organización que ya tiene activo su entorno de producción, podrás configurar N cantidad de payments points como desees. La posibilidad de configurar distintos payment points dependerá del contrato con el adquirente y del procesador.

Para organizaciones unicamente con entorno Sandbox, la configuración viene preestablecida por MYMOID asignandole a cada organización un payment point por defecto con tarjeta como medio de pago 3DS-Secure.
{% endhint %}

## Pasos para configurar un nuevo Payment Point:

1. Accede a la sección de Payments Point dentro del dashboard de Payment Gateway:

![PaymentPoint\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-48b45ad03d06a1f37ebe952ceba6096fb79c6cf3%2FPaymentPoint_1.png?alt=media)

2. Haz clic en el botón "Create Payment Point" y un panel se abrirá para comenzar a rellenar los campos. Escribe el nombre de identificación (atributo que podrás modificar posteriormente):

![PaymentPoint\_2](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-376a77375d1fd7d78d61684b53bcd2e77103f79a%2FPaymentPoint_2.png?alt=media)

![PaymentPoint\_3](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-3f257124b348efb1f10259b25d17df73919532a7%2FPaymentPoint_3.png?alt=media)

3. Activa y configura el medio de pago que aparecerán disponibles como forma de pago en el formulario de pago. *(Solo podrás configurar aquellos que tienes dados de alta. Si necesitas ayuda, contacta con* [*nuestro equipo de soporte*](mailto:info@mymoid.com)*)*

### 3.1 Configurar Tarjeta como medio de pago:

Haz switch en la sección "Card" y se abrirá la caja:

![PaymentPoint\_4](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-de2bbc58b746bb789f07cb30e675283c2bb79fcb%2FPaymentPoint_4.png?alt=media)

Selecciona el Procesador de pagos según el listado disponible:

![PaymentPoint\_5](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-f1e81af13ad93ac4c19ca86b0924f5a15edaf9f2%2FPaymentPoint_5.png?alt=media)

Según el procesador seleccionado, debes elegir la terminal (TPV):

![PaymentPoint\_6](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-c432e68fe9fe1473f9cf9f85e19d53514fd54079%2FPaymentPoint_6.png?alt=media)

¿Deseas que el procesamiento de pago sea seguro (3DS) imponiendo la utilización de Autenticación Reforzada de Clientes en el momento del pago?

* En caso afirmativo, selecciona "yes".

![PaymentPoint\_7](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-70c7269c4e91c54337c1458d5036ed61b09817e5%2FPaymentPoint_7.png?alt=media)

{% hint style="warning" %}
Ten en cuenta: En el caso que el procesador de pagos no sea compatible con 3DS Secure pero quieres hacerlo, el proceso 3DS será manejado por MYMOID y se te avisará. *Esto puede generar costos adicionales. Si tienes alguna consulta, comunícate con el soporte.*
{% endhint %}

* En caso que no quieras realizar pago seguro, es decir, sin utilización de autenticación reforzada en el momento del pago, selecciona el radiobutton "No". Y elige el tipo de excepción (si lo requieres):

![PaymentPoint\_8](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-ae15a48ed28d0d66fc564dbcf3fe5f5438ee9ee4%2FPaymentPoint_8.png?alt=media)

![PaymentPoint\_9](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-c6e76499004f417e43d8de11e8a655596f49af8f%2FPaymentPoint_9.png?alt=media)

{% hint style="info" %}
Para los clientes de la Unión Europea, el uso de Autenticación Reforzada de Clientes (SCA) es obligatorio para que PSD2 autentique al usuario antes de autorizar la transacción. Nota: El incumplimiento impone la responsabilidad a la organización.
{% endhint %}

Una vez terminada la configuración, haz clic en el botón "save" y podrás visualizar el detalle del Payment Point creado:

¡y listo! Recuerda que puedes crear cuantos Payment Points desees y pueden tener configurado como medio de pago Tarjeta.

***

Puedes seleccionar este Payment Point como defecto o editar la configuración realizada cuando desees. Revisa el artículo: ["¿Cómo edito un Payment Point?"](/por-producto/payment-gateway/modificacion-de-pp)

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Visualización de Payment Points

Para visualizar el listado de Payment Points creados, debes de ingresar al producto Payment Gateway. Una vez accedido al dashboard, es tan simple como hacer clic en la sección "Payments Points" del menu lateral y se abrirá el listado de payments points:

![viewPP\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-7bc56871c2a1b331457c607d58a44c03f38d219a%2FviewPP_1.png?alt=media)

En el listado, podrás acceder a información básica de configuración del mismo (fecha de última actualización, nombre del payment point y medios de pago asociados). En caso de querer editar o visualizar el detalle de un payment point específico, debes hacer clic sobre la fila y se abrirá el panel con toda la información:

![viewPP\_2](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-ab15f3c9e222fa2a66c0954b8110c1e583e9cd8e%2FviewPP_2.png?alt=media)

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Configuración de Payment Point por defecto

Un [Payment Point](/general/general/que-es-un-pp) es un punto de venta encargado de ejecutar los pagos. Según su configuración, determina el gateway a utilizar y el nivel de seguridad aplicado al proceso de pago (3DS, No 3DS, MoTo, entre otros).

{% hint style="info" %}
Una organización con su entorno de producción activo puede configurar múltiples Payment Points según lo permitido por el contrato con el adquirente y el procesador. En el caso de organizaciones con entorno Sandbox, MYMOID asigna automáticamente un Payment Point por defecto a cada una, configurado para pagos con tarjeta mediante 3DS-Secure.
{% endhint %}

Al crear una orden de pago, es necesario asociar un Payment Point. ¿Qué sucede si no se especifica uno? El sistema recurre al **Payment Point por defecto**. Este Payment Point, en ausencia de especificación, ejecutará el pago por defecto.

## ¿Cómo configuro un Payment Point por defecto?

1. En el listado de Payment Points, el Payment Point por defecto se identifica por una estrella azul junto a su nombre, como se muestra a continuación:

![PaymentPoint\_11](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-86072d4262aa2e01dc6bab00e3d363a1354d595c%2FPaymentPoint_11.png?alt=media)

2. Debe existir un único Payment Point por defecto. Para cambiarlo, selecciona el Payment Point deseado en el listado y haz clic en su fila correspondiente para abrir el panel de detalles:

![PaymentPoint\_12](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-57aa379db3ad031538e633fcfe53155064d9acaa%2FPaymentPoint_12.png?alt=media)

3. Marque la casilla "Payment Point by default":

![PaymentPoint\_13](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-e1e0cf8401d4a930560176ca4c1f6ec268a6cb0b%2FPaymentPoint_13.png?alt=media)

4. Al guardar los cambios, este Payment Point se establecerá automáticamente como el nuevo Payment Point por defecto, reemplazando al anterior. Este cambio será reflejado en el listado de Payment Points.

![PaymentPoint\_14](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-6fdf615ab48a809ba3b403ace0ee16049e8eba61%2FPaymentPoint_14.png?alt=media)

¡y listo!

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte


# Modificación de la configuración de Payment Point

Para modificar un Payment Point ya existente, sigue los siguientes pasos:

1. Dentro del proyecto Payment Gateway, selecciona la sección de "Payment Points"

![PaymentPoint\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-48b45ad03d06a1f37ebe952ceba6096fb79c6cf3%2FPaymentPoint_1.png?alt=media)

2. Del listado de Payment Points, haz clic sobre la fila del que deseas modificar su configuración y se abrirá el panel con el detalle.

![PaymentPoint\_10](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-1985515cc92070e4c03bc99e6684ae66f6408227%2FPaymentPoint_10.png?alt=media)

3. Realiza la modificación que deseas realizar: Puedes modificar datos identificatorios (como nombre o establecerlo como Payment Point por defecto) o bien, puedes cambiar la configuración del medio de pago (seleccionar otro procesador, otro terminal u activar otro medio de pago).

{% hint style="warning" %}
**Consideraciones importantes:**

**- El pago de una orden de pago tomará la configuración que tenga el Payment Point en el momento del intento de pago** Es decir, se crea una orden de pago y se le asocia un Payment Point (Ejemplo, versión de payment point v1). Se realizan cambios en la configuración de ese Payment Point (payment point v2). Cuando el cliente final realice el pago de esa orden de pago, el pago se procesará por la configuración que tenga en ese momento (payment point v2)

**- La devolución de una orden de pago se realizará por la configuración que tenía el Payment Point en el momento que se realizó el pago original:** Es decir, se crea una orden de pago y se le asocia un Payment Point (Ejemplo, versión de payment point v1). Cuando el cliente final realice el pago de esa orden de pago, el pago se procesará por la configuración que tenga en ese momento (Payment point v1). Suponiendo que luego, se realiza una modificación sobre esa configuración (payment point v2), si quiere realizarse una devolución, se realizará por la configuración anterior a los cambios, es decir, aquella que tenía se procesó el pago (payment point v1)
{% endhint %}

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Ventajas de tener múltiples Payment Points

## ¿De qué sirve tener diferentes Payment Points?

Brindar la capacidad de configurar Payment Points por tu cuenta y permitir tener más de uno ofrece una serie de beneficios significativos:

1. **Flexibilidad en el Procesamiento de Pagos:** puedes adaptar los Payment Points según tus necesidades, target de clientes y preferencias específicas, permitiendo elegir el procesador de pagos más adecuado para cada tipo de situación.
2. **Mejora de la Experiencia del Usuario:** Al permitir seleccionar el Payment Point que desean utilizar en cada orden de pago, se les brinda un mayor control sobre el proceso de compra. Esto puede conducir a una experiencia de usuario más personalizada y satisfactoria, lo que a su vez puede aumentar la lealtad y retención de clientes.
3. **Adaptación a Diferentes Medios de Pago:** Dado que un Payment Point puede configurarse para procesar diferentes medios de pago (por ejemplo, tarjetas de crédito y débito), puedes adaptar las opciones de pago según las preferencias de tus propios clientes. Esto puede ayudar a ampliar la base de clientes y mejorar las tasas de conversión.
4. **Respaldo ante Contingencias:** Tener múltiples Payment Points configurados ofrece una capa adicional de seguridad y redundancia en caso de que uno de los procesadores experimente problemas técnicos o interrupciones del servicio. Esto garantiza la continuidad del negocio y minimiza el impacto en las operaciones comerciales.

En resumen, al proporcionar la capacidad de configurar tus propios Payment Points y permitir tener más de uno, se les brinda una mayor flexibilidad, control y capacidad de adaptación en el procesamiento de pagos, lo que puede traducirse en una mejor experiencia y resultados comerciales más sólidos.

Además, la posibilidad de crear múltiples Payment Points con configuraciones personalizadas te permite utilizar nuestro servicio como [Orquestador de Pagos](/por-producto/collection/orquestador-de-pagos). Esto significa que, para una orden de pago generada, puedes asignarle diferentes Payment Points hasta que se complete el pago. Esta flexibilidad en el procesamiento de la orden de pago contribuye a reducir la tasa de transacciones expiradas o fallidas.

## Posibles indicadores:

Se puede sacar una serie de indicadores y métricas valiosas al tener la capacidad de configurar y operar con diferentes Payment Points:

1. **Tasa de Conversión por Procesador de Pagos:** Al permitir seleccionar diferentes Payment Points, pueden monitorear y comparar la tasa de conversión asociada a cada procesador de pagos. Esto les permite identificar cuáles proveedores ofrecen una mejor experiencia de pago para sus clientes y optimizar sus estrategias de procesamiento de pagos para aumentar las conversiones.
2. **Distribución de Medios de Pago Utilizados:** Los clientes pueden analizar qué medios de pago son más populares para cada target de clientes al observar la distribución de transacciones realizadas a través de cada Payment Point. Esto les permite adaptar su oferta de medios de pago y estrategias de procesamiento para satisfacer las preferencias de sus clientes.
3. **Tiempo de Procesamiento de Pagos:** Al monitorear el tiempo que tarda cada Payment Point en procesar una transacción, los clientes pueden identificar cuellos de botella y optimizar sus flujos de trabajo para reducir los tiempos de espera y mejorar la eficiencia operativa.
4. **Tasa de Rechazo de Pagos:** Observar la tasa de rechazo de pagos asociada a cada Payment Point permite a los clientes identificar posibles problemas de seguridad o errores en el proceso de pago. Esto les ayuda a tomar medidas correctivas para reducir la cantidad de transacciones rechazadas y mejorar la experiencia del cliente.

En resumen, al tener la capacidad de configurar sus propios Payment Points, los clientes pueden sacar una variedad de indicadores y métricas valiosas que les permiten optimizar sus estrategias de procesamiento de pagos, mejorar la experiencia del cliente y maximizar los resultados comerciales.

***

#### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Collection


# Collection: Funcionalidades y beneficios.

Collection es la aplicación dentro de MYMOID-SUITE que permite crear, enviar y rastrear órdenes de pago y/o campañas masivas de ordenes de pago con la finalidad de facilitar su posterior procesamiento y pago.

*En el contexto de una organización, solo podrá acceder a esta información aquel usuario que se le haya concedido permisos.*

![Collection\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-b982fc5b19033fadb2289863fe3bfbd614cc45c7%2FCollection_1.png?alt=media)

## Funcionalidades

* Crear órdenes de pago individuales y posterior envío (vía link o SMS) personalizado.
* Crear campañas de órdenes de pago masivas (¡5.000 ordenes de pago!) y posterior envío (vía link o SMS) personalizado.
* Orquestación de pagos: para una orden de pago creada, puedes asignarle diferentes Payment Points (configuración de procesador de pago y métodos de pagos disponibles) hasta que se complete el pago. Es decir, para una misma orden de pago, diferentes rutas de procesamiento.
* Programar el envío (vía SMS) de campañas de ordenes de pago para una fecha y hora específica.
* Visualización del listado de las ordenes de pago y campañas creadas.
* Monitorear y administrar el ciclo de vida de cada orden de pago.

## Beneficios

* **Gestión de pagos a gran escala:** La capacidad de enviar órdenes de pago a gran escala es esencial para empresas que realizan numerosas transacciones financieras regularmente.
* **Mayor alcance de mercados e interacción inmediata:** Al recibir los links de pago por SMS (canal universal), los clientes pueden interactuar con las órdenes de pago de manera inmediata y desde cualquier ubicación.
* **Ahorro de tiempo:** La capacidad de enviar órdenes de pago de manera masiva ahorra tiempo en comparación con la emisión individual de cada orden de pago.
* **Eficiencia operativa** La herramienta puede automatizar procesos repetitivos, reduciendo la carga de trabajo manual y minimizando errores.
* **Seguimiento en tiempo real:** Permite el seguimiento en tiempo real del estado de las órdenes de pago, brindando a los usuarios una visibilidad completa sobre el progreso de las transacciones.
* **Control financiero:** Ofrece a las empresas un mayor control sobre sus flujos de efectivo al facilitar la programación y gestión eficiente de los pagos.

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Creación de orden de pago individual

Para crear una orden de pago, puedes hacerlo de las siguientes maneras:

* [A través de la API](/por-producto/developers/que-es-el-api-reference) (te recomendamos usar nuestro [playground](https://developers.mymoid.com/api-reference#/operations/Create)).
* [Desde el producto paymentgateway](/por-producto/payment-gateway/create-po).
* O, como explicaremos a continuación, desde el producto Collection.

[**Collection**](https://collection.mymoid.com) ofrece una interfaz de fácil uso para que el usuario complete los parámetros básicos de una orden de pago y pueda crearla instantáneamente. A diferencia de la creación desde el producto PaymentGateway, además de la creación de la orden de pago te permite:

* Asignarle distintos [Payment Points](/por-producto/payment-gateway/configuracion-pp) hasta que sea pagada ([orquestación de pagos](/por-producto/collection/orquestador-de-pagos))
* Compartirla/enviarla por diferentes canales. Adicionalmente, en Collection, puedes crear órdenes de pago de manera masiva, mediante [campañas de órdenes de pago.](/por-producto/collection/paso-1-como-creo-una-campana)

  <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Por el momento, Collection solo está activa en el entorno de producción. Para poder hacer uso de la misma, debes de tener dado de alta una organización.</p></div>

Para crear una orden de pago individual, sigue las siguientes instrucciones:

1. Ingresa a la aplicación [Collection](https://collection.mymoid.com/) y haz login con tu cuenta.

![Creacion\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-b982fc5b19033fadb2289863fe3bfbd614cc45c7%2FCreacion_1.png?alt=media)

2. Selecciona la organización con la que deseas operar:

![Creacion\_3](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-a4b31dfe3bbd61654cc86d3ec3daa851e2486cea%2FCreacion_3.png?alt=media)

3. Navega a la sección de Payment Orders y haz clic en el botón "Create Payment Order" y se abrirá el formulario de creación de orden de pago.

![Creacion\_2](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-da5b60c82c90b0be995bc02a76c6431c591b4049%2FCreacion_2.png?alt=media)

4. Completa todos los campos de la orden de pago:

* Concept (Concepto)
* Reference (Referencia)
* Currency & Amount (Moneda y valor monetario de la orden de pago)

Ten en cuenta que el campo `Concept`, `Reference`, `Currency` y `Amount` son campos transparentes al usuario final y se verán reflejados en el Formulario de pago de la siguiente manera:

![Creacion\_4](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-25c20e2523c7a527b827ae61bfe25bb0d4a94922%2FCreacion_4.png?alt=media)

5. Selecciona la fecha de expiración de la orden de pago. Es decir hasta que fecha y hora la orden de pago estará disponible para que sea pagada. Por defecto será de 24 horas, pero, si quieres personalizarla, puedes seleccionar la fecha y hora que desees, siempre que sea posterior a la fecha de creación y menor a 15 días.

![Creacion\_4\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-a6cebde701c9e6015a6147f585703e6774e0764b%2FCreacion_4_1.png?alt=media)

6. (Opcional) Si deseas puedes cambiar el [Payment Point](/general/general/que-es-un-pp). En caso contrario se te asignará el configurado por defecto y luego podrás cambiarlo cuantas veces quieras hasta que la orden de pago sea pagada.

![Creacion\_5](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-0e514293887eafdb3546223b6262faa66bd1780c%2FCreacion_5.png?alt=media)

7. Haz clic en el botón "Save" para finalizar la creación de la orden de pago. Puedes visualizar el detalle al hacer clic sobre ella en la tabla como también puedes [ejecutarla haciendo clic en el botón "Pay or Delivery".](/por-producto/collection/como-envio-una-orden-de-pago-individual)

![Creacion\_6](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-0ed399c11442d7f1a279c816fe95e8748381d5be%2FCreacion_6.png?alt=media)

¡y listo ya tienes tu orden de pago creada!

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Envío de orden de pago individual

Una Orden de Pago se representa mediante un enlace o link (URL) que, al abrirse, muestra el [formulario de pago con los detalles de dicha orden](/por-producto/payment-form/customizacion). En este formulario, el destinatario (pagador) puede seleccionar el método de pago, introducir los datos correspondientes y completar el pago de la orden.

Cuando ya has creado la orden de pago y la misma se encuentre en estado "available", deberás ingresar al detalle de la orden de pago y hacer clic en el botón de "Pay or Delivery":

![Envio\_0](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-0ed399c11442d7f1a279c816fe95e8748381d5be%2FEnvio_0.png?alt=media)

{% hint style="info" %}
El botón de "Pay or Delivery" solo está disponible para una orden de pago en "available", es decir, no aparecerá como opción en el detalle de las ordenes de pago con estado "expired", "paid" o "cancelled".
{% endhint %}

{% hint style="info" %}
Una orden de pago en estado "available" podrá ser compartida N veces y tener N intentos de pago hasta que sea correctamente pagada o hasta su fecha de expiración.
{% endhint %}

Existen diferentes posibilidades de acciones sobre la orden de pago:

**1. Puedes copiar el link** y compartirlo por donde desees:

![Envio\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-0d7ab4a43f97f750115849f422fa7997cb8ecd18%2FEnvio_1.png?alt=media)

**2. Puedes enviarlo por SMS**. Para ello, completa los datos del número de teléfono del destinatario (números de Colombia) y del campo del mensaje:

![Envio\_2](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-d9ad4fd3c6233b0d0cb4f861baffca55c9bd7c72%2FEnvio_2.png?alt=media)

Puedes previsualizar el mensaje y validar que todo es correcto antes de enviarlo:

![Envio\_2.2](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-1ce96849e9b9cfa30235578ddca1edf005107cad%2FEnvio_2.2.png?alt=media)

Luego haz clic en el botón "Send" y el mensaje con el link de pago será enviado:

![Envio\_2.1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-fd471451a179294a46486f9d9e190af173cc3ce7%2FEnvio_2.1.png?alt=media)

**3. Puedes directamente abrir el formulario de pago**, en donde, si conoces los datos del medio de pago, podrás completar los campos y pagar la orden de pago.

![Envio\_3](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-f1ea6e3666390ce1b2a76c2cd14fec0c89857a26%2FEnvio_3.png?alt=media)

¡Y listo!

{% hint style="info" %}
Recuerda que para clientes de la Unión Europea, **el uso de la Autenticación Fuerte del Cliente (SCA, por sus siglas en inglés) es obligatorio según PSD2** para autenticar al usuario antes de autorizar la transacción. Por lo tanto, en el caso de los canales "Copy link to share" o "Send link by SMS", se recomienda el uso de Payment Points con SCA. En el caso del canal "Pay by Payment Form", al ser la organización quién actuará en nombre del destinatario para pagar la orden de pago, no es necesario utilizar payment points con SCA.

*Nota: El incumplimiento del mismo es responsabilidad de la organización.*
{% endhint %}

## ¿Qué es el campo selector "Payment Point" y qué sucede si lo modifico?

MYMOID te ofrece la posibilidad de orquestar tus pagos, lo que significa que puedes asociar diferentes Payment Points (configuración de procesador y metodos de pago) a una misma orden de pago. Al cambiar el Payment Point desde el selector, se generará un nuevo enlace con la configuración correspondiente al Payment Point seleccionado.

Por ejemplo, si tienes un Payment Point configurado con un procesador y otro con una configuración diferente, puedes crear una orden de pago, asociarle distintos Payment Point y enviar el enlace correspondiente a tus clientes, según la segmentación que hayas definido. Esto se puede hacer tantas veces como sea necesario hasta que la orden de pago sea completada. Puedes obtener más información en [Orquestación de pagos](/por-producto/collection/orquestador-de-pagos).

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Detalle de orden de pago

Se puede visualizar el detalle de una [orden de pago](/por-producto/payment-gateway/que-es-una-orden-de-pago) desde la aplicación Collection de una forma muy simple. Sigue los siguientes pasos:

1. Ingresa a la sección “Payment Orders” donde encontrarás el listado de todas las órdenes de pago (y el estado) creadas por tu usuario bajo la organización seleccionada.

   ![visualizacion\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-99cc5195030b25bc5edb315b6eed2de3424f1915%2Fvisualizacion_1.png?alt=media)
2. Si conoces algún parámetro de la orden de pago que quieras visualizar como el ID, el estado o la fecha de creación, puedes usar los filtros correspondientes.
3. Dentro del listado, haz clic en la fila de la orden de pago que quieres visualizar y se te abrirá un panel derecho con el detalle:

   ![visualizacion\_2](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-f8eb88d93df5ff5f1c4f8fcb19345d7fe47b3f9b%2Fvisualizacion_2.png?alt=media)

Como se puede ver en la imagen anterior, en el detalle de una orden de pago podrás encontrar:

* Información general de la orden:
  * Concepto(”Concept”): Personalizable por la organización, se utiliza como identificación.
  * Referencia(”Reference”): Personalizable por la organización, se utiliza para identificar el producto/servicio que se desea cobrar.
  * Importe(”Amount”): Personalizable por la organización, valor por el cuál se ha creado la orden de pago.
  * Estado(”Status”).
  * ID.
  * Fuente "Source": Quién creó la orden de pago. Puede ser el email de la persona que lo ha creado (si se creó desde el producto PaymentGateway o Collection), o el nombre de la APP (si se creó directamente desde el API).
  * Shortcode: Identificador que permite cruzar información con las transacciones asociadas y con el formulario de pago.
* Fechas relevantes:
  * De Creación(”Created date”).
  * De Expiración(”Expiration date”).
  * De actualización(”Last update date”): existe sólo si se ha realizado un intento de pago sobre la misma.
* El listado de transacciones asociadas: según [el ciclo de vida de la orden de pago.](/por-producto/payment-gateway/que-es-una-orden-de-pago)

Recuerda que el detalle de una orden de pago, también se puede visualizar haciendo una [consulta al API](https://developers.mymoid.com/api-reference#/operations/GetPaymentOrderByPaymentOrderId).

¡Y Listo!

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Campaña de órdenes de pago: Qué es y Ciclo de vida

**La creación de una campaña de órdenes de pago implica la generación masiva de órdenes de pago de manera simultánea y en un solo click**, con la opción adicional de enviarlas si así se desea. Esta funcionalidad, integrada en Collection, automatiza el proceso de creación y envío de órdenes de pago. En lugar de generarlas individualmente, los usuarios pueden realizar esta tarea de manera masiva (¡hasta 5000 órdenes de pago al mismo tiempo!), reduciendo errores y ahorrando tiempo. ¡Increíble!, ¿verdad?

## ¿Cuál es el ciclo de vida de una campaña?

Durante [el proceso de creación de una campaña](/por-producto/collection/paso-1-como-creo-una-campana) se debe de ir completando una secuencia de pasos. Particularmente en el segundo paso, se debe de cargar un archivo (.CSV o .JSON) con la información de las ordenes de pago. En este archivo se debe cumplir con ciertas especificaciones de formato y campos a completar para que el sistema lo valide correctamente. Ciertos parámetros son obligatorios (como el "currency") y otros, opcionales (como el "smsContact").

Dependiendo si la campaña tiene números de teléfono asociados y se genera una validación correcta de los números de teléfono, **el ciclo de vida de una campaña puede optar diferentes caminos:**

**1. Campanas que, en el archivo adjunto, no tengan numero de teléfono asociados válidos podrán solo ser generadas (y posteriormente descargadas en formato .CSV)** Cuando haces click en el botón "generate" todas las ordenes de pago definidas en el fichero, serán generadas automáticamente (estado "running") y quedarán en estado disponible "available" para su pago. Esto significa que tendrán un listado de N ordenes de pago con estado "available" con un ID, un Shortcode y un link de pago (para abrir el formulario de pago).

*Podrás descargar un archivo .CSV con el listado de ordenes de pago creadas. Para esto, haz clic en el botón de "Export"*

**2. Campañas que, en el archivo adjunto, tengan números de teléfono válidos podrán:**

* **2.1 Click en "just generate**" (Solo ser generada): Campaña pasa a estado "running" y luego a "Generated".
* **2.2 Click en "send now"** (Ser generada y enviada a los números de teléfono): Campaña pasa a estado "running" y luego a "Delivery".
* **2.3 Click en "schedule"** (Ser programada para ser generada y enviada en una fecha y hora definida): Campaña pasa a estado "schedule" hasta la fecha/hora definida que, automáticamente en esa fecha, pasa a estado "Running" y luego a "Delivery".

![Campaignflow](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-cec9c99164e47b6f0c61ad4911c958e82d939c69%2FCampaignflow.png?alt=media)

Conoce cómo es el paso a paso del [proceso de creación de una campaña de órdenes de pago](/por-producto/collection/paso-1-como-creo-una-campana)

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Paso 1: Creación de campaña de órdenes de pago

Desde **Collection** ofrecemos una interfaz fácil de usar para que el usuario, siguiendo una serie de pasos, pueda crear una campaña de órdenes de pago (creación masiva de diferentes órdenes de pago) y, si lo deseas, enviarlas por SMS o programar su envío para una fecha y hora personalizada.

{% hint style="info" %}
Por el momento, Collection solo está activa en entorno en producción. Para poder hacer uso de la misma, debes de tener dado de alta una organización.
{% endhint %}

Para crear una campaña de órdenes de pago, sigue las siguientes instrucciones:

1. Ingresa a la aplicación [Collection](https://collection.mymoid.com/) y haz login con tu cuenta.

![Creacion\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-b982fc5b19033fadb2289863fe3bfbd614cc45c7%2FCreacion_1.png?alt=media)

2. Selecciona la organización con la que desees operar:

![Creacion\_3](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-a4b31dfe3bbd61654cc86d3ec3daa851e2486cea%2FCreacion_3.png?alt=media)

3. Navega a la sección de Campaigns y haz clic en el botón "Create Campaigns" y se abrirá el formulario de creación de orden de pago en el panel derecho. Continúa con el paso a paso:

![campanas\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-817f437d2a79bb7af6a4c7ce67e365cd36a97880%2Fcampanas_1.png?alt=media)

## \[Paso 1:info]

Completa todos los campos de identificador de la Campaña:

* Name (Nombre)
* Description (Descripción de la campaña)

![campanas\_2](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-7d5cae0b8860633f7410aa68791b3484602c56df%2Fcampanas_2.png?alt=media)

El botón "next" se habilitará, a continuación haz clic en él. Navegarás al [\[Paso 2\] Source de órdenes de pago](/por-producto/collection/paso-2-como-creo-una-campana)

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Paso 2: Fuente de datos para creación de campaña

Luego de haber completado el [Paso 1 info de campaña](/por-producto/collection/paso-1-como-creo-una-campana) avanzamos con el paso 2.

## \[Paso 2: source] Carga de archivos con datos de las ordenes de pago

Carga el archivo en formato .CSV o .JSON con los datos de las órdenes de pago que deseas crear. Puedes utilizar el ejemplo proporcionado para guiarte de cómo completar el documento correctamente.

![campanas\_3](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-dfdda8d52064f49f68829eda22bc260c8ee58410%2Fcampanas_3.png?alt=media)

* **si el formato es .CSV:** Cada fila corresponde a una orden de pago.

![campanas\_4](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-e98887b1ac6aac44061cbb482d29f716c7a98e37%2Fcampanas_4.png?alt=media)

* **si el formato es .JSON:**

![campanas\_5](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-7d291ffadd01c4e2891d448658c28cf4b6bea82f%2Fcampanas_5.png?alt=media)

{% hint style="info" %}
Considere las propiedades de los siguientes parámetros:

* Moneda: Solo acepta COP (peso colombiano).
* Cantidad: Debe estar en centavos (ejemplo: si quieres COP 1000.00, debes escribir 100000).
* SMSContact (parámetro opcional): Debe ser obligatorio para enviar la orden de pago vía SMS. Solo acepta números de teléfono de Colombia. Si no deseas enviarlo, elimina este campo.
  {% endhint %}

Una vez cargado, valida que la información sea correcta en la sección de Summary según la distintas casuísticas:

* **CASO 1:** Archivo con ordenes de pago SIN el parámetro SMScontact -> validación de la cantidad de ordenes de pago.

![campanas\_6](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-0e81a7bd8808511ee387c097462890f27665b8a0%2Fcampanas_6.png?alt=media)

* **CASO 2:** Archivo con ordenes de pago CON el parámetro SMScontact -> validación de la cantidad de órdenes de pago, la cantidad de números de teléfono válidos y la cantidad de números de teléfono inválidos (vacíos o con formato incorrecto).

![campanas\_8](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-46e2f83e049114fa2a8ef8cdf2cbf468b77fc84d%2Fcampanas_8.png?alt=media)

![campanas\_7](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-bbd9a5f3deedeaee583d3712a8303b0ff206bb83%2Fcampanas_7.png?alt=media)

{% hint style="warning" %}
En caso que exista ordenes de pago con teléfonos números inválidos, en el paso de "delivery" no se podrá enviar la campaña.
{% endhint %}

Una vez finalizada la validación, haz clic en el botón "next" y navegarás al paso 3, generación o envío de órdenes de pago.

### \[Paso 3: Delivery] Generación y/o envío por SMS o programación de envío por SMS:

En este paso decides qué quieres hacer con tu campaña. Según el archivo cargado, podrás seleccionar entre las siguientes opciones:

* **"No,just generate"** -> *esta opción está disponible indiferentemente si las órdenes de pago tenían asociado o no un SMScontact*. Podrás generar las órdenes de pago y pasarán a estado disponible ("available") inmediatamente. Sigue las instrucciones [aquí](/por-producto/collection/como-solo-genero-ordenes-de-pago)
* **"Send now"** -> *esta opción está disponible para el caso en que el archivo anteriormente cargado tenga la totalidad de las ordenes de pago con un SMScontact válido asociado*. Podrás generar y enviar las órdenes de pago de manera inmediata por SMS a los números correspondientes. Sigue las instrucciones [aquí](/por-producto/collection/como-envio-una-campana-de-ordenes-de-pago)
* **"Schedule delivery"** -> *esta opción está disponible para el caso en que el archivo anteriormente cargado tenga la totalidad de las ordenes de pago con un SMScontact válido asociado*. Podrás elegir la fecha y hora que deseas que las ordenes de pago se generen y se envíen por SMS a los números correspondientes. Sigue las instrucciones [aquí](/por-producto/collection/como-programo-el-envio-de-campana-de-ordenes-de-pago)


# Paso 3.1: Generación de campaña

Como se explicó [en el paso 2 del proceso de creación de una campaña de órdenes de pago](/por-producto/collection/paso-2-como-creo-una-campana), en el último paso ("delivery"), se debe elegir qué quieres hacer con tu campaña de órdenes de pago. Tienes tres opciones:

* Solo generar la campaña = No, just generate (opción siempre habilitada).
* Generar y enviar la campaña en ese momento = Send now (habilitada en caso de que exista números de teléfono válidos).
* Programar para una fecha y hora la generación y envío de la campaña = Schedule delivery (habilitada en caso de que exista números de teléfono válidos).

A continuación explicaremos la opción de "No, just generate"

## \[Paso 3: Delivery] Opción: "No, just generate"

Esta opción está disponible indiferentemente si las órdenes de pago tenían asociado o no un SMScontact. Podrás generar las órdenes de pago y pasarán a estado disponible ("available") inmediatamente.

![campanas\_9](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-c612a6c6673b1a210ce62bf8032fed7d094aabc9%2Fcampanas_9.png?alt=media)

{% hint style="warning" %}
Si seleccionas la opción "No, just generated", no podrás posteriormente enviar las órdenes de pago de manera masiva. En caso contrario, puedes ir a la sección de "payment orders" y enviar individualmente por SMS.
{% endhint %}

1. Si deseas, puedes cambiar el [Payment Point](/general/general/que-es-un-pp) desde el listado desplegable. Por defecto viene seleccionado el "por defecto" y todas las órdenes de pago se crearán con este Payment Point. En caso de querer enrutar a un nuevo payment point, se deberá hacer directamente [desde cada orden de pago generada](/por-producto/collection/como-envio-una-campana-de-ordenes-de-pago), desde la sección de "Payment Orders".

![campanas\_9.1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-4404efb0a4c7206926db7872ec1a34b3aa500daa%2Fcampanas_9.1.png?alt=media)

2. Selecciona la fecha de expiración de las órdenes de pago, es decir, hasta qué día estarán disponibles para efectuar su pago. *Cómo mínimo puedes seleccionar 10 minutos y como máximo 15 días.*

![campanas\_10](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-a93860880ba2856799391b7e39529d4430595f40%2Fcampanas_10.png?alt=media)

3. Haz clic en el botón "create" y, según el [ciclo de vida de una campaña](/por-producto/collection/como-es-el-ciclo-de-vida-de-una-campana-de-ordenes-de-pago), la campaña pasa a estado "Running" hasta que la misma esté totalmente generada (estado "generated"). *Recomendamos refrescar la página luego de unos segundos.*

![campanas\_11](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-9aa082b086b1086a86d59dab80afc8b8ed3ff589%2Fcampanas_11.png?alt=media)

Luego de la generación, podrás visualizar tanto el detalle como también exportar un .CSV con las órdenes de pago generadas:

![campanas\_12](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-eee933a708ac2ba4a94d1b0861571fbac7479c36%2Fcampanas_12.png?alt=media)

¡y listo!

{% hint style="info" %}
Cómo dijimos anteriormente, en vez de "No, just generated", puedes seleccionar las siguientes opciones:

* **"Send now"** -> Esta opción está disponible para el caso en que el archivo anteriormente cargado tenga la totalidad de las ordenes de pago con un SMScontact válido asociado. Podrás generar y enviar las órdenes de pago de manera inmediata por SMS a los números correspondientes. Sigue las instrucciones [aquí](/por-producto/collection/como-envio-una-campana-de-ordenes-de-pago)
* **"Schedule"** -> Esta opción está disponible para el caso en que el archivo anteriormente cargado tenga la totalidad de las ordenes de pago con un SMScontact válido asociado. Podrás elegir la fecha y hora que deseas que las ordenes de pago se generen y se envíen por SMS a los números correspondientes. Sigue las instrucciones [aquí](/por-producto/collection/como-programo-el-envio-de-campana-de-ordenes-de-pago)
  {% endhint %}

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Paso 3.2: Generación de campaña y envío por SMS

Como se explicó [en el paso 2 del proceso de creación de una campaña de órdenes de pago](/por-producto/collection/paso-2-como-creo-una-campana), en el último paso ("delivery"), se debe elegir qué quieres hacer con tu campaña de órdenes de pago. Tienes tres opciones:

* Solo generar la campaña = No, just generate (opción siempre habilitada).
* Generar y enviar la campaña en ese momento = Send now (habilitada en caso de que exista números de teléfono válidos).
* Programar para una fecha y hora la generación y envío de la campaña = Schedule delivery (habilitada en caso de que exista números de teléfono válidos).

A continuación explicaremos la opción de "Send Now"

## \[Paso 3: Delivery] Opción: "Send now"

Esta opción está disponible solo si los números de teléfono del parámetro SMScontact son válidos. Al seleccionar esta opción podrás generar las órdenes de pago y enviarlas inmediatamente a los contactos.

![campanas\_13](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-da5565fc04ae7a81edf4abe5fd9fa458c9b64b47%2Fcampanas_13.png?alt=media)

1. Si deseas, puedes cambiar el [Payment Point](/general/general/que-es-un-pp) desde el listado desplegable. Por defecto viene seleccionado el "por defecto" y todas las órdenes de pago se crearán con este Payment Point. En caso de querer enrutar a un nuevo payment point, se deberá hacer directamente [desde cada orden de pago generada](/por-producto/collection/como-envio-una-campana-de-ordenes-de-pago), desde la sección de "Payment Orders".

![campanas\_13.1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-2332665fa13a8225cff763892e5a016c00236d4b%2Fcampanas_13.1.png?alt=media)

2. Escribe tu mensaje de texto en el campo correspondiente. Debes escribir al comienzo o al final de la URL del formulario de pago dejando un espacio entre el mensaje y la URL.

![campanas\_14](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-81fd67935dea6203cc7eae90904ea6fbdc761cc1%2Fcampanas_14.png?alt=media)

Adicionalmente puedes previsualizar cómo quedará tu mensaje haciendo clic en el botón "preview":

![campanas\_15](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-5f3eeeda8e0821c81827c5791f06f5d6ac210033%2Fcampanas_15.png?alt=media)

3. Elije la fecha de expiración de las órdenes de pago, es decir, hasta qué día estarán disponibles para efectuar tu pago. Por defecto son 48h. *Cómo mínimo puedes seleccionar 10 minutos y como máximo 15 días.*

![campanas\_16](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-ca6290dc8b0b5853baac597c82ac018f0ca018a3%2Fcampanas_16.png?alt=media)

3. Haz clic en el botón "create" y, según el [ciclo de vida de una campaña](/por-producto/collection/como-es-el-ciclo-de-vida-de-una-campana-de-ordenes-de-pago), la campaña pasa a estado "Running" hasta que la misma esté totalmente enviada (estado "delivery"). *Recomendamos refrescar la página luego de unos segundos.*

Luego de la generación y envío, podrás visualizar el detalle como también exportar un .CSV con las órdenes de pago generadas y enviadas:

![campanas\_17](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-cbc88ad0d2124eefad8be2e37bfa95d3b8f34476%2Fcampanas_17.png?alt=media)

¡y listo!

{% hint style="info" %}
Cómo dijimos anteriormente, como alternativa a "Send now", puedes seleccionar las siguientes opciones:

* **No,just generate** -> Esta opción está disponible indiferentemente si las órdenes de pago tenían asociado o no un SMScontact. Podrás generar las órdenes de pago y pasarán a estado disponible ("available") inmediatamente. Sigue las instrucciones [aquí](/por-producto/collection/como-solo-genero-ordenes-de-pago)
* **"Schedule"** -> Esta opción está disponible para el caso en que el archivo anteriormente cargado tenga la totalidad de las órdenes de pago con un SMScontact válido asociado. Podrás elegir la fecha y hora que deseas que las órdenes de pago se generen y se envíen por SMS a los números correspondientes. Sigue las instrucciones [aquí](/por-producto/collection/como-programo-el-envio-de-campana-de-ordenes-de-pago)
  {% endhint %}

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Paso 3.3: Generación de campaña y programación de envío SMS

Como se explicó [en el paso 2 del proceso de creación de una campaña de órdenes de pago](/por-producto/collection/paso-2-como-creo-una-campana), en el último paso ("delivery"), se debe elegir qué quieres hacer con tu campaña de órdenes de pago. Tienes tres opciones:

* Solo generar la campaña = No, just generate (opción siempre habilitada).
* Generar y enviar la campaña en ese momento = Send now (habilitada en caso de que exista números de teléfono válidos).
* Programar para una fecha y hora la generación y envío de la campaña = Schedule delivery (habilitada en caso de que exista números de teléfono válidos).

A continuación explicaremos la opción de "Schedule delivery".

## \[Paso 3: Delivery] Opción: "Schedule delivery"

Esta opción está disponible solo si los números de teléfono del parámetro SMScontact son válidos. Al seleccionar esta opción podrás programar cuándo quieres que se generen y envíen vía SMS las órdenes de pago (día y hora).

![campanas\_18](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-0c9e0014f7b989f3dc39ccacbb1bcc7a4fa09a00%2Fcampanas_18.png?alt=media)

1. Si deseas, puedes cambiar el [Payment Point](/general/general/que-es-un-pp) desde el listado desplegable. Por defecto viene seleccionado el "por defecto" y todas las órdenes de pago se crearán con este Payment Point. En caso de querer enrutar a un nuevo payment point, se deberá hacer directamente [desde cada orden de pago generada](/por-producto/collection/como-envio-una-campana-de-ordenes-de-pago), desde la sección de "Payment Orders".

![campanas\_18.1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-e5cae817d2e62b424066850ab79624989e6ef33f%2Fcampanas_18.1.png?alt=media)

2. Escribe tu mensaje de texto en el campo correspondiente. Debes escribir al comienzo o al final de la URL del formulario de pago dejando un espacio entre el mensaje y la URL.

![campanas\_19](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-f819644b3042a5804f8a5d27f0fe15d1c73a3cd0%2Fcampanas_19.png?alt=media)

Adicionalmente puedes previsualizar cómo quedará tu mensaje haciendo clic en el botón "preview":

![campanas\_20](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-e30def8dbbd88f3ef125e9a179e0909db7df0a17%2Fcampanas_20.png?alt=media)

3. Elige la fecha de expiración de las órdenes de pago, es decir, hasta qué día estarán disponibles para efectuar tu pago. Por defecto son 48h. *Cómo mínimo puedes seleccionar 10 minutos y como máximo 15 días.*

![campanas\_21](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-6fdd6d9115879fc4873db1756b33e3de45b8514c%2Fcampanas_21.png?alt=media)

4. Elige la fecha de envío de las órdenes de pago ("starting date"), es decir, qué fecha y hora deseas que se envíen las órdenes de pago via SMS. Por defecto son 48h. *Cómo mínimo puedes seleccionar 10 minutos y como máximo 1 minuto anterior a la fecha de expiración seleccionada en el paso anterior.*

![campanas\_22](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-403a06f6574c724f1291f37137bb12b4dc398b77%2Fcampanas_22.png?alt=media)

5. Haz clic en el botón "create" y, según el [ciclo de vida de una campaña](/por-producto/collection/como-es-el-ciclo-de-vida-de-una-campana-de-ordenes-de-pago), la campaña pasa a estado "schedule" hasta la fecha y hora de envío seleccionada.

![campanas\_23](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-008fbc95a779deec4739704fcc2487484b48160c%2Fcampanas_23.png?alt=media)

¡y listo!

En la fecha y hora seleccionada, pasará a estado "running" hasta que la misma esté totalmente enviada (estado "delivery"). *Recomendamos refrescar la página luego de unos segundos.*

{% hint style="info" %}
Cómo dijimos anteriormente, en vez de "Schedule delivery", puedes seleccionar las siguientes opciones:

* **No,just generate** -> Esta opción está disponible indiferentemente si las órdenes de pago tenían asociado o no un SMScontact. Podrás generar las órdenes de pago y pasarán a estado disponible ("available") inmediatamente. Sigue las instrucciones [aquí](/por-producto/collection/como-solo-genero-ordenes-de-pago)
* **"Send now"** -> Esta opción está disponible para el caso en que el archivo anteriormente cargado tenga la totalidad de las órdenes de pago con un SMScontact válido asociado. Podrás generar y enviar las órdenes de pago de manera inmediata por SMS a los números correspondientes. Sigue las instrucciones [aquí](/por-producto/collection/como-envio-una-campana-de-ordenes-de-pago)
  {% endhint %}

## ¿Puedo reprogramar la fecha/hora establecido para el envío de campaña?

¡Si, puedes! Puedes cambiar la fecha de envío de la campaña cuantas veces quieras en la fecha/hora que desees siempre que sea anterior a la fecha de expiración predefinida durante el proceso de creación de la campaña. Solo debes ingresar al detalle de la campaña (debe poseer estado "schedule") y en la opción de "starting date" cambiar a la fecha/hora que deseas y hacer clic en el botón "save":

![campanas\_24](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-6c7d6118a929285f83416d4c98204705c3b15f0b%2Fcampanas_24.png?alt=media)

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Detalle de una campaña creada

Para visualizar el detalle de una Campaña desde la aplicación Collection lo puedes hacer de una forma muy simple. Sigue los siguientes pasos:

1. Ingresa a la sección “Campaigns” donde encontrarás el listado de todas las campañas (y su estado) creadas por tu usuario bajo una organización.

   ![campanas\_25](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-3c4f8fc866892657011519bebfd73fbc4d1dbaac%2Fcampanas_25.png?alt=media)
2. Si conoces algún parámetro de la campaña que quieres visualizar puedes usar el buscador (Nombre de campaña o ID) o puedes filtrar con la sección de filtros (canal de envío o estado de campaña).

   ![campanas\_26](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-2d07876fb52c7da1c58bfd1790e56d7838bb2db9%2Fcampanas_26.png?alt=media)
3. Dentro del listado de campañas, haz clic en la fila de la campaña que quieres visualizar y se te abrirá un panel derecho con el detalle:

   ![campanas\_27](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-5d9f011e9f2a902d3d736fe0ebf344de86717b0e%2Fcampanas_27.png?alt=media)

Como se visualiza en la imagen anterior, en el detalle de una orden de pago podrás encontrar:

* Info de la campaña:
  * Nombre
  * ID
  * Estado (según ciclo de vida de una campaña)
  * Payment Point
* Info de la generación/envío de la campaña:
  * Cantidad de órdenes creadas
  * Cantidad de números válidos (en caso que se haya enviado por SMS)
* Info de las órdenes de pago:
  * Fecha de expiración.
  * Fecha de generación y envío (en caso que se hayan enviado por SMS). *En caso de programación de campaña, esta fecha puede ser modificada*

¡Y Listo!

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Orquestación de pagos

## ¿Qué es un orquestador de pagos?

Un **orquestador de pagos** es una solución que centraliza y gestiona el enrutamiento de las transacciones entre diferentes proveedores de pago, procesadores y métodos, adaptándose a las necesidades del cliente. Su objetivo es optimizar el proceso de pago, reduciendo el número de transacciones fallidas y aumentando la tasa de éxito en los cobros.

En MYMOID, hemos lanzado la funcionalidad de orquestación de pagos, que complementa nuestra opción de ["creación y configuración de Payment Points"](/por-producto/payment-gateway/configuracion-pp).

Anteriormente, cada orden de pago estaba vinculada a un solo Payment Point (configuración del procesamiento del pago) de manera fija. Ahora, gracias a la orquestación, nuestro sistema permite crear rutas dinámicas y flexibles. Esto significa que si un procesador falla, no es aceptado por el cliente, o requiere un cambio, la orden de pago puede ser reenviada rápidamente a un segundo Payment Point, asegurando que el cliente tenga más opciones para completar su transacción de manera exitosa.

{% hint style="info" %}
En MYMOID, un Payment Point es un punto de venta configurado con cierto procesador y metodos de pago. Para utilizar la orquestación de pagos, es necesario tener al menos dos Payment Points configurados, lo que permite realizar los diferentes enrutamientos. Consulta la sección [Cómo crear y configurar un Payment Point](/por-producto/payment-gateway/configuracion-pp) para más información.
{% endhint %}

### Ejemplo de flujo de enrutamiento:

**A. Ruta con diferentes medios de pago:**

1. Se crea una orden de pago con el "Payment Point 1", configurado con tarjeta de crédito como método de pago.
2. La orden se envía al cliente.
3. El cliente abre la orden de pago y al ver que solo tiene tarjeta prefiere no realizar la operación. El comercio, rápidamente le asocia un "Payment Point 2" que incluye, como método de pago disponible, Tarjeta y otro método de pago.
4. La orden se reenvía al cliente con el nuevo Payment Point.
5. El cliente visualiza las opciones de pago y elige la que prefiere.

![orchestrator\_ruta2](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-5cf060a6dfd4224340aa92a3847da1ab2e6b1315%2Forchestrator_ruta2.png?alt=media)

**B. Ruta con diferentes procesadores:**

1. Se crea una orden de pago con el "Payment Point 1", configurado con un procesador X.
2. La orden se envía al cliente, quién intenta hacer el pago pero falla.
3. El comercio, al revisar una transacción fallida o "denial", le asocia un nuevo "Payment Point 2", que tiene configurado otro procesador.
4. La orden se reenvía al cliente con el nuevo Payment Point.
5. El cliente intenta de nuevo y la transacción se procesa correctamente.

![orchestrator\_ruta1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-102e5fed64e54bbc40ded7819dc98427a3048d50%2Forchestrator_ruta1.png?alt=media)

Este proceso asegura que el cliente pueda finalizar el pago, reduciendo transacciones fallidas y mejorando la tasa de éxito.

{% hint style="success" %}
Ten en cuenta que, cada vez que se asocia un nuevo Payment Point, se genera un nuevo enlace de la orden de pago. Ningún enlace caduca al crear uno nuevo, todos permanecen disponibles hasta que se complete el pago.
{% endhint %}

## Beneficios de orquestar un pago

Orquestar pagos con MYMOID proporciona beneficios clave que mejoran tanto la conversión de las órdenes de pago como la experiencia del cliente:

* **Reducción de fallos**: Si un procesador no puede completar el pago, la transacción se redirige automáticamente a otro Payment Point, lo que reduce significativamente el número de transacciones fallidas.
* **Mejora de la tasa de conversión**: Al ofrecer múltiples métodos y rutas alternativas para completar un pago, las probabilidades de éxito aumentan considerablemente, lo que se traduce en más ventas cerradas y menos carritos abandonados.
* **Optimización de la experiencia del cliente**: Al permitir que el pago continúe sin interrupciones, aunque un procesador falle o el cliente cambie de preferencia de pago, la experiencia es más fluida y confiable, incrementando la satisfacción del usuario.
* **Minimización de la fricción en el proceso de pago**: Los clientes no tienen que reiniciar el proceso si su método de pago falla, ya que pueden seguir intentando con otros medios, lo que reduce la frustración y mejora las probabilidades de completar la transacción.

Sigue las [instrucciones para realizar un enrutamiento de una orden de pago desde Collection](/por-producto/collection/enrutamiento-de-payment-point-a-una-orden-de-pago)

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Enrutar una orden de pago a multiples Payment Points

1. Accede a la aplicación [Collection](https://collection.mymoid.com/), ve a la sección de Payment Orders y selecciona una orden de pago en estado "Available". *Si aún no has creado una orden de pago,* [*consulta aquí cómo crear tu primera orden*](https://docs.mymoid.com/por-producto/collection/como-creo-una-orden-de-pago-individual).
2. Haz clic en el botón "Pay or Delivery" para ver los diferentes canales disponibles para compartir la orden de pago.

   ![orquestador\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-7c5ae0a94a8b3998fc910d6d80af75f2db0c642a%2Forquestador_1.png?alt=media)

   La URL de la orden esta pago está lista para compartirse a través de un enlace, enviarse por SMS o abrirse en su formulario de pago. **Si deseas asignar un nuevo Payment Point,** haz clic en el selector "payment point" y elige uno de la lista. Al seleccionar un nuevo Payment Point, se generará un enlace actualizado que podrás compartir por los mismos canales que el anterior.

   ![orquestador\_3](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-b96e73c4bd03e2fb6bb0ea3a9c3bc48e9ab80297%2Forquestador_3.png?alt=media)

   ![orquestador\_4](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-98bdbf546c633a65a9a26ccdc5c170d5fef197a9%2Forquestador_4.png?alt=media)

{% hint style="success" %}
Recuerda: al crear una orden de pago se le asigna un Payment Point por defecto. Cada vez que se asigna un nuevo Payment Point, se genera un enlace único adicional para la orden de pago. Todos los enlaces generados permanecen activos hasta que se complete el pago.
{% endhint %}

**Revisa estos enlaces de interés:**

* [¿Como configuro Payment Points?](https://docs.mymoid.com/por-producto/payment-gateway/configuracion-pp)
* [¿Qué es ser un orquestador de pagos? Beneficios](https://docs.mymoid.com/por-producto/collection/orquestador-de-pagos)

***

### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Payment Form


# Customización del formulario de pago

El **Formulario de Pago es un formulario web que representa una orden de pago y permite a los usuarios ingresar información de pago para realizar un pago**. Normalmente incluye campos para que el usuario ingrese detalles de pago, como el número de tarjeta, la fecha de vencimiento, el titular de la tarjeta y el código de seguridad. Somos PCI-DSS, por lo tanto garantizamos el procesamiento, almacenamiento y transmisión de información de tarjetas de que se mantengan un entorno seguro, proporcionando a los usuarios la confianza de que sus datos de pago están protegidos contra el fraude y el acceso no autorizado.

## Personalización del formulario de pago

El Formulario de Pago puede personalizarse con elementos básicos, como el logo y los colores. Si deseas personalizar tu Formulario de Pago, por favor [Escribe un ticket](https://support.mymoid.com/support/home) o contacta directamente con nuestro equipo de soporte. Ten en cuenta las siguientes consideraciones:

**Componentes personalizables:**

1. Color de fondo (Obligatorio): color Hex o RGB (Por defecto: #c6cccd)
2. Visibilidad del logo (Obligatorio): visible/oculto (Por defecto: oculto)
3. Visibilidad del nombre de la organización (Opcional): visible/oculto (Por defecto: visible)
4. Visibilidad del concepto "Concept" (Opcional): visible/oculto (Por defecto: visible)
5. Visibilidad de la Referencia "Reference" (Opcional): Visibilidad: visible/oculto (Por defecto: visible)
6. Color del botón (Obligatorio): color Hex o RGB (Por defecto: #2286a4)
7. Color del texto del botón (Obligatorio): color Hex o RGB (Por defecto: #000000)

**Consideraciones del Logo:**

* Imagen PNG-24 (transparente)
* Altura máxima: 40px
* Anchura máxima: 150px
* Resolución @1x/@2x

![payment-form-customization.svg](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-dd2c75d903b98d3b72d192e40a5acfca117af1e8%2Fpayment-form-customization.svg?alt=media)

## Recomendaciones Multi dispositivo / Iframe.

El Formulario de Pago es completamente adaptativo, lo que significa que se ajusta automáticamente al tamaño de la pantalla del dispositivo del usuario, ya sea un escritorio o un dispositivo móvil. El tamaño máximo de altura del contenido del formulario es de 702px en pantallas de escritorio y aproximadamente 450px en pantallas móviles en modo vertical.

El contenido del iframe ha sido diseñado de manera responsiva para ajustarse al ancho del iframe a medida que el tamaño de la página web cambia. Esto permite que el ancho se establezca dinámicamente utilizando un porcentaje o mediante una consulta de medios en CSS.

Sin embargo, es importante destacar que la altura debe configurarse manualmente, tomando en cuenta las limitaciones mencionadas anteriormente. Se recomienda encarecidamente usar una consulta de medios en CSS para establecer la altura del iframe y asegurar que el formulario siempre se vea correctamente en cualquier dispositivo.

***

#### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Métodos de pago

## 1. ¿Qué es un método de pago?

Un **método de pago** es la forma en que un cliente puede realizar un pago por bienes o servicios en una tienda online o física. Esto puede incluir el uso de tarjetas de crédito, débito, transferencias bancarias, soluciones de pago móvil, entre otros.

Una pasarela de pagos como MYMOID tiene el beneficio de integrarse a distintos métodos de pago. Ofrecer múltiples métodos de pago mejora la experiencia del cliente, ya que les permite elegir la opción que les resulte más conveniente y segura. Esto puede aumentar la tasa de conversión, ya que reduces la posibilidad de que un cliente abandone su compra por no encontrar un método de pago adecuado.

Además, MYMOID es una pasarela de pagos que ofrece [la orquestación de pagos](/por-producto/collection/orquestador-de-pagos). Es decir, la posibilidad de configurar diferentes [payments points](https://docs.mymoid.com/por-producto/payment-gateway/ventajas-de-crear-pp) (con diferente configuración de procesadores o medios de pago) y enrutar una misma orden de pago a distintos payment points para mejorar la conversión de pago de la orden de pago.

**¿De qué depende tener habilitados múltiples métodos de pago?**

Para habilitar varios métodos de pago, se debe cumplir con los siguientes factores:

* Banco emisor: El banco del cliente debe ser compatible con el método de pago seleccionado.
* Adquirente: Debe existir un adquirente que soporte las transacciones con el método de pago.
* Compatibilidad con nuestra pasarela: El método de pago debe ser soportado e integrado por nuestra pasarela.

### ¿Qué métodos de pago ofrecemos?

Actualmente, nuestra pasarela de pagos soporta el siguiente método principal:

* **Tarjetas de crédito y débito** (American Express, Diners, MasterCard y Visa)

{% hint style="info" %}
Actualmente estamos trabajando para integrar más métodos de pago y ofrecer una mayor variedad para nuestros clientes. Si estás interesado en un método de pago específico, por favor [escríbenos](mailto:info@mymoid.com) y cuéntanos cuál es tu necesidad.
{% endhint %}

![pf\_paymentmethod\_1](https://2362226658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhmFF8CZOakzsVkVuvwaq%2Fuploads%2Fgit-blob-f10e17ca53f6342b1b7c65444b18cc64caa8fc6f%2Fpf_paymentmethod_1.png?alt=media)

## Método de pago: Tarjeta

Las tarjetas de crédito y débito son los métodos de pago más comunes y utilizados a nivel mundial. Nuestra pasarela acepta tarjetas de las redes **American Express**, **Diners**, **MasterCard** y **Visa**.

**Particularidades de ofrecer tarjeta:**

* **Amplia aceptación**: Las tarjetas son aceptadas internacionalmente, lo que te permite llegar a una audiencia global.
* **Seguridad**: Ofrecemos protección adicional con tecnología **3D Secure** para reducir fraudes.
* **Procesamiento en tiempo real**: Las transacciones con tarjeta son rápidas y seguras.

**¿Cómo configuro el pago con tarjeta?** Para aceptar pagos con tarjeta, necesitas configurar al menos un **procesador de tarjetas** compatible. Si todavía no tienes uno, [escribe a nuestro equipo](mailto:info@mymoid.com) y te ayudaremos a agilizar el proceso de alta.

Una vez que ya tengas tu procesador activado, [configura tu Payment Point con tarjeta.](https://docs.mymoid.com/por-producto/payment-gateway/configuracion-pp#id-3.1-configurar-tarjeta-como-medio-de-pago)

***

#### 💁 **¿Necesitas ayuda?**

[Escribe un ticket](https://support.mymoid.com/support/home) con el motivo de consulta y contacta directamente con soporte.


# Glosario de conceptos


# ¿Qué es un gateway y cómo funciona?

## ¿Qué es un gateway?

Un gateway es la representación de un TPV (Virtual) dentro del ecosistema de MYMOID. Esta representación es la encargada de almacenar la información necesaria para establecer y gestionar la conexión con el proveedor de pagos.

Un ejemplo de información que encontraremos dentro de un gateway puede ser la URL del proveedor de pagos correspondiente, así como las credenciales necesarias para establecer dicha comunicación de manera segura.

## ¿Cómo funciona?

Tras iniciar un proceso de pago y realizar las validaciones correspondientes, desde MYMOID se recupera la información almacenada en el gateway correspondiente y se establece un canal de comunicación seguro para la ejecución del pago correspondiente.


# ¿Qué es un TPV y cómo funciona?

## ¿Qué es un TPV?

Un Terminal Punto de Venta (TPV) o también conocido como POS (Point of Sale, en inglés) es un dispositivo que gestiona las tareas relacionadas con las ventas en un comercio.

Cabe destacar que el término TPV puede referirse a su implementación física o a la virtual, que es la versión online del clásico datáfono que se usa en los negocios para procesar el pago con tarjeta, pero en este caso en tiendas online.

## ¿Cómo funciona?

Como mencionamos en el apartado anterior, un TPV se encarga de gestionar las tareas relacionadas con las ventas de un comercio, o también conocido como cobros.

Para la ejecución de dichos cobros, el TPV establece un canal de comunicación seguro entre el comercio y adquirente para realizar el envío del medio de pago correspondiente y posterior cobro de la venta.


# Diferencia entre Gateway y un TPV

Habiendo revisado las definiciones para cada término, podemos establecer que la simple diferencia entre un Gateway y un TPV es el contexto en el que se representan cada uno.

Sin embargo, dado que un Gateway es una representación creada por y para MYMOID, permite aumentar o mejorar la funcionalidad propia de un TPV. Por ejemplo, utilizando los Gateway de MYMOID es posible combinar MPIs (Proveedores 3DS) Externos al TPV al mismo.


# ¿Qué es un Payment Point? Relación entre el Payment Point y los Gateways

## ¿Qué es un Payment Point?

Un Payment Point (Punto de venta) puede ser definido como un conjunto de configuraciones preestablecidas las cuales nos facilitan la ejecución y gestión de pagos.

El principal beneficio del PP es su configuración dinámica, es decir, la posibilidad de cambiar la configuración o gateways en los cuales se procesa el pago sin la necesidad de generar o utilizar nuevos PPs.

## Relación del Payment Point y los gateways

Cuando un pago es ejecutado dentro de MYMOID, este es procesado a través de un PP, el cuál es el encargado de decidir sobre que gateway dicho pago va a ser ejecutado y a su vez cuál será el nivel de seguridad empleado en el mismo (3DS, No 3DS, MoTo, etc.)

Dicho esto, cabe destacar que para "decidir" cual será el gateway encargado de la ejecución del pago, este debe ser establecido/configurado previamente dentro del PP correspondiente.