---
title: "Reservar saldo para realizar o pagamento de uma recarga"
method: POST
path: "/v5/transactions/internationaltopups"
---

# Reservar saldo para realizar o pagamento de uma recarga

`POST /v5/transactions/internationaltopups`

## Request

- Base URL: `https://sandbox.openfinance.celcoin.dev`
- URL: `https://sandbox.openfinance.celcoin.dev/v5/transactions/internationaltopups`
- Auth: OAuth 2

## 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.
  - `cpfCnpj` string: CPF ou CNPJ do cliente. Esse campo deve ser preenchido sem nenhum caracter especial
  - `phone` object, required
    - `number` integer, required: Define o número para qual será designada a recarga (sem o código de discagem)
    - `countryCode` integer: Define o código de discagem do respectivo país
    - `stateCode` integer: Código do estado
  - `value` string: Valor da transação.
  - `topupProductId` string: Código do produto retornado no endpoint da consulta de valores.

## 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.dev/celcoin/apis/transfer-ncias.md) - [All operations](https://skmtc.dev/celcoin/apis/transfer-ncias/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/transfer-ncias/revisions/800929a1928e?raw)
