Voltar ao site
Conceitos

Merchant e X-Merchant-Id

Como indicar em qual loja a operação acontece.

Página em construção

Este é um resumo. O conteúdo completo entra nas próximas versões da documentação; o contrato de cada rota já está na Referência da API.

  • A organização do parceiro vem do token, nunca do corpo da requisição.
  • Credencial de organização: envie X-Merchant-Id: mrc_<32 hexadecimais> nas rotas de loja. Sem ele, 400 MERCHANT.HEADER_REQUIRED.
  • Credencial de merchant: o header é opcional; ausente, vale o merchant da credencial. Outro mrc_ responde 403 MERCHANT.FORBIDDEN.
  • Merchant de outra organização, inexistente ou malformado responde sempre 403 MERCHANT.FORBIDDEN, nunca 404.
  • merchantId no corpo é ignorado.
  • Webhooks e eventos aceitam o header como opcional: sem ele, a operação vale para a organização inteira.