# Consulta de detalhes de parcelamento



#### URL base de solicitação <a href="#request-base-url" id="request-base-url"></a>

```
  Ambiente de Teste : https://gateway-test.pagsmile.com
  Ambiente de Prod : https://gateway.pagsmile.com
```

#### EndPoints <a href="#endpoints" id="endpoints"></a>

```
  /trade/installments
```

#### Cabeçalho de solicitação <a href="#request-header" id="request-header"></a>

| Parâmetro     | Obrigatório | Descrição                           |
| ------------- | ----------- | ----------------------------------- |
| Content-Type  | Recomendado | application/json                    |
| Authorization | sim         | Basic Base64(app\_id:security\_key) |

#### Corpo de solicitação (formato JSON) <a href="#request-body-json-format" id="request-body-json-format"></a>

| Parâmetro | Tipo    | Obrigatório | Comprimento máximo(ou valor padrão) | Descrição                     |
| --------- | ------- | ----------- | ----------------------------------- | ----------------------------- |
| app\_id   | string  | sim         | 32                                  | ID do aplicativo do dashboard |
| timestamp | string  | sim         | 19                                  | yyyy-MM-dd HH:mm:ss           |
| amount    | decimal | sim         | 0.01 \~ 99999999999999.99           | quantia                       |
| currency  | string  | sim         | 3                                   | moeda                         |

#### Exemplo de solicitação <a href="#request-sample" id="request-sample"></a>

```
curl --location --request POST 'https://gateway.pagsmile.com/trade/installments' \
--header 'Authorization: Basic Base64(appid:security_key)' \
--header 'Content-Type: application/json' \
--data-raw '{
    "app_id": "app_id",
    "timestamp": "{{datetime}}",
    "amount": "{{amount}}",
    "currency": "{{currency}}"
}'
```

#### Resposta Http (formato JSON) <a href="#http-response-json-format" id="http-response-json-format"></a>

| Parâmetro | Tipo                                                                                | Descrição       |
| --------- | ----------------------------------------------------------------------------------- | --------------- |
| code      | string                                                                              | return code     |
| msg       | string                                                                              | return msg      |
| fee       | List [Fee](https://developer.pagsmile.com/en/reference/installments-query.html#Fee) | fee detail list |

**Taxa**

| Parâmetro    | Tipo   | Descrição               |
| ------------ | ------ | ----------------------- |
| stage        | string | etapa das parcelas      |
| amount\_each | string | quantia de cada parcela |
| amount       | Fee    | quantia total           |

#### Retorno (Sucesso) <a href="#return-code-success" id="return-code-success"></a>

```
{
    "code": "10000",
    "msg": "Success",
    "fee": [
      {
        "stage":1,
        "amount_each":200.00,
        "amount":200.00
      },
      ...
    ]
}
```

#### Retorno (Falha) <a href="#return-code-fail" id="return-code-fail"></a>

```
{
    "code": "40002",
    "msg": "Business Failed",
    "sub_code": "invalid-signature",
    "sub_msg": "invalid signature"
}
```
