> For the complete documentation index, see [llms.txt](https://tafi.gitbook.io/tafi-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tafi.gitbook.io/tafi-api/api-rest/openapi.md).

# Solicitud de Crédito

Este endpoint permite a los clientes afiliados a **TAFI** solicitar crédito para realizar pagos en comercios que acepten este método de pago. Utilizando el cupo disponible en su cuenta de Tafi, los usuarios pueden financiar sus compras de manera rápida y sencilla, sin necesidad de recurrir a otros métodos de pago. La solicitud se gestiona de manera automática y el proceso de aprobación se comunica de forma inmediata al cliente.

<mark style="color:green;">`POST`</mark> `/creditos-ventas/solicitarCredito`

**Headers**

<table data-full-width="true"><thead><tr><th>Name</th><th>Value</th></tr></thead><tbody><tr><td>Content-Type</td><td><code>application/json</code></td></tr><tr><td>TAFI-API-KEY</td><td><code>API KEY</code></td></tr></tbody></table>

**Body**

<table data-full-width="true"><thead><tr><th>Nombre</th><th>Mandatorio</th><th>Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><code>idComercio</code></td><td>Y</td><td>string</td><td>ID provisto por el equipo de Tafi.</td></tr><tr><td><code>celular</code></td><td>Y</td><td>string</td><td>Número de celular del cliente pagador.</td></tr><tr><td><code>valor</code></td><td>Y</td><td>number</td><td>Monto a cobrar al cliente. Se admite solo hasta 2 decimales.</td></tr><tr><td><code>descripcion</code></td><td>N</td><td>string</td><td>Descripción del producto o servicio a entregar.</td></tr><tr><td><code>sucursal</code></td><td>N</td><td>string</td><td>Nombre o código de sucursal del comercio.</td></tr><tr><td><code>vendedor</code></td><td>N</td><td>string</td><td>Nombre o código de vendedor del comercio.</td></tr><tr><td><code>idTransaccion</code></td><td>Y</td><td>string</td><td>Id de la transaccion provista por el sistema del comercio.</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="1" %}

```json
{
    "idTransaccion": "001-000123",
    "valor": "111.67",
    "codigoRespuesta": 1,
    "numeroAutorizacion": "123456",
}
```

{% endtab %}

{% tab title="0" %}

```json
{
    "idTransaccion": "0000011109",
    "valor": 100,
    "codigoRespuesta": 0,
    "numeroAutorizacion": "",
    "descripcionError": "El número de celular no está asociado a TAFI"
}
```

{% endtab %}
{% endtabs %}

* **Valor "1"**: La transacción ha sido **aceptada**. Esto indica que la solicitud de crédito o pago ha sido validada correctamente y se puede proceder con la operación.
* **Valor "0"**: La transacción ha sido **rechazada**. Esto significa que la solicitud no ha sido validada. ver más detalles en el campo "descripcionError".

{% openapi src="/files/RQEOmY7yPrhrLcNXMyGF" path="/creditos-ventas/solicitarCredito" method="post" %}
[tafi-Tafi-1.0.0-oas3-swagger (2).yaml](https://3731400750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx1iY0PT7MSAqRhK9XlbU%2Fuploads%2FlOpV9qRqvkkUfv9TUhFc%2Ftafi-Tafi-1.0.0-oas3-swagger%20\(2\).yaml?alt=media\&token=a8183a27-8dae-45de-acd7-4a47bd4fb787)
{% endopenapi %}