Skip to main content
Com estes endpoints dá para conectar um domínio próprio sem abrir o painel. O fluxo completo:
1

Adicione o domínio

POST /api/v1/domain com { "domain": "loja.seudominio.com.br" }. A resposta já traz dns_records.
2

Crie os registros DNS

No provedor do domínio, crie todos os registros de dns_records: o CNAME que aponta para a loja e o TXT de verificação. name é o nome completo do registro; host é o que digitar em painéis que pedem só a parte antes do domínio (@ é a raiz).
3

Verifique

POST /api/v1/domain/{id}/verify. Enquanto o DNS propaga, o status segue PENDING; repita depois de alguns minutos. A plataforma também confere sozinha a cada minuto.
4

Defina como principal

Com o status VERIFIED, PATCH /api/v1/domain/{id}/primary faz a loja responder nesse domínio.
Domínio que não for verificado em 24 horas é removido automaticamente (verification_expires_at). Se isso acontecer, adicione de novo: o valor do TXT muda.
Cada loja pode ter até 5 domínios. O primeiro domínio adicionado já nasce como principal, mas só passa a valer depois de verificado.