POST/api/v1/pagamentos/terminals

Criar

Esta API permite a criação de um novo terminal associado a um comerciante.

Parâmetros

Content-TypeObrigatório
header

application/json

Tipo:string
AcceptObrigatório
header

application/json

Tipo:string
AuthorizationObrigatório
header

Bearer {{TOKEN}}

Tipo:string

Descrição dos Campos de Requisição

  • serial_number: Número de série do terminal
  • logic_number: Número lógico do terminal
  • merchant_id: ID do comerciante (UUID)
  • model: Modelo do terminal
  • manufacturer: Fabricante do terminal
  • simcard_serial_number: Número de série do SIM card

Descrição dos Campos da Resposta

  • success: Booleano indicando o sucesso ou falha da operação
  • message: Mensagem informativa sobre o resultado da operação
  • data: Objeto contendo os dados do terminal criado
    • id: ID único do terminal (UUID)
    • merchant_id: ID do comerciante ao qual o terminal está associado (UUID)
    • serial_number: Número de série do terminal
    • logic_number: Número lógico do terminal
    • model: Modelo do terminal
    • manufacturer: Fabricante do terminal
    • simcard_serial_number: Número de série do SIM card
    • created_at: Data e hora de criação do terminal (formato ISO 8601)
    • updated_at: Data e hora da última atualização do terminal (formato ISO 8601)
curl --location --request POST 'https://api-h.nuvende.com.br/api/v1/pagamentos/terminals' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{TOKEN}}' \
--data '{
  "serial_number": "numero_de_serie_do_terminal",
  "logic_number": "numero_logico_do_terminal",
  "merchant_id": "id_do_comerciante",
  "model": "modelo_do_terminal",
  "manufacturer": "fabricante_do_terminal",
  "simcard_serial_number": "numero_de_serie_do_simcard"
}'
const axios = require("axios");

const data = {
  serial_number: "numero_de_serie_do_terminal",
  logic_number: "numero_logico_do_terminal",
  merchant_id: "id_do_comerciante",
  model: "modelo_do_terminal",
  manufacturer: "fabricante_do_terminal",
  simcard_serial_number: "numero_de_serie_do_simcard",
};

const config = {
  method: "post",
  url: "https://api-h.nuvende.com.br/api/v1/pagamentos/terminals",
  headers: {
    "Content-Type": "application/json",
    Accept: "application/json",
    Authorization: "Bearer {{TOKEN}}",
  },
  data: data,
};

axios(config)
  .then((response) => {
    console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
    console.log(error);
  });
import requests
import json

url = "https://api-h.nuvende.com.br/api/v1/pagamentos/terminals"

payload = {
    "serial_number": "numero_de_serie_do_terminal",
    "logic_number": "numero_logico_do_terminal",
    "merchant_id": "id_do_comerciante",
    "model": "modelo_do_terminal",
    "manufacturer": "fabricante_do_terminal",
    "simcard_serial_number": "numero_de_serie_do_simcard"
}

headers = {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'Authorization': 'Bearer {{TOKEN}}'
}

response = requests.post(url, headers=headers, data=json.dumps(payload))

print(response.text)
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api-h.nuvende.com.br/api/v1/pagamentos/terminals',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => json_encode(array(
    'serial_number' => 'numero_de_serie_do_terminal',
    'logic_number' => 'numero_logico_do_terminal',
    'merchant_id' => 'id_do_comerciante',
    'model' => 'modelo_do_terminal',
    'manufacturer' => 'fabricante_do_terminal',
    'simcard_serial_number' => 'numero_de_serie_do_simcard'
  )),
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'Accept: application/json',
    'Authorization: Bearer {{TOKEN}}'
  ),
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>
{
  "serial_number": "{{randomString}}",
  "logic_number": "{{randomString}}",
  "merchant_id": "{{merchantId}}",
  "model": "SPOS920",
  "manufacturer": "Pax",
  "simcard_serial_number": "GMS029810203"
}
{
  "success": true,
  "message": "Terminal created successfully",
  "data": {
    "id": "id_do_terminal_criado",
    "merchant_id": "id_do_comerciante",
    "serial_number": "numero_de_serie_do_terminal",
    "logic_number": "numero_logico_do_terminal",
    "model": "modelo_do_terminal",
    "manufacturer": "fabricante_do_terminal",
    "simcard_serial_number": "numero_de_serie_do_simcard",
    "created_at": "data_de_criacao",
    "updated_at": "data_de_atualizacao"
  }
}