Skip to main content
POST
Depois de registrar o domínio e hospedar o arquivo de verificação, chame esta rota para que o processador confira o arquivo. Quando a conferência passa, o domínio fica verified e o botão Apple Pay pode ser usado nas páginas desse hostname.

Quando usar

Antes de chamar

  • Use a chave secreta (sk_) no seu backend.
  • O usuário dono da chave precisa da permissão de domínios Apple Pay (perfis Owner, Manager e Desenvolvedor).
  • Publique o conteúdo de verificationFile.content em https://<seu-dominio>/.well-known/apple-developer-merchantid-domain-association: caminho sem extensão, Content-Type: text/plain, HTTPS válido, resposta 200, sem redirecionamento e sem autenticação.
Confira antes de validar:

Parâmetros de caminho

string
required
Identificador do registro de domínio, devolvido por POST /v1/apple-pay/domains. Ex.: 2xYq8Lm3NcR7tVb1KdZ4wP6sQhE.
Esta rota não tem corpo.

Respostas

A resposta 200 é o objeto Domínio atualizado (os campos estão em Registrar domínio). Quando a conferência passa, vem status: "verified" e verifiedAt preenchido. Quando a conferência falha, a API responde 422 APPLE_PAY_DOMAIN_VERIFICATION_FAILED, o domínio passa a failed, verifiedAt volta a null e o motivo fica em lastVerificationError. Consulte com GET /v1/apple-pay/domains/{id} para ler o motivo. Os erros APPLE_PAY_* vêm no formato { "code": "...", "message": "..." }, sem statusCode. Os erros 401 e 403 seguem o formato padrão, com statusCode.
O domínio está pronto quando esta rota responde 200 com status: "verified" para o hostname exato da página do checkout.

Erros comuns

Veja também

Validar sessão

Próximo passo: a chamada feita pelo navegador.

Guia de Apple Pay

Exemplos de hospedagem em Node.js e Nginx.