Introdução
A integração Ripple DP 2.0 permite que clientes da Parfin conectem uma conta Ripple como uma contraparte OTC, habilitando:
Visibilidade de saldo no Portfolio
Exportação de relatórios (Balances, Transactions e Trades) para conciliação e auditoria
Uso da Ripple no SOR (CaaS Manager) para cotar e executar operações
Criação de pagamentos a partir de cotações (quote → pagamento/saque)
Como funciona
Conceito geral
A Ripple é disponibilizada como uma contraparte OTC chamada Ripple DP 2.0. Após conectar e aprovar a conexão:
O cliente consegue consultar saldos
Consegue cotar e executar via SOR (quando habilitado e configurado)
Consegue exportar relatórios vinculados à conexão
Regras e premissas importantes
Conexão vinculada a um Beneficiary (beneficiário) único.
- Cada conexão Ripple fica associada a um único beneficiário, identificado pelo Beneficiary Nickname.
- Ao cadastrar uma nova conexão o sistema faz a seguinte validação do Beneficiary Nickname:
- Deve existir na Ripple e ser único;
- Se não existir ou existir duplicado, a conexão não é criada;
- Beneficiário associado à conexão não pode ser alterado depois de conectado. Se precisar trocar, é necessário criar uma nova conexão.
Pares disponíveis não vêm automaticamente da Ripple.
- A Ripple não fornece um endpoint (API) para listar pares habilitados por cliente.
- Os pares precisam ser cadastrados, via suporte, para uso no SOR. O cadastro é pares é por conexão.
Passo a passo
Conectar a Ripple
Acesse Settings → Counterparties
Clique em + Connect Counterparty
Selecione:
Type: OTC
Counterparty: Ripple DP 2.0
Preencha:
Account Name (nome livre para identificar a conexão)
Credenciais de autenticação, geradas na plataforma da Ripple (Client ID, Audience, Credentials)
Beneficiary Nickname (deve ser exatamente o mesmo nickname cadastrado no portal da Ripple)
Clique em Submit e conclua o fluxo com 2FA
O que o sistema valida ao conectar
Credenciais: precisam ser válidas
Beneficiary Nickname:
precisa existir na Ripple
precisa ser único (não pode haver mais de um beneficiário com o mesmo nickname)
Possíveis mensagens de erro:
Credenciais inválidas: “Invalid Credentials. Please try again.”
Beneficiário não encontrado: “Unable to find beneficiary with the provided Nickname.”
Beneficiário duplicado: “Multiple beneficiaries found with the same nickname. Please choose a unique one.”
⚠️Importante: após criada, a conexão fica permanentemente associada ao beneficiário informado.
Fluxo de aprovação (Governança)
Após a criação, a conexão passa pelo fluxo de aprovação da instância (governança).
A contraparte só fica disponível para uso completo (ex.: no SOR) quando estiver aprovada.
Habilitar a Ripple no SOR (CaaS Manager)
Para utilizar a Ripple no SOR, existem dois passos essenciais:
Passo 1 — Ter a conexão Ripple ativa
A conexão precisa estar criada e aprovada (ativa)
Passo 2 — Solicitar ao suporte o cadastro dos pares por conexão (obrigatório)
Como os pares habilitados não vêm automaticamente da Ripple, o cliente deve abrir um chamado com o suporte para cadastrar os pares da conexão.
No chamado, o cliente deve informar:
- Obrigatório
- Pares habilitados (ex.: USDT/BRL, USDC/USD, etc.)
- Casas decimais permitidas, usando a Base Currency como referência
- Opcional
- Valor máximo, usando a Base Currency como referência
- Valor mínimo, usando a Base Currency como referência
- Custo mínimo, usando a Quote Currency como referência
Sem esse cadastro, a conexão pode existir, mas não estará pronta para operar corretamente via SOR.
Cotar e executar no SOR
Cotação (Quote)
Conexões Ripple ativas/aprovadas aparecem como opção no SOR
A cotação só poderá ser feita após a configuração dos pares para a conexão da Ripple
Execução (Quote aceito → pagamento)
- Na Ripple, aceitar/executar um Quote significa criar um pagamento.
- Em cenários onde “Trades/execução estejam habilitados" (Trades ON no RFQ Execution Settings), aceitar um quote significa criar um pagamento para aquele beneficiário cadastrado na conexão.
- Em cenários onde “Trades/execução estejam desabilitados" (Trades OFF no RFQ Execution Settings), aceitar um quote não cria um pagamento para aquele beneficiário cadastrado na conexão.
Quando o pagamento é criado com sucesso:
o quote é considerado executado
e entra em monitoramento até finalização (completude ou falha) do pagamento, que pode ocorrer dentro de alguns minutos ou dias.
O status desse pagamento pode ser acompanhado de duas formas:
Relatório RFQ - Ledger Details, pela coluna "Trade Status".
Via Webhook, pelo campo "Exchange > Status" na entidade Order.
Notificações e Alertas
Monitoramento de pagamentos
Após execução, pagamentos podem permanecer em estados intermediários por algum tempo:
Enquanto o pagamento estiver em andamento, a ordem aparece como WAITING
Quando o pagamento finaliza com sucesso, a ordem vai para CLOSED
Se o pagamento falhar, a ordem vai para CANCELED
Falha de pagamento (exposição)
Se um pagamento atingir estado final de falha, a plataforma:
registra o evento
e envia e-mail de exposição para os admins da instância
Visibilidade e Relatórios
Relatórios de Balance
A plataforma disponibiliza:
Balances (Amount): posição por ativo (quantidade)
Balances (USD): posição por ativo + valorização em USD (para auditoria/visão financeira)
Relatório de Transactions
Lista apenas pagamentos concluídos na Ripple (somente finalizados)
Serve para conciliação do histórico de saques/pagamentos executados via Ripple DP 2.0
Inclui detalhes da transação para auditoria (resposta original)
Relatório de Trades
Lista apenas operações concluídas na Ripple (somente finalizadas)
Considera “trade executado” como pagamento concluído
Perguntas Frequentes (FAQ)
Eu conectei a Ripple. Já posso usar no SOR imediatamente?
Não. Além da conexão estar ativa/aprovada, é preciso solicitar ao suporte o cadastro dos pares habilitados para aquela conexão.Posso alterar o Beneficiary Nickname depois que a conexão foi criada?
Não. O beneficiário fica fixo na conexão. Para trocar, você precisa criar uma nova conexão.A conexão falhou com mensagem de beneficiário. O que isso significa?
Significa que o nickname informado não existe na Ripple ou existe duplicado (mais de um beneficiário com o mesmo nickname). O nickname precisa ser válido e único.Quanto tempo um pagamento pode levar para finalizar?
Pode variar de minutos a dias, dependendo do método, país e sistema de clearing. A plataforma monitora até chegar ao estado final.O que acontece se um pagamento falhar depois que eu executei?
A ordem é marcada como CANCELED, e o sistema gera e-mail de exposição para os administradores da instância.Por que meus Trades/Transactions não aparecem no relatório?
Os relatórios listam apenas pagamentos finalizados. Se ainda estiver em processamento, ele pode aparecer como “em andamento” (WAITING) na plataforma, mas só entra no report quando finaliza.