Quando um vendedor cadastra dados bancários incorretos, mesmo que plataforma tenha avisos para garantir que o vendedor cadastre os dados corretos, normalmente o vendedor pode realizar a alteração pelo próprio formulário.

Contudo, se o vendedor já estiver com saldo pendente de recebimento, os gateways não permitem que a conta seja alterada, por questões de segurança. E, por isso, a única maneira de alterar os dados nessas situações é através de requisições à API dos gateways, por exemplo, via Postman.

Antes de mais nada, se o erro foi porque a conta do vendedor termina em: "X" basta manter em 0, pois nossa versão dos gateways (moip e pagar.me) não aceitam letras como parâmetro no digito verificador.

Como alterar esses dados por API? Verifique o passo a baixo abaixo para a Wirecard e na sequencia na Pagar.me.

1º - WIRECARD (MOIP)

1 - Acesse a tabela dbo.Person no banco de dados ou acesse na plataforma como administrador e busque pelo vendedor especifico, ao clicar em seu perfil, obtenha na URL o SellerID:

2 - Acesse o banco de dados, preferencialmente em uma copia local por garantias (bacpac), e execute a seguinte Query (substituindo o 'SELLER_ID'):

SELECT *
  FROM [dbo].[GatewayRegistrationLog]
  Where SellerId = 'SELLER_ID'

Exemplo:

Obtenha o "GatewayApiToken", busque sempre o token mais atual, pois essa tabela é um histórico de alterações, então podem haver várias para o mesmo usuário, conforme atualiza os dados bancários manualmente ou se o houve troca de gateway na plataforma.

2 - Esse código GatewayApiToken será utilizado como autenticação (OAuth 2.0) no Postman, para você poder enviar a requisição.

3 - Em seguida, obtenha o código da conta bancária "GatewayBankAccountId" desse usuário nessa mesma tabela dbo.GatewayRegistrationLog (para a Wirecard, é um código que inicia com 'BKA-')

4 - Utilize o endpoint "https://api.moip.com.br/v2/bankaccounts/BKA-##########" alterando a parte "/BKA-##########" pelo "GatewayBankAccountId"

Recomendamos utilizar o verbo GET antes do PUT para guardar as informações (JSON) em um arquivo de texto (backup).

6 - Em seguida, montar um objeto JSON conforme o modelo abaixo e enviar um PUT com os novos dados para realizar a atualização dos dados.

7 - Antes de seguir valide se o tipo de conta bancária confere (CHECKING para contas correntes ou SAVING para poupanças), bem como se é conta jurídica ou física (se for jurídica, vc deve alterar o 'taxDocument' de CPF para CNPJ).

8 - Valide tudo o que puder validar, para ter certeza que os dados estão corretos conforme o que deve ser, no caso da wirecard, estar atento ao formato do número da agência e conta (zeros a esquerda), referência:

Como cadastrar corretamente dados bancários na Conta da Wirecard?

Se necessário, você pode validar se a conta bancária é válida: Validação de contas bancárias

Se a conta não tiver digito verificador, utilize aspas duplas sem espaço.

Modelo:

{
    "bankNumber": "001",
    "agencyNumber": "1234",
    "agencyCheckNumber": "9",
    "accountNumber": "12345",
    "accountCheckNumber": "8",
    "type": "CHECKING",
    "holder": {
        "taxDocument": {
            "type": "CPF",
            "number": "123.456.789-01"
        },
        "fullname": "NOME COMPLETO DA PESSOA"
    }
}

2º - Pagar.me

1 - Acesse a tabela dbo.Person no banco de dados o acesse na plataforma como administrador e busque pelo vendedor especifico, ao clicar em seu perfil, obtenha na URL o SellerID:

2 - Acesse o banco de dados, preferencialmente em uma copia local por garantias (bacpac), e execute a seguinte Query (substituindo o 'SELLER_ID'):

SELECT *
  FROM [dbo].[GatewayRegistrationLog]
  Where SellerId = 'SELLER_ID'

Exemplo:

Obtenha o GatewayRecipientId mais atual (pode ser verificado na coluna CreatedAt), pois esta tabela é um histórico de alterações, então podem haver várias para o mesmo usuário:

2 - Utilize esse modelo de endpoint para consulta: https://api.pagar.me/1/recipients/re_#####
Substitua o "re_#####" pelo GatewayRecipientId copiado anteriormente.

Feita a URL insira no Postman no verbo GET.

3 - Clique em Authorization e mude o Type para Basic Auth.
Username: ApiKey da plataforma
Senha: x

Para saber a apiKey você pode obter em seu gateway de pagamento ou na plataforma, acessando em Configuração >> payment/pagarMe:

4 - Finalizado a requisição clique em Send no verbo GET e copie o resultado em um bloco de notas (Control+A/ Control+C):

5 - Agora você deve copiar os parâmetros necessário para o arquivo JSON.

Utilizando as referencia que copiou no bloco de notas para a nova request.
Encontre no bloco de notas o campo que inicia com "bank_account", copie todo o campo até a chave "}" depois de "date_created" :

**Opcional: caso queira criar ou entender o código por completo use esse artigo em "Atualizando um recebedor" e insira os parâmetros que copiou no bloco de notas.

6 - Monte a request conforme o modelo abaixo.
Insira uma chave "{" antes de "bank_account" e mais uma chave de fechamento ao final "}"

Obs.: em "date_created", utilize a data e hora atual que está alterando os dados:

{
"bank_account":{
"object":"bank_account",
"id":111111,
"bank_code":"001",
"agencia":"1234",
"agencia_dv":"0",
"conta":"012345678",
"conta_dv":"0",
"type":"conta_corrente",
"document_type":"cpf",
"document_number":"123456789",
"legal_name":"Nome Vendedor",
"charge_transfer_fees":true,
"pix_key":null,
"date_created":"2021-07-02T21:34:48.760Z"
}
}

7 - Com os campos copiados, cole no Postman mudando o verbo para PUT, inserindo a nova request em Body → raw → JSON .

Altere ou mantenha os parâmetros necessários:

• "id" : GatewayBankAccountId do banco de dados (lembre-se de utilizar o mais atualizado):

• "bank_code": Código do banco da conta;

• "agencia": Agencia do banco da conta;

• "agencia_dv": Apenas números, deve conter somente 1 dígito;

• "conta": Número da conta;

• "Type": Tipo da conta. Parâmetros aceitos: conta_corrente, conta_poupanca, conta_corrente_conjunta, conta_poupanca_conjunta

• "conta_dv": Dígito verificador da conta;

• "document_number": CPF/CNPJ atrelado à conta;

• "legal_name": Nome/Razão social do dono da conta.