# 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"
    ]
}
```