Chaves PIX
O namespace pixKeys guarda as chaves PIX do jogador, usadas como destino dos saques (withdrawals.request({ amount, pixKeyId })). Todos os métodos exigem login.
Listar
const keys = await enginex.pixKeys.list()
const preferred = keys.find((k) => k.isDefault) ?? keys[0]
// { id, keyType: 'cpf', maskedKeyValue: '***.456.789-**', isDefault: true, verified: true, createdAt }O valor completo da chave nunca volta do gateway: só maskedKeyValue, para exibir. verified indica se o serviço de pagamento já confirmou a titularidade.
Cadastrar
const key = await enginex.pixKeys.add({ keyType: 'email', keyValue: 'ana@exemplo.com' })
key.maskedKeyValue // masked version, e.g. 'a***.com'keyType é 'cpf', 'email', 'phone' ou 'random' (chave aleatória). Tipo ou valor vazio é recusado com INVALID_ARGUMENT (400); chave inválida ou repetida volta como erro do serviço de pagamento — trate pelo code (veja Erros).
Chave padrão e remoção
await enginex.pixKeys.setDefault({ keyId: key.id }) // becomes the one suggested for withdrawals
await enginex.pixKeys.remove({ keyId: oldKey.id })Os dois resolvem sem valor; liste de novo para atualizar a tela. Um id inexistente (ou de outro jogador) chega como erro do gateway, em geral NOT_FOUND.
Saque sem chave salva
Não é obrigatório cadastrar a chave antes: withdrawals.request também aceita pixKeyType + pixKeyValue na hora, e com pixKeyType: 'cpf' usa o CPF do cadastro sem precisar do valor.