Configurar callbacks de carteiras dedicadas: da criação ao crédito
Encaminhe cada recarga
Uma carteira dedicada associa um endereço de recebimento persistente a um membro ou identificador de negócio. Definir a URL de callback na criação manual encaminha as notificações de pagamento confirmado ao receptor correto. Isso não altera o endereço de recebimento nem a titularidade dos fundos.
Preencha a URL na criação
Na lista de carteiras do comerciante, selecione Criar wallet, escolha o ativo e a rede compatíveis e selecione Carteira dedicada. Informe o identificador do membro (bind_key) e a URL de callback opcional, usando um endereço HTTPS público completo. Confira a rede e o ativo antes de enviar.
Confira a configuração padrão
A URL dedicada atende às notificações desta carteira. Deixar em branco não salva um novo destino específico; o encaminhamento segue as configurações da ordem e do callback padrão do comerciante. Se usar o padrão, confira se está habilitado e correto. Salvar uma URL não confirma que o receptor processa as notificações.
Valide e credite uma única vez
Salve o vínculo entre membro, endereço, rede e ativo. Verifique a assinatura com callbackSecret conforme a documentação e confira ordem, ativo, rede e valor antes de creditar. Use uma restrição de unicidade e uma transação no banco para impedir créditos duplicados. O endereço da carteira não é uma chave única para cada depósito.
Teste o fluxo completo
Valide a URL salva, a entrega, a assinatura, o crédito e a recuperação de falhas. Em produção, use HTTPS público. Reutilizar um bind_key existente pode retornar a carteira original; criá-la novamente não atualiza sua configuração. Confira os dados atuais.
Mantenha os registros
Guarde o número da ordem, hash da transação, resultado do callback e registro do crédito. Confirmação da transferência, entrega do callback e atualização do saldo são etapas distintas; concilie-as ao investigar problemas.
Solução de endereços dedicados · Documentação API · Planos e tarifas