# Solicitar Mpos

{% hint style="info" %}
POST /Mpos/Solicitar
{% endhint %}

Autenticación: Usuario y contraseña de cuenta Wompi

### Objeto de petición:

<table><thead><tr><th valign="top">Campo</th><th valign="top">Es Requerido</th><th valign="top">Tipo Dato</th><th valign="top">Descripción</th></tr></thead><tbody><tr><td valign="top">nombre</td><td valign="top">Sí</td><td valign="top">String (max 250)</td><td valign="top">Nombre del solicitante</td></tr><tr><td valign="top">email</td><td valign="top">Sí</td><td valign="top">String (max 250)</td><td valign="top">Dirección de correo electrónico del solicitante</td></tr><tr><td valign="top">celular</td><td valign="top">Sí</td><td valign="top">String (max 14)</td><td valign="top">Número de celular del solicitante</td></tr><tr><td valign="top">direccionEntrega</td><td valign="top">Sí</td><td valign="top">String (max 500)</td><td valign="top">Dirección a la cual se debe entregar el dispositivo POS</td></tr><tr><td valign="top">idDepartamento</td><td valign="top">Sí</td><td valign="top">Int</td><td valign="top"><p>Identificador del departamento, se pueden obtener los departamentos disponibles en el Endpoint: GET</p><p>​/api​/Regiones</p></td></tr><tr><td valign="top">idMunicipio</td><td valign="top">Sí</td><td valign="top">Int</td><td valign="top"><p>Identificador del municipio, se pueden obtener los municipios disponibles en el Endpoint: GET</p><p>​/api​/Regiones</p></td></tr><tr><td valign="top">requiereCreditoFiscal</td><td valign="top">No (false por defecto)</td><td valign="top">Bool</td><td valign="top">Indica si se debe entregar un documento de crédito fiscal por la compra</td></tr><tr><td valign="top">nombreRazonSocial</td><td valign="top">Sí (solo si requiereCreditoFiscal es true)</td><td valign="top">String</td><td valign="top">Nombre o razón social del solicitante</td></tr><tr><td valign="top">numeroRegistro</td><td valign="top">Sí (solo si requiereCreditoFiscal es true)</td><td valign="top">String (formato: XXXXXX-X)</td><td valign="top">Número de registro de IVA del solicitante</td></tr><tr><td valign="top">giro</td><td valign="top">Sí (solo si requiereCreditoFiscal es true)</td><td valign="top">String (max 250)</td><td valign="top">Giro o actividad económica del solicitante</td></tr><tr><td valign="top">mpos</td><td valign="top">Sí</td><td valign="top">Lista</td><td valign="top">Listado de nombres amigables que tendrán los Mpos.</td></tr></tbody></table>

### Ejemplo de petición

```
{
  "nombre": "string",
  "email": "user@example.com",
  "celular": "string",
  "direccionEntrega": "string",
  "idDepartamento": 0,
  "idMunicipio": 0,
  "requiereCreditoFiscal": true,
  "nombreRazonSocial": "string",
  "numeroRegistro": "string",
  "giro": "string",
  "mpos": [
    "string"
  ]
}
```

### Objeto de respuesta

<table><thead><tr><th valign="top">Campo</th><th valign="top">Tipo Dato</th><th valign="top">Descripción</th></tr></thead><tbody><tr><td valign="top">paymentUrl</td><td valign="top">String</td><td valign="top">URL del enlace de pago</td></tr><tr><td valign="top">requestedMposData</td><td valign="top">Lista</td><td valign="top"> </td></tr><tr><td valign="top">requestedMposData:friendlyName</td><td valign="top">String</td><td valign="top">Nombre amigable del Mpos solicitado</td></tr></tbody></table>

### Ejemplo de respuesta

```
{
    "paymentUrl": "String",
    "requestMposData": [
        "friendlyName": "string"
    ]
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wompi.sv/metodos-api/solicitar-mpos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.