Registar
Porque funciona

O que obtém

De saldo para saldo, de imediato

Se o destinatário também tiver uma wallet Rox Pay, os fundos passam diretamente de um saldo para o outro e ficam logo disponíveis.

Veja a quem está a pagar

Introduza o código ou pesquise pelo nome: a Rox Pay mostra-lhe o nome do destinatário e pede confirmação antes de mover o dinheiro.

Registado dos dois lados

Cada transferência aparece nos movimentos de quem envia e de quem recebe, com contraparte, código, descritivo e saldo antes e depois.

Onde o usa

A partir do painel, do mapa ou do seu software

Painel

Enviar dinheiro

Pesquise uma empresa ou uma pessoa pelo nome, ou cole o código. Escolha o saldo, o montante e um descritivo, e confirme.

Receber

O código da sua empresa

Cada wallet tem um código (CMP- para empresas, USR- para pessoas). Copie-o e partilhe-o: quem o usar envia-lhe dinheiro diretamente para a wallet.

Mapa

Mapa de comerciantes

Encontre os negócios que aceitam Rox Pay e envie dinheiro diretamente a partir da ficha do comerciante. Aparecer no mapa é uma escolha de cada negócio.

API

API REST v5

Dois endpoints para enviar e consultar transferências a partir do seu software, com chave de idempotência, códigos de erro e transferências agendadas.

Como funciona

Uma transferência em quatro passos

O dinheiro não passa por um cartão nem por uma transferência bancária: move-se entre dois saldos Rox Pay. Antes de cada envio, a plataforma verifica o destinatário, o saldo e os limites.

  • Encontre o destinatário: pesquise uma empresa ou pessoa pelo nome, ou introduza o código CMP- ou USR-.
  • Verifique: a Rox Pay resolve o código e mostra-lhe o nome registado. Wallets inativas e envios para si próprio são bloqueados.
  • Envie: escolha o saldo (EUR ou outra moeda da wallet), o montante e um descritivo opcional, e confirme.
  • Creditado: os fundos ficam de imediato no saldo do destinatário e a transferência aparece nos movimentos de ambos.
  • Irrevogável: depois de confirmada, a transferência não pode ser anulada. Por isso a verificação vem primeiro.
O saldo é verificado antes do envio: se os fundos disponíveis não chegarem, a transferência não sai.
  1. 1 Encontre Nome ou código
  2. 2 Verifique Nome confirmado
  3. 3 Envie Montante e descritivo
  4. 4 Creditado Logo no saldo
Movimentos de quem envia
Oficina Rossi, Lda. Saída · Fatura 2026/118 −250,00 €
Movimentos de quem recebe
Estúdio Bianchi Entrada · Fatura 2026/118 +250,00 €
Destinatário verificado · Saldo verificado · Irrevogável
Funcionalidades

O que inclui, em detalhe

Destinatário verificado

O código é resolvido no servidor antes do envio. Erros específicos para código inválido, destinatário inexistente ou wallet ainda não ativa.

Saldos multimoeda

Escolha a partir de que saldo da wallet enviar. Se não tiver saldo na moeda indicada, a transferência é recusada antes de mover dinheiro.

Transferências agendadas

Por API pode indicar uma data futura (fuso Europe/Rome). A transferência fica pendente e o saldo é verificado no dia da execução.

Idempotency-Key

Envie um cabeçalho Idempotency-Key e repita a chamada em segurança: a mesma chave nunca move dinheiro duas vezes.

Histórico com filtros

Movimentos de entrada e saída filtráveis por direção, data, montante e texto livre, com estado da transferência e saldo antes e depois.

Erros legíveis por máquina

Cada recusa devolve um ErrorCode (por exemplo INSUFFICIENT_BALANCE ou SELF_TRANSFER), para que o seu software reaja sem interpretar texto.

Wallet e conta bancária

Entre wallets, para o banco ou à entrada: cada movimento tem a sua ferramenta

A transferência entre wallets é a forma mais rápida de pagar a quem já usa Rox Pay. Para levar os fundos para a conta bancária ou carregar a wallet há ferramentas próprias, no mesmo painel e nas mesmas API.

Wallet → Wallet

Transferência entre wallets

Para outra empresa ou pessoa com wallet Rox Pay. Crédito imediato no saldo, de 1 € a 5.000 € por transferência, destinatário verificado.

Wallet → IBAN

Levantamento para a conta bancária

Transfira o saldo disponível para uma conta bancária associada quando quiser, ou com o levantamento automático. Aplica-se a comissão de levantamento prevista.

Carregamento

Carregamento da wallet

Adicione fundos ao saldo em EUR com um pagamento a partir da sua conta bancária (pay by bank) ou com um cartão verificado guardado na wallet.

Quer perceber que fluxo se adapta aos seus pagamentos? Falamos consigo.

Fale connosco
Controlos

Os controlos que se aplicam a cada transferência

As regras são as mesmas no painel e nas API: um único ponto de controlo para montantes, destinatário e saldo.

Só a partir da própria wallet

Ninguém envia em nome de terceiros, nem parceiros nem administradores

Destinatário verificado

Código resolvido, wallet ativa, sem envios para si próprio

Saldo disponível

Disponível menos reservas, verificado antes do envio

Sem envios duplicados

Idempotency-Key em cada chamada API

Conheça a nossa infraestrutura de segurança
Para programadores

Dois endpoints, uma transferência

Autenticação com token Bearer, montantes em cêntimos, respostas JSON com ErrorCode legível. A wallet que envia é sempre a da empresa a que pertence o token.

POST /api/v5/wallet/transfer
Pedido
Authorization: Bearer <token>
Idempotency-Key: "inv-2026-118"

{
  "BeneficiaryCode": "CMP-20260121-037118B5BFCB",
  "Amount": 25000,
  "Currency": "EUR",
  "Purpose": "Fatura 2026/118"
}
Resposta · 200
{
  "Result": true,
  "Message": "Transfer executed successfully.",
  "Recipient": { "Type": "company", "DisplayName": "…" }
}
Endpoints disponíveis
POST /api/v5/wallet/transfer Envie ou agende uma transferência

BeneficiaryCode, Amount em cêntimos, Currency e Purpose opcionais. Com OperationDate a transferência é apenas reservada e executada na data indicada.

Idempotency-KeyTransferências agendadasErrorCode legíveis
GET /api/v5/wallet/transfers Liste as transferências recebidas e enviadas

Filtros por direção, intervalo de datas, montante mínimo e máximo e texto livre. Paginação até 100 linhas, saldo antes e depois em cada transferência.

Direction incoming / outgoingFiltros de data e montanteSaldo antes e depois
Casos de uso

Quem usa, e para quê

Pagar a fornecedores e parceiros na Rox Pay

Pague a um fornecedor ou parceiro que já tem wallet Rox Pay: sem IBAN para copiar, com o nome verificado e o descritivo guardado no histórico.

Reembolsos e pagamentos a pessoas

Envie dinheiro para a wallet pessoal (USR-) de colaboradores, funcionários ou clientes, por exemplo para reembolsar despesas.

Várias empresas, um só acesso

Se gere várias empresas na Rox Pay, move fundos entre as respetivas wallets em poucos cliques, cada uma com o seu histórico.

Pagamentos automáticos a partir do seu software

O seu software chama a API para enviar ou agendar transferências e lê o histórico para atualizar os registos.

Pague a quem usa Rox Pay num instante.

Ative as transferências entre wallets para a sua empresa ou integre-as no seu software com as API.

Contacte-nos →

Perguntas frequentes sobre transferências entre wallets

Encontre respostas às perguntas mais frequentes

Ver perguntas frequentes