# Actualizar estado de pago

**Ejemplo de uso**

En el modelo de re-seller de ZapSign, puedes utilizar esta API para actualizar el estado de pago de tus clientes. Si un cliente se vuelve moroso, la API permite suspender automáticamente los beneficios del plan, garantizando que los servicios sean restringidos hasta que se regularice el pago.

De esta manera, si tu cliente está en mora, será posible suspender los beneficios del plan asignado.

#### **Cómo configurar**

Para utilizar esta funcionalidad, asegúrate de tener el API token del socio y el API token del cliente cuyo estado de pago deseas actualizar. Estos tokens son esenciales para realizar los cambios necesarios directamente a través de la API, manteniendo el control sobre la experiencia del cliente y la integridad de los servicios ofrecidos.

**Funcionamiento del Endpoint**

Al utilizar este endpoint, debes enviarnos el `api_token` de la **cuenta del cliente**, junto con el parámetro `payment_status`, que puede ser `"inadimplente"` (moroso) o `"adimplente"` (al día).

Nuestro sistema validará si el token utilizado para la autenticación en la API pertenece a la **cuenta principal** de la cuenta asociada al token enviado en el cuerpo de la solicitud (la cuenta del cliente). Si se cumple esta condición, la solicitud será aceptada.

* Si el estado es `"inadimplente"` (moroso):\
  El plan contratado por el cliente será **bloqueado**, restringiendo el acceso a los beneficios hasta que se regularice el pago.
* Si el estado es `"adimplente"` (al día):\
  El plan contratado será **desbloqueado**, restaurando el acceso completo a los servicios.

## **Actualizar estado de pago de un socio**

<mark style="color:green;">`POST`</mark> `https://api.zapsign.com.br/api/v1/partner/update-payment-status/`

**Headers**

| Name                                            | Type   | Description                                                                                              |
| ----------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------- |
| Authorization<mark style="color:red;">\*</mark> | string | <p>Token de API precedido por la palabra Bearer.<br>Ejemplo: Bearer c7f35c84-7893-4087-b4fb-d1f06c23</p> |

#### Request Body

| Name               | Type   | Description                                                                                        |
| ------------------ | ------ | -------------------------------------------------------------------------------------------------- |
| client\_api\_token | string | Token de API del socio (revendedor)                                                                |
| payment\_status    | string | "adimplente" (al día) o "inadimplente" (moroso), define el estado deseado de la cuenta del cliente |

{% tabs %}
{% tab title="Ejemplo de payload :" %}

```json
{
    "client_api_token": "f44f44e-sve2-4d01-8753-9e8fdf825e44cfe41581-fc98-4f81-8f0f-b8a184046421",
    "payment_status": "inadimplente"
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="200 OK – Estado actualizado con éxito" %}
{% code overflow="wrap" %}

```json
Status atualizado com sucesso.
```

{% endcode %}
{% endtab %}
{% endtabs %}


---

# 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.zapsign.com.br/espanol/re-sellers/actualizar-estado-de-pago.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.