---
title: "Realizar Recarga"
method: POST
path: "/topup"
---

# Realizar Recarga

`POST /topup`

Confira nosso tutorial -> https://developers.celcoin.com.br/docs/realizar-uma-recarga

## Request body

- object
  - `account` string, required — número da conta que está realizando a recarga
  - `clientRequestId` string, required — identificador fornecido para realizar a transação.
  - `signerCode` string — código do assinante para recargas de televisão
  - `amount` number, double, required — valor da recarga
  - `providerId` integer, required — id do provedor da recarga
  - `tags` object[] — identificadores do cliente
    - `key` string
    - `value` string
  - `topupData` object
    - `countryCode` integer, required — DDI do telefone
    - `number` string, required — número que vai realizar a recarga
    - `stateCode` integer, required — DDD do telefone

## Response `200`

200

- object
  - `version` string
  - `status` string
  - `body` object
    - `id` string
    - `documentNumber` string
    - `providerDescription` string
    - `signerCode` string
    - `account` string
    - `clientRequestId` string
    - `amount` number
    - `providerId` integer
    - `tags` object[]
      - `key` string
      - `value` string
    - `topupData` object
      - `countryCode` integer
      - `number` string
      - `stateCode` integer

## Other responses

- `400` — 400

---

[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/versions/85dd6188a37b/schema)