# Como criar e aprovar um pagamento em uma única chamada?

> O campo `autoApprove` no endpoint `POST /api/v1/payment` permite criar e aprovar um pagamento Pix em uma única requisição, eliminando a necessidade de chamar o endpoint `/api/v1/payment/approve` separadamente.

## Criando e aprovando um pagamento em uma única chamada

## Como usar

Envie `autoApprove: true` no corpo da requisição ao criar um pagamento:

```json
{
  "value": 100,
  "destinationAlias": "c4249323-b4ca-43f2-8139-8232aab09b93",
  "destinationAliasType": "RANDOM",
  "comment": "pagamento comentário",
  "correlationID": "payment-1",
  "autoApprove": true
}
```

## Resposta

Quando `autoApprove: true` e o pagamento é aprovado, a resposta traz o `payment` com status `APPROVED`:

```json
{
  "payment": {
    "value": 100,
    "status": "APPROVED",
    "destinationAlias": "c4249323-b4ca-43f2-8139-8232aab09b93",
    "destinationAliasType": "RANDOM",
    "comment": "pagamento comentário",
    "correlationID": "payment-1",
    "sourceAccountId": "6823414a524ed520d3518dd6"
  }
}
```

> **Importante:** a resposta imediata do `autoApprove` **não** retorna o campo `destination` (dados bancários do recebedor). Como o Pix é enviado de forma assíncrona, o status muda para `CONFIRMED` (ou `FAILED`) depois da liquidação. Para obter os dados do recebedor (`destination`) e da transação (`endToEndId` etc.), use uma das opções abaixo:
>
> - o webhook [`OPENPIX:MOVEMENT_CONFIRMED`](../webhook/examples/payment-payload.mdx), que carrega `destination`; ou
> - uma consulta `GET /api/v1/payment/{correlationID}` após a confirmação.

Consultando o pagamento depois de confirmado, a resposta inclui `transaction` e `destination`:

```json
{
  "payment": {
    "value": 100,
    "status": "CONFIRMED",
    "correlationID": "payment-1",
    "sourceAccountId": "6823414a524ed520d3518dd6"
  },
  "transaction": {
    "value": 100,
    "endToEndId": "E...",
    "time": "2025-01-01T00:00:00.000Z"
  },
  "destination": {
    "name": "Dan",
    "taxID": "31324227036",
    "pixKey": "c4249323-b4ca-43f2-8139-8232aab09b93",
    "bank": "A Bank",
    "branch": "0001",
    "account": "123456"
  }
}
```

## Comportamento sem o flag

Quando `autoApprove` é omitido ou `false`, o pagamento é criado normalmente com status `CREATED` e pode ser aprovado posteriormente via [`POST /api/v1/payment/approve`](./payment-how-to-use-api-to-approve-a-payment.md).

```json
{
  "payment": {
    "value": 100,
    "status": "CREATED",
    "correlationID": "payment-1"
  }
}
```

## Saldo insuficiente

Ao tentar aprovar com saldo insuficiente, a requisição retornará erro `400`:

```json
{
  "error": "You do not have enough balance to make this payment"
}
```

## Referência da API

Acesse a documentação completa do endpoint em [API Reference](/api#tag/payment-request-access/POST/api/v1/payment).