Conceitos-chave e terminologia
Todos os artigos do REDA Pay usam um pequeno conjunto de termos. Cada um é um tipo de registro que você vê como guia no aplicativo REDA Pay (abra o Iniciador de aplicativos, a grade de nove pontos no canto superior esquerdo do Salesforce, e procure REDA Pay). A interface do REDA Pay está em inglês, por isso os nomes das guias e dos campos aparecem em inglês. Este artigo explica para que serve cada um e como se relacionam, com um exemplo contínuo: a Meridian Properties, uma administradora de imóveis que recebe aluguéis e depósitos.
O aplicativo REDA Pay. Cada conceito abaixo tem a sua própria guia.
Os registros de configuração
Um administrador os cria uma vez, e depois eles raramente mudam.
Pay Profile
Um Pay Profile (perfil de pagamento) conecta o Salesforce a uma conta da Payload. Ele guarda a chave de API da Payload, armazenada criptografada e informada apenas pelo botão Update API Token, e o endereço que a Payload usa para enviar atualizações de status de volta. Uma organização pode ter vários Pay Profiles, por exemplo um por empresa ou marca. Cada perfil tem um Pay Profile Code curto e único, que você usa para restringir os perfis que uma tela de pagamento oferece.
Exemplo: a Meridian Properties tem um Pay Profile, chamado "Meridian Properties", conectado à sua conta da Payload.
Processing Account
Uma Processing Account (conta de processamento) é uma conta de estabelecimento na Payload: a conta em que os pagamentos são creditados e de onde saem os repasses. Você não cria Processing Accounts à mão: o botão Sync Processing Accounts do Pay Profile as lê da Payload. Depois você configura cada uma no Salesforce: se aceita recebimentos, desembolsos ou ambos; quais métodos de pagamento aceita; sua moeda; por quanto tempo um link de pagamento fica válido; e o logotipo, o cabeçalho e o rodapé que o pagador vê. A maioria das suas regras fica aqui; consulte Configurar uma conta de processamento.
Exemplo: a "Meridian Operating Account" recebe os aluguéis; a "Meridian Fee Account" recebe as taxas de conveniência.
Fee Setup
Um Fee Setup é uma regra de taxa de conveniência abaixo de uma Processing Account, por exemplo "3% em todos os cartões" ou "$1.75 por pagamento bancário". A taxa é somada ao valor do pagamento e pode ser direcionada a outra Processing Account; consulte Configurar taxas de conveniência.
Os registros criados durante o trabalho
Pay Customer
Um Pay Customer é a pessoa ou a empresa de quem você recebe ou a quem paga, como conhecida por um Pay Profile. Raramente você cria um à mão: na primeira vez em que abre a tela de pagamento a partir de uma conta, um contato ou um lead, o REDA Pay cria o Pay Customer a partir desse registro. O registro de onde você partiu se chama registro pai, e o Pay Customer mantém um vínculo com ele. Um Pay Customer pode ter regras próprias, como os métodos de pagamento que pode usar; consulte Como os Pay Customers são criados.
Pay Method
Um Pay Method é um cartão ou uma conta bancária de um Pay Customer. Depois de registrado na Payload, seu nome passa a ser a descrição da Payload, como "Visa x-4242" ou "Checking x-7890". O Salesforce guarda um token e dados descritivos, nunca o número completo do cartão, o código de segurança ou o número da conta bancária. Um método pode ser o padrão do cliente e pode ser salvo para reutilização (Keep Active) ou usado uma única vez.
Pay Order
Uma Pay Order é a instrução para movimentar dinheiro: quem, quanto, de qual Processing Account, com qual Pay Method. As Pay Orders são numeradas como P-000000. Duas configurações definem cada ordem:
| Configuração | Valores | Significado |
|---|---|---|
| Transfer Type | Receipt · Disbursement | Um recebimento traz dinheiro; um desembolso paga dinheiro (só contas bancárias) |
| Order Type | Immediate · Schedule · Link | Immediate é processada agora; Schedule se repete conforme um agendamento; Link cria um link de pagamento que o cliente abre |
O campo Status combina as duas, por exemplo Immediate - Processed, Schedule - Active ou Link - Active. Status de ordens e transações lista todos os valores.
Exemplo: a ordem P-051847 pede $1,250.00 de aluguel da conta corrente de um morador; com a taxa bancária de $1.75, o Net Order Amount (o que de fato é cobrado) é $1,251.75.
Pay Transaction
Uma Pay Transaction é o que a Payload fez com uma Pay Order. As transações são numeradas como T-0000000 e ficam abaixo da ordem. Uma ordem pode ter várias: uma tentativa que falhou, depois um pagamento bem-sucedido, depois um reembolso. Cada transação tem um Type (payment, refund, credit), um Status (como processed, declined, voided, rejected ou refunded) e um Funding Status (como pending ou batched).
Statement Activity
Uma Statement Activity (atividade de extrato) é um depósito na sua conta bancária, ou uma saída dela, como informado pela Payload. Suas Transaction Activities listam os pagamentos individuais que o depósito contém, para que o financeiro associe cada depósito aos pagamentos que o compõem; consulte Conciliar depósitos e repasses.
REDA Pay Log
Um REDA Pay Log registra um trabalho em segundo plano que encontrou um erro, com as falhas anexadas em um arquivo. Os administradores recebem um email quando um é criado; consulte Quando um pagamento falha.
Como se relacionam
Pay Profile ── Processing Account ── Fee Setup
│
├── Pay Customer ── Pay Method
│ │ │
│ └──── Pay Order ────── Pay Transaction
│
└── Statement Activity ── Transaction Activity ──→ Pay TransactionUm Pay Customer, um Pay Method e uma Pay Order também se vinculam à conta, ao contato ou ao lead de onde vieram, e uma Pay Order pode se vincular a uma oportunidade, para que os pagamentos apareçam nos registros com que sua equipe já trabalha.
Mais três termos que você vai encontrar
| Termo | Significado |
|---|---|
| Tipo de usuário | O REDA Pay registra quem processou cada ordem: Internal (um usuário do Salesforce), Community (um usuário do portal com login) ou Guest (um visitante anônimo no seu site público). Várias regras, como a geolocalização e os depósitos de garantia, podem ser ativadas por tipo de usuário |
| Earnest Money Deposit (EMD) | Uma marcação em um recebimento bancário que o identifica como depósito de boa-fé; consulte Receber depósitos de garantia (EMD) |
| Webhook | A mensagem que a Payload envia ao Salesforce quando o status de um pagamento muda. O REDA Pay a usa para atualizar as Pay Transactions automaticamente; consulte Configurar webhooks |
Erros comuns a evitar
| Erro | O que acontece | Faça isto |
|---|---|---|
| Criar uma Processing Account à mão | Ela não tem vínculo com uma conta da Payload e não pode receber pagamentos | Use Sync Processing Accounts no Pay Profile |
| Digitar a chave de API no campo API Token | O valor não é criptografado e o REDA Pay não consegue lê-lo | Use o botão Update API Token |
| Deixar Allowed Pay Methods em branco em uma Processing Account ou em um Pay Customer | Nenhum método de pagamento pode ser usado | Escolha Card, Bank Account (ACH) ou ambos |
| Tratar o Principal Amount como o valor cobrado | O pagador é cobrado pelo Net Order Amount, que inclui a taxa | Use o Net Order Amount na conciliação |
Perguntas frequentes
A Pay Order é a sua instrução; a Pay Transaction é o resultado da Payload. Uma ordem que falhou uma vez e depois deu certo tem duas transações: uma failed e uma processed.
O Pay Customer guarda o que a Payload precisa (seu identificador de cliente, os métodos de pagamento permitidos e o método padrão) para um Pay Profile. Se você usar dois Pay Profiles, o mesmo contato pode ter dois Pay Customers.
Que a conta pode tanto receber pagamentos quanto enviar repasses. Uma Pay Order é sempre uma coisa ou outra.
O que vem a seguir
- Quem pode fazer o quê: conjuntos de permissões: dê a cada função o acesso certo.
- Roteiro de configuração: as etapas até o seu primeiro pagamento.