---
title: "Reservar saldo para efetuar o pagamento de uma conta"
method: POST
path: "/v5/transactions/billpayments"
---

# Reservar saldo para efetuar o pagamento de uma conta

`POST /v5/transactions/billpayments`

Realiza a reserva de um valor da sua conta Celcoin para a execução de um pagamento. Veja o nosso [artigo](https://developers.celcoin.com.br/docs/pagamento-de-contas-1#reservar-saldo-para-efetuar-o-pagamento-de-uma-conta-billpayments) e saiba como realizar a implementação dessa API.

Entenda quais são os erros que essa API poderá retornar ao realizar a reserva de saldo, [clique aqui](https://developers.celcoin.com.br/docs/tabelas-de-erros#tabela-de-erros-da-api-de-reserva-de-saldo)

## Request body

- object
  - `externalTerminal` string — Identificador do terminal do sistema cliente
  - `externalNSU` integer — Identificador da transação do sistema cliente
  - `cpfCnpj` string, required — CPF ou CNPJ do cliente que está realizando o pagamento
  - `billData` object, required — Define o valor a ser pago
    - `value` number, double — Valor a ser pago.
    - `originalValue` number, double, required — Valor nominal do título a ser pago.
    - `valueWithDiscount` number, double, required — Valor calculado de descontos e abatimentos.
    - `valueWithAdditional` number, double, required — Valor calculado de juros e multa.
  - `infoBearer` object — Nome do portador do pagamento
    - `nameBearer` string — Nome do portador.
    - `documentBearer` string — CPF ou CPNJ do portador.
    - `methodPaymentCode` integer — Meio de pagamento - 1 (Espécie), 2 (Débito Em Conta), 3 (Cartão de Credito) e 4 (Cheque).
  - `barCode` object, required
    - `type` integer, required — Tipo da conta a ser consultada, onde ficha de compensação deve ser populado com o número 2 e concessionária 1
    - `digitable` string — Linha digitável
    - `barCode` string — Código de barras
  - `dueDate` string, date — Data vencimento retornada no endpoint authorize
  - `transactionIdAuthorize` integer — ProtocoloId retornado no endpoint authorize

## Response `200`

200

## Other responses

- `400` — 400
- `401` — 401
- `500` — 500

---

[API](https://skmtc.net/celcoin/apis/api-para-transa-es.md) · [All operations](https://skmtc.net/celcoin/apis/api-para-transa-es/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/celcoin/api-para-transa-es/revisions/85dd6188a37b/schema)