Acessar minha contaAbrir uma conta
POST/api/v1/pagamentos/merchants

Cadastrar

Esta API permite a criação de um novo 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 da Requisição

  • pix_integration: Tipo de integração Pix
  • code: Código único do comerciante
  • name: Nome do comerciante
  • document: Documento do comerciante (CNPJ/CPF)
  • external_id: Identificador externo do comerciante
  • account_id: ID da conta associada
  • pix_key: Chave Pix do comerciante
  • channel_id: ID do canal (utilize a variável channelId)

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 comerciante criado
    • id: ID único do comerciante (UUID)
    • pix_integration: Tipo de integração Pix
    • code: Código do comerciante
    • name: Nome do comerciante
    • document: Documento do comerciante (ex: CNPJ, CPF)
    • account_id: ID da conta
    • pix_key: Chave Pix
    • account_token: Token da conta (pode ser null)
    • external_id: ID externo do comerciante
    • channel_id: ID do canal
    • created_at: Data e hora de criação (formato ISO 8601)
    • updated_at: Data e hora da última atualização (formato ISO 8601)
curl --location 'https://api-h.nuvende.com.br/api/v1/pagamentos/merchants' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{ access_token }}' \
--data '{
  "pix_integration": "external",
  "code": "{{$randomUUID}}",
  "name": "{{$randomCompanyName}}",
  "document": "{{randomCnpj}}",
  "external_id": "{{$randomUUID}}",
  "account_id": "{{$randomUUID}}",
  "pix_key": "{{$randomUUID}}",
  "channel_id": "{{partnerId}}"
}'

const axios = require("axios");

const data = {
  pix_integration: "external",
  code: "{{$randomUUID}}",
  name: "{{$randomCompanyName}}",
  document: "{{randomCnpj}}",
  external_id: "{{$randomUUID}}",
  account_id: "{{$randomUUID}}",
  pix_key: "{{$randomUUID}}",
  channel_id: "{{partnerId}}",
};

const config = {
  method: "post",
  url: "https://api-h.nuvende.com.br/api/v1/pagamentos/merchants",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer {{ access_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/merchants"

payload = {
    "pix_integration": "external",
    "code": "{{$randomUUID}}",
    "name": "{{$randomCompanyName}}",
    "document": "{{randomCnpj}}",
    "external_id": "{{$randomUUID}}",
    "account_id": "{{$randomUUID}}",
    "pix_key": "{{$randomUUID}}",
    "channel_id": "{{partnerId}}"
}

headers = {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer {{ access_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/merchants',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => json_encode(array(
    'pix_integration' => 'external',
    'code' => '{{$randomUUID}}',
    'name' => '{{$randomCompanyName}}',
    'document' => '{{randomCnpj}}',
    'external_id' => '{{$randomUUID}}',
    'account_id' => '{{$randomUUID}}',
    'pix_key' => '{{$randomUUID}}',
    'channel_id' => '{{partnerId}}'
  )),
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'Authorization: Bearer {{ access_token }}'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
?>

{
  "pix_integration": "external",
  "code": "{{$randomUUID}}",
  "name": "{{$randomCompanyName}}",
  "document": "{{randomCnpj}}",
  "external_id": "{{$randomUUID}}",
  "account_id": "{{$randomUUID}}",
  "pix_key": "{{$randomUUID}}",
  "channel_id": "{{partnerId}}"
}

{
  "success": true,
  "message": "Merchant created successfully",
  "data": {
    "id": "9dd1bb2b-93fe-4fde-aca8-46548820d26b",
    "pix_integration": "external",
    "code": "2c7ad2ee-db11-4e7c-87e2-1dce33c6049c",
    "name": "Bogan LLC",
    "document": "11222333000181",
    "account_id": "6c061b96-03c4-427a-ae11-7d93ef72c2f9",
    "pix_key": "c5716090-371f-450a-98a2-fb6442b92939",
    "account_token": null,
    "external_id": "6c0fccef-e9b3-429f-9ae0-7fa40ff8714b",
    "channel_id": "0591d83c-03a3-4fc6-8812-9baabb170843",
    "created_at": "2024-12-26T19:25:39+00:00",
    "updated_at": "2024-12-26T19:25:39+00:00"
  }
}