---
title: "Reservar saldo para realizar recarga"
method: POST
path: "/v5/transactions/topups"
---

# Reservar saldo para realizar recarga

`POST /v5/transactions/topups`

Essa API possibilita que seja realizada a reserva de um valor de sua conta Celcoin, para a execução de uma recarga. Para mais informações de como realizar essa implementação criamos o [artigo](https://developers.celcoin.com.br/docs/sobre-recargas-nacionais#reserva-saldo-para-realizar-recarga)

## Request body

- object
  - `externalTerminal` string — Terminal de identificação externa do sistema do cliente, Ex: CPF.
  - `externalNsu` integer — Identificador da transação do sistema cliente.
  - `topupData` object
    - `value` number, double — Valor da recarga.
  - `cpfCnpj` string, required — CPF ou CNPJ do cliente.
  - `signerCode` string — Código do assinante, identificador do cliente na operadora (não obrigatório em quase todas as recargas, exceto quando realizado assinaturas de TV(Sky TV, Claro TV, e Oi TV), onde deve ser enviado o código do assinante do usuário junto a operadora
  - `providerId` integer, required — Código da operadora, retornado na api de Retorna lista de operadoras.
  - `phone` object, required
    - `stateCode` integer, required — Código do estado atrelado ao número de telefone.
    - `countryCode` integer, required — Código do país.
    - `number` string, required — Número do telefone.

## Response `200`

200

- object
  - `nsuNameProvider` integer
  - `authentication` integer
  - `authenticationApi` object
    - `bloco1` string
    - `bloco2` string
    - `blocoCompleto` string
  - `receipt` object
    - `receiptData` string
    - `receiptformatted` string
  - `settleDate` string
  - `createDate` string
  - `transactionId` integer
  - `urlreceipt` string
  - `errorCode` string
  - `message` string
  - `status` integer

## 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)