Cadastro cripto da loja

O cadastro cripto da loja é exigido apenas para sacar o saldo da loja (POST /crypto/withdrawals). Cadastrar clientes, receber depósitos e pagar clientes funcionam sem ele.

O Pix do saque sai de uma conta no nome da própria empresa, por isso o provedor precisa verificar a empresa (KYC) antes.

Como fazer

O cadastro é feito pelo painel, não pela API:

1. No painel, abra Verificação KYC › aba Cripto.
2. Escolha pessoa jurídica (CNPJ) ou pessoa física (CPF). A identidade é sempre o documento cadastrado da empresa.
3. Abra o link dos termos e aceite; depois abra o link de KYC e envie os documentos.
4. Quando o provedor aprovar, a aba mostra o cadastro como ativo e a loja já pode sacar.

O que a API responde enquanto o cadastro não está pronto

POST /crypto/withdrawals responde 409 merchant_wallet_not_ready, sem reservar saldo nem criar nada no provedor:

{
  "error": "merchant_wallet_not_ready",
  "message": "Conclua o cadastro cripto da empresa para sacar",
  "status": "PENDING",
  "kycLink": "https://…",
  "tosLink": "https://…"
}

status	Significado
NOT_STARTED	O cadastro ainda não foi iniciado no painel. Links nulos.
PENDING / IN_REVIEW	Cadastro iniciado, aguardando documentos ou análise.
REJECTED	Recusado; o painel permite tentar de novo.
ACTIVE com reason	Aprovado, mas a conta da loja ainda está sendo preparada (wallet_missing, wallet_chain_mismatch) ou o documento da empresa mudou (document_changed). Tente de novo em alguns minutos; se persistir, fale com o suporte.

Os links só vêm para a empresa que iniciou o cadastro.