Credenciais e ambientes

O que você recebe na abertura da conta

Item	Formato	Para que serve
`clientId`	e-mail (ex.: `cliente.premium@grocers.io`)	usuário do Basic Auth
`clientSecret`	string opaca	senha do Basic Auth
`contractAccountId`	GUID	identifica o seu tenant em toda chamada
`commercialPolicyId`	GUID	política comercial padrão, usada em produto e preço

Autenticação

A API de integração usa HTTP Basic. O valor do header é o base64 de clientId:clientSecret:


# gera o header a partir das suas credenciais
printf '%s' 'cliente@empresa.com.br:seu-secret' | base64

Toda requisição precisa de dois headers:


Authorization: Basic Y2xpZW50ZUBlbXByZXNhLmNvbS5icjpzZXUtc2VjcmV0
x-contractAccountId: 3f2504e0-4f89-11d3-9a0c-0305e82c3301

Requisição sem Authorization recebe 401 sem corpo de resposta.

Chamada de verificação

Antes de integrar qualquer fluxo, confirme credencial e tenant com uma chamada barata:

curl


curl -i $GROCERS_API/v1/Clients \
  -H "Authorization: Basic $BASIC" \
  -H "x-contractAccountId: $TENANT"

Node.js


const baseUrl = process.env.GROCERS_API // base de integração do seu ambiente
const basic = Buffer.from(`${clientId}:${clientSecret}`).toString('base64')
 
const res = await fetch(`${baseUrl}/v1/Clients`, {
  headers: {
    Authorization: `Basic ${basic}`,
    'x-contractAccountId': contractAccountId
  }
})
 
console.log(res.status) // 200 = credencial e tenant válidos

C#


var basic = Convert.ToBase64String(
    Encoding.UTF8.GetBytes($"{clientId}:{clientSecret}"));
 
var baseUrl = configuration["Grocers:IntegrationBaseUrl"];
 
var http = new HttpClient { BaseAddress = new Uri($"{baseUrl}/") };
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", basic);
http.DefaultRequestHeaders.Add("x-contractAccountId", contractAccountId);
 
var response = await http.GetAsync("v1/Clients");

Ambientes

A base do serviço de integração é entregue na abertura da conta — um endereço para homologação e outro para produção, ambos terminando em /integration.

Ambiente	Quando usar	Base URL
Homologação	desenvolvimento e testes de carga	fornecida na abertura da conta
Produção	operação real	fornecida na abertura da conta

Nos exemplos desta documentação a base aparece como a variável $GROCERS_API. Exporte-a no seu shell antes de rodar os comandos:


export GROCERS_API="https://<sua-base>/integration"
export BASIC="$(printf '%s' 'clientId:clientSecret' | base64)"
export TENANT="3f2504e0-4f89-11d3-9a0c-0305e82c3301"