> For the complete documentation index, see [llms.txt](https://aplazo.gitbook.io/aplazo-integrations/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aplazo.gitbook.io/aplazo-integrations/espanol/referencia-de-api/online-api/consulta-el-estado-de-un-pago.md).

# Consulta el estado de un pago

## Environments

{% tabs %}
{% tab title="Development" %}
{% embed url="<https://merchant.aplazo.net/api>" %}
{% endtab %}

{% tab title="Production" %}
<https://merchant.aplazo.mx/api>
{% endtab %}
{% endtabs %}

{% hint style="warning" %}
You can query the payment status either by `loanId` or `cartId` . You should only choose one.
{% endhint %}

{% openapi src="/files/9LjWj62EfrRCRGt9S68y" path="/v1/loan/status" method="get" %}
[openapi3\_20250109.yaml](https://content.gitbook.com/content/UR1kwlS8DiKsSq3rCVB5/blobs/hZMypjMkbiYLv5efPBB0/openapi3_20250109.yaml)
{% endopenapi %}

## Response Examples

### Success

<details>

<summary> <mark style="color:green;">200</mark> - Sucess - query with cart_id</summary>

{% code overflow="wrap" %}

```bash
curl --location 'https://merchant.aplazo.net/api/v1/loan/status?cart_id=some-cart' \
--header 'Authorization: Bearer <token here>'
```

{% endcode %}

**Response**

{% code overflow="wrap" %}

```json
{
    "loanId": 159004,
    "status": "CANCELADO / DEVUELTO"
}
```

{% endcode %}

</details>

### Errors

<details>

<summary> <mark style="color:red;">404</mark> - CartId not found</summary>

{% code overflow="wrap" %}

```bash
curl --location 'https://merchant.aplazo.net/api/v1/loan/status?cart_id=some-cart' \
--header 'Authorization: Bearer <token here>'
```

{% endcode %}

**Response**

{% code overflow="wrap" %}

```json
{
    "message": "loan by CartId = some-cart was not found.",
    "code": "LOAN_NOT_FOUND",
    "params": [
        "CartId",
        "some-cart"
    ],
    "payload": null
}
```

{% endcode %}

</details>

<details>

<summary> <mark style="color:red;">400</mark> - Invalid query parameter</summary>

{% code overflow="wrap" %}

```bash
curl --location 'https://merchant.aplazo.net/api/v1/loan/status?cart_idx=3201' \
--header 'Authorization: Bearer <token here>'
```

{% endcode %}

{% code overflow="wrap" %}

```json
{
    "message": "Card ID (cart_id) or Loan ID (loan_id) are required",
    "code": "LOAN_STATUS_NEED_CARTID_OR_LOANID",
    "params": null,
    "payload": null
}
```

{% endcode %}

</details>