Configurar gateways de pagamento de terceiros
Traga seus próprios gateways de pagamento de terceiros para processar pagamentos e emitir reembolsos. Configure e adicione gateways de pagamento externos e conecte-os ao Billing.
Edições obrigatórias
| Disponível em: Lightning Experience |
| Disponível em: Edições Enterprise, Unlimited e Developer com Revenue Cloud |
| O recurso Pagamentos do Salesforce está disponível com a licença Revenue Cloud Billing, com um custo por modelo de transação para os gateways de pagamento nativos e Traga seu próprio. Entre em contato com seu executivo de conta do Salesforce para obter mais informações. |
| Se você comprou a licença do Revenue Cloud Billing em julho de 2025 ou antes, entre em contato com seu executivo de conta do Salesforce para adicionar o recurso Pagamentos do Salesforce à sua licença existente. |
| Permissões de usuário necessárias | |
|---|---|
| Para configurar recursos de pagamento de terceiros: | Conjunto de permissões de Administrador de pagamento |
Configuração inicial para configurar o gateway de pagamento de terceiros
Antes de configurar gateways de pagamento de terceiros, conclua as tarefas preparatórias para estabelecer uma conexão entre sua organização do Salesforce e seu gateway de pagamento de terceiros preferido. Você precisa destes detalhes para começar.
- Uma conta de comerciante de comércio eletrônico e uma chave de API
- Adaptadores de classes do Apex e o nome do adaptador
- Credenciais nomeadas para autenticar seu gateway de pagamento de terceiros
- Um site de gateway de pagamento de terceiros que está registrado na sua organização do Salesforce
- Um site do Salesforce que tem acesso ao gateway de pagamento de terceiros
-
Crie uma conta de comerciante de comércio eletrônico no gateway de pagamento de terceiros que você deseja implementar.
- Faça login em seu provedor de gateway de pagamento de terceiros e adicione uma conta de comerciante de comércio eletrônico.
-
Navegue até a seção de configurações avançadas, de gerenciamento de chaves ou de desenvolvedor da plataforma de gateway de pagamento escolhida e gere uma chave de API ou uma chave secreta.
Sua chave de API teria a seguinte aparência:
AQEvhmfxJ43HaxxHw0m/n3Q5qf3Ve4pBCIBMV3dVwyD4zesmTx/rk8/RZRz2w0bDdqMQwV1bDb7kfNy1WIxIIkxgBw==-C5bPe6tPCqOM35AEGroDa54J1Bl9AnsQKrDsDofVlrk=-i1ibf$Hu2v>8jR:Y9nU. - Anote o nome do usuário da conta do comerciante e a chave de API. Você precisa deles para criar as credenciais nomeadas.
-
Crie suas classes do Apex do gateway de pagamento em sua organização do Salesforce.
-
Obtenha os detalhes da classe do adaptador do seu provedor de gateway de pagamento ou AppExchange.
Para criar e configurar adaptadores de gateway de pagamento, consulte Adaptadores de gateway de pagamento. Para definir suas classes do Apex, consulte Namespace de Pagamentos comerciais.
- Salve suas classes do Apex. Anote o nome do adaptador conforme necessário para criar seu provedor de gateway de pagamento.
-
Obtenha os detalhes da classe do adaptador do seu provedor de gateway de pagamento ou AppExchange.
-
Crie uma credencial nomeada legada em sua organização do Salesforce para especificar parâmetros de autenticação e o URL do seu ponto final de chamada do Apex.
- Especifique um nome fácil de usar para o rótulo e um identificador exclusivo para o nome.
- Insira o URL do seu gateway de pagamento de terceiros.
- Selecione Entidade de segurança nomeada como o tipo de identidade e Autenticação por senha como o protocolo de autenticação.
- Use o nome do usuário da conta do comerciante como o nome de usuário. Use a chave de API como senha conforme exigido pelo seu provedor de gateway de pagamento.
- Salve as credenciais nomeadas de que você precisa para criar seu gateway de pagamento.
-
Registre seu site de gateway de pagamento de terceiros em sua organização do Salesforce para garantir que as chamadas do Apex da organização para o site de gateway de pagamento sejam bem-sucedidas.
- Insira um nome e um URL para seu gateway de pagamento de terceiros.
- Marque o site como ativo e salve suas alterações.
-
Adicione o URL do gateway de pagamento de terceiros como um URL confiável na sua organização do Salesforce.
- Insira um nome de API.
- Insira o URL do seu gateway de pagamento de terceiros.
- Marque o URL como ativo e salve suas alterações.
-
Habilite e configure seu site do Salesforce para enviar e receber notificações de pagamentos de seu gateway de terceiros.
- Insira um rótulo, um nome e uma página inicial para seu site.
- Defina as configurações de acesso público do site para Acesso de convidado à API de pagamentos.
- Salve os detalhes do seu site.
Definir configurações de notificação em seu gateway de pagamento de terceiros
O gateway de pagamento usa um webhook para enviar notificações ao seu adaptador de gateway de pagamento. Um webhook é uma combinação do ponto de extremidade do seu site e do ID do provedor de gateway de pagamento. Crie um webhook fornecendo um URL nas configurações de transporte de notificação padrão do seu gateway de pagamento de terceiros.
-
Use esse URL como ponto final do seu site, substituindo
MyDomainNamepelo domínio e URL do seu site. Por exemplo:https://MyDomainName.my.salesforce-sites.com/solutions/services/data/v65.0/commerce/payments/notify -
Localize o ID do provedor do gateway de pagamento e anexe o parâmetro de consulta
?provider=IDao ponto de extremidade. Por exemplo,https://MyDomainName.my.salesforce-sites.com/solutions/services/data/v65.0/commerce/payments/notify?provider=0cJR00000004CEhMAM - Insira o webhook nas configurações de notificação padrão do seu gateway de pagamento de terceiros.
Configurar o provedor de gateway de pagamento e o gateway de pagamento
Adicione um provedor de gateway de pagamento depois de configurar sua conta de comerciante, suas classes de adaptador e seu site do Salesforce. Em seguida, adicione um gateway de pagamento no provedor de gateway de pagamento.
- Em Configuração, na caixa Busca rápida, insira Faturamento e selecione Etapa 7: Configurações de pagamento na Configuração guiada.
-
Expanda a etapa Configurar gateways de pagamento de terceiros, clique em Configurar gateways de pagamento e, em seguida, clique em Configurar.
NotaPara organizações do Salesforce criadas na versão Winter '26, o botão Configurar gateways de pagamento na Etapa 7: Configurações de pagamento da Configuração guiada de faturamento, que redireciona os usuários para a guia Configuração do gateway de pagamento, está disponível por padrão. Para organizações do Salesforce criadas antes da versão Winter '26, a guia Configuração do gateway de pagamento não está disponível por padrão. Para corrigir esse problema, altere as configurações da guia Configuração do gateway de pagamento para Padrão ativado.
-
Preencha estes campos para criar um provedor de gateway de pagamento.
- Insira um nome exclusivo e um rótulo para seu provedor de gateway de pagamento.
- Selecione a classe do adaptador do Apex na lista suspensa.
- Especifique seu suporte necessário para idempotency. Para obter mais detalhes, consulte Directivas de idempotência.
- Salve os detalhes do provedor do gateway de pagamento.
-
Preencha estes campos para adicionar um gateway de pagamento.
- Insira um nome exclusivo para seu gateway de pagamento.
- Selecione um provedor de gateway de pagamento na lista suspensa.
- Selecione uma credencial nomeada na lista suspensa.
- Marque o status do seu gateway de pagamento como Ativo.
- Salve os detalhes do gateway de pagamento.
Se você já tiver um provedor de gateway de pagamento, selecione Etapa 7: Configurações de pagamento na Configuração guiada, expanda a etapa Configurar gateways de pagamento de terceiros e clique em Configurar gateways de pagamento. Na página Configuração do gateway de pagamento, clique em gateways de pagamento e depois em Novo. As etapas de configuração são as mesmas.
Adicionar várias formas de pagamento
Configure o suporte para métodos de pagamento, como Casa de compensação automatizada (ACH), Área única de pagamentos em euros (SEPA), Serviços de compensação automatizados de bancários (BACS) e Sistema de compensação eletrônica em massa (BECS) em seu gateway de pagamento de terceiros. Você pode processar pagamentos, emitir reembolsos e visualizar esses métodos de pagamento salvos na guia Métodos de pagamento salvos do seu perfil de faturamento.
-
Para adicionar métodos de pagamento bancário, como ACH, SEPA, BACS e BECS, use a API tokenizePaymentMethod e defina a propriedade
bankTypeno objetobankPaymentMethodpara o método de pagamento bancário escolhido. -
Para adicionar métodos de pagamento por cartão, como cartão de crédito ou cartão de débito, use a API tokenizePaymentMethod e defina a propriedade
cardCategoryno objetocardPaymentMethod.

