> This page is for Internet banking (beta).

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.api.corpx.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.api.corpx.com/_mcp/server.

# Pagar

PIX, TED, boleto e transferência interna saem da **sua** conta. O corpo é
o mesmo do contrato público; o que muda é o host e a assinatura.

Host: `https://client.api.corpx.com`. Toda escrita leva `Idempotency-Key`
(entra na string canônica). Valores em BRL, no máximo 2 casas decimais.

Não envie `X-Transaction-Pin` nem `X-Acting-Document`. A credencial prova
posse com chave privada e IP. PIN e travas de horário são da tela do
titular — veja [Travas](/ib/guias/conta/seguranca).

## PIX por chave

Antes, se quiser mostrar o nome: `GET /v1/accounts/{accountId}/pix/key/{pixKey}`.
A transferência consulta o DICT de qualquer forma.

A chave vai no path no formato do DICT e codificada como segmento de URL: CPF e
CNPJ só dígitos, telefone com `+55` (`%2B5511999998888`), e-mail com o `@`
codificado (`fulano%40exemplo.com`), chave aleatória como o UUID. Telefone sem
`+55` é lido como CPF. Exemplos e o que não funciona em
[Consultas de chave PIX](/baas/guias/pagar/consulta-dict#como-montar-a-chave-na-url).

**Assine o path codificado**, exatamente como ele vai na requisição:
`/v1/accounts/{accountId}/pix/key/fulano%40exemplo.com`, não
`.../fulano@exemplo.com`. Ver
[Assinatura de requisição](/ib/guias/autenticacao/assinatura-de-requisicoes).

```bash
curl -X POST "https://client.api.corpx.com/v1/accounts/$ACCOUNT_ID/pix/out" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Tenant-Id: $TENANT_ID" \
  -H "Idempotency-Key: $UUID" \
  -H "Content-Type: application/json" \
  -H "X-Request-Timestamp: $TS" \
  -H "X-Content-SHA256: $SHA" \
  -H "X-Request-Signature: $SIG" \
  -d '{
    "amount": 100.00,
    "keyType": "CPF",
    "key": "12345678901",
    "description": "Pedido 12345",
    "identifier": "order-12345"
  }'
```

| Campo         | Obrigatório | Notas                                  |
| ------------- | ----------- | -------------------------------------- |
| `amount`      | Sim         | ≥ 0,01; 2 casas                        |
| `keyType`     | Sim         | `CPF`, `CNPJ`, `EMAIL`, `PHONE`, `EVP` |
| `key`         | Sim         | Conforme o tipo                        |
| `description` | Não         | Máx. 140                               |
| `identifier`  | Não         | Sua conciliação; aparece no extrato    |

A conta de origem é o `{accountId}` do path. A API confere saldo
disponível antes de enviar.

| HTTP | Status típico         | O que fazer                                                                     |
| ---- | --------------------- | ------------------------------------------------------------------------------- |
| 200  | `COMPLETED`           | Pronto                                                                          |
| 202  | `TIMEOUT` / `PENDING` | Indeterminado: olhe extrato ou webhook antes de reenviar                        |
| 207  | timeout do parceiro   | Igual: não assuma débito nem crédito                                            |
| 422  | `FAILED`              | Recusa imediata (`partner_rejected`, `insufficient_funds`, `pix_key_not_found`) |

`PENDING_APPROVAL` nas consultas significa que o **liquidante** reteve a
ordem (antifraude), não que falte uma aprovação sua. `TIMEOUT` não é
final: a API continua consultando por até 7 dias e, se liquidar ou
recusar, você recebe `pix.out.completed` / `pix.out.failed` com
`late: true` e o mesmo `paymentId`.

Para volume, prefira `POST .../pix/out/async` (`202` na hora). Síncrono
tem limite por conta (hoje 100 req/min; a tendência é 10).

Há também PIX por dados bancários (`.../pix/out/bank-account` e
`.../async`) e pagamento de QR (`.../pix/out/qr-code/async` — o síncrono
está deprecado). O path legado `POST /v1/pix-out` (accountId no corpo)
foi removido e responde `410 gone`: use sempre
`POST /v1/accounts/{accountId}/pix/out`.

## Consultar um PIX enviado

* `GET /v1/accounts/{accountId}/pix/transactions?endToEndId=` (ou
  `identifier`)
* `GET /v1/accounts/{accountId}/pix/payments` e
  `.../pix/payments/lookup`

Para esperar o desfecho sem consultar em laço, chame o lookup com
`waitForFinalStatus` (segundos, no máximo 10). A resposta vem quando o PIX
chega a `COMPLETED`, `FAILED` ou `REVERSED`, ou quando o prazo acaba, com o
último estado lido. Se o PIX nunca apareceu no liquidante, volta `404`. Só o
lookup aceita o parâmetro, e o timeout do cliente precisa ser de pelo menos
20 s com `waitForFinalStatus=10`.

Webhooks: `pix.out.completed`, `pix.out.failed`, `pix.out.timeout`.

## Devolver um PIX recebido

`POST /v1/accounts/{accountId}/pix/out/refund` com o E2E original. Dá
para devolver em partes, cada uma com `Idempotency-Key` e `identifier`
próprios. Prazo BACEN: 90 dias. Sem o E2E, pegue-o no extrato, no
webhook `pix.in.completed` ou no lookup do QR.

```json
{
  "originalEndToEnd": "E36741675202601281435001234567",
  "amount": 150.00,
  "reason": "user-requested"
}
```

## TED

`POST /v1/accounts/{accountId}/ted/out` — assíncrono (`202`,
`status: PROCESSING`). Janela BACEN: dias úteis 06:30–17:00. Fora dela,
agenda para o próximo dia útil.

```json
{
  "value": 5000.00,
  "bankCode": "001",
  "branch": "1234",
  "account": "56789",
  "accountType": "CHECKING",
  "taxNumber": "12345678900",
  "holderName": "JOAO DA SILVA",
  "description": "NF 12345",
  "identifier": "fornecedor-acme-2026-05"
}
```

`bankCode` é Compe de **3** dígitos. ISPB de 8 dígitos é recusado
(`400 invalid_bank_code`). O par COMPE/ISPB para o dropdown está em
[Catálogo de bancos](/ib/guias/apis-adicionais/bancos). Consulte
`GET /v1/accounts/{accountId}/ted/{tedId}`. Webhooks: `ted.out.requested`,
`ted.out.confirmed`, `ted.out.failed`.

No dia a dia, PIX costuma ser a melhor escolha (24/7, instantâneo). TED
cabe quando a contraparte só aceita TED ou o valor passa do teto PIX da
conta.

## Boleto

1. `POST /v1/accounts/{accountId}/boleto/preview` com a linha digitável.
2. Pague o `totalUpdated` do preview — não o valor de face. Em título
   vencido os dois diferem; o liquidante recusa qualquer outro valor
   (`422 boleto_amount_mismatch`).
3. `POST /v1/accounts/{accountId}/boleto/pay` → sempre `202`,
   `paymentId` no formato `bol_{uuid}`.
4. `GET /v1/accounts/{accountId}/boleto/payments/{paymentId}`.

Refaça o preview no dia do pagamento: juros e multa mudam.

## Transferência interna

Entre contas do mesmo banco, sem PIX. Instantânea.

| Destino            | Path                                          |
| ------------------ | --------------------------------------------- |
| `accountId` da API | `POST .../transfers/internal`                 |
| Agência e conta    | `POST .../transfers/internal/by-bank-account` |
| CPF/CNPJ           | `POST .../transfers/internal/by-document`     |

Há um preview de nome em
`GET .../transfers/internal/lookup/{document}` (primeiro nome por
extenso; demais sobrenomes viram inicial + `***`).

## Idempotência

A `Idempotency-Key` é a identidade da **tentativa HTTP**. Repetir a mesma
chave, o mesmo path e o mesmo corpo devolve o resultado original — não um
segundo débito. Trocar o corpo com a mesma chave é conflito. Detalhe:
[Idempotência](/baas/guias/comece-aqui/idempotencia).

O `identifier` no corpo é a sua chave de conciliação. Os dois convivem.

## Travas do titular

Se o pagamento voltar `423 cashout_locked`, `403 cashout_outside_hours`
ou `403 cashout_source_ip_not_allowed`, o titular configurou bloqueio,
janela ou lista de IPs no internet banking. Leia o que está em vigor em
[Travas](/ib/guias/conta/seguranca). Você não altera essas travas pela API.