Pagamentos online

O Odoo integra vários provedores de pagamento para que seus clientes possam fazer pagamentos on-line, pelo portal do cliente ou no site de e-Commerce. Os clientes podem pagar pedidos de vendas, faturas ou assinaturas recorrentes pagas usando suas formas de pagamento preferidas, como cartões de crédito.

Cada provedor de pagamento está vinculado a uma lista de formas de pagamento compatíveis que podem ser (des)ativadas com base em suas necessidades.

Formulário de pagamento on-line

Nota

Os aplicativos Odoo delegam o manuseio de informações confidenciais ao provedor de pagamento certificado para que você nunca precise se preocupar com a conformidade com PCI. Nenhuma informação sensível (como números de cartão de crédito) é armazenada nos servidores Odoo ou em bases de dados Odoo hospedados em outro lugar. Em vez disso, os aplicativos Odoo usam um número de referência exclusivo para os dados armazenados com segurança nos sistemas dos provedores de pagamento.

Formas de pagamento aceitas

To access the supported payment providers, go to Accounting ‣ Configuration ‣ Payment Providers, Website ‣ Configuration ‣ Payment Providers, or Sales ‣ Configuration ‣ Payment Providers. Click the relevant payment provider card to access and configure the related provider.

Provedores de pagamento on-line

Fluxo de pagamento do

Tokenização

Captura manual

Reembolsos

Check-out expresso

Adyen

Odoo

Total e parcial

Total e parcial

Serviços de pagamento da Amazon

O site do provedor

AsiaPay

O site do provedor

Authorize.Net

Odoo

Somente total

Somente total

Buckaroo

O site do provedor

DPO Pay

O site do provedor

Flutterwave

O site do provedor

Iyzico

O site do provedor

Mercado Pago

O site do provedor

Mollie

O site do provedor

Nuvei

O site do provedor

Paymob

O site do provedor

PayPal

Odoo

Razorpay

Odoo

Somente total

Total e parcial

Redsys

O site do provedor

Stripe

Odoo

Somente total

Total e parcial

Worldline

O site do provedor

Xendit

Odoo or the provider’s website

✔ *

*

Refer to the Xendit documentation for more information.

Nota

  • Cada provedor tem seu próprio fluxo de configuração específico, dependendo de qual recurso está disponível.

  • Alguns desses provedores de pagamento on-line também podem ser adicionados como contas bancárias, mas esse não é o mesmo processo que adicioná-los como provedores de pagamento. Os provedores de pagamento permitem que os clientes paguem on-line, e as contas bancárias são adicionadas e configuradas no aplicativo Financeiro para fazer uma conciliação bancária.

Dica

Além dos provedores de pagamento regulares que se integram a uma API, como Stripe, PayPal ou Adyen, o Odoo inclui o provedor de pagamento Demo. Esse provedor de pagamento permite que você teste fluxos de negócios envolvendo pagamentos on-line. Não são necessárias credenciais, pois os pagamentos de demonstração são pagamentos fictícios.

Pagamentos bancários

  • Odoo displays your payment information with a payment reference. You have to approve the payment manually once it has been received in your bank account.
  • Customers can make a bank transfer to register a SEPA Direct Debit mandate and allow their account to be charged directly for future payments.

In-person payments

  • Customers can reserve products online and pay when collecting their orders in store.
  • Customers can pay for their orders upon delivery.

Ativação de um provedor de pagamento

Para adicionar um novo provedor de pagamento e disponibilizar os métodos de pagamento relacionados a ele para seus clientes, proceda da seguinte forma:

  1. Acesse o site do provedor de pagamento, crie uma conta e verifique se você tem as credenciais de API solicitadas para uso de terceiros. Elas são necessárias para que o Odoo se comunique com o provedor de pagamento.

  2. No Odoo, navegue até o Provedores de pagamento acessando Financeiro ‣ Configuração ‣ Provedores de pagamento, Site ‣ Configuração ‣ Provedores de pagamentos ou Vendas ‣ Configuração ‣ Provedores de pagamentos.

  3. Selecione o provedor e configure a aba Credenciais.

  4. Defina o campo Estado como Ativado.

Nota

  • Os campos disponíveis na aba Credenciais dependem do provedor de pagamento. Consulte a documentação relacionada para obter mais informações.

  • Depois de ativar o provedor de pagamento, ele é publicado automaticamente em seu site. Se você quiser cancelar a publicação, clique no botão Publicado. Os clientes não podem efetuar pagamentos por meio de um provedor não publicado, mas ainda podem gerenciar (excluir e atribuir a uma assinatura) os tokens existentes vinculados a esse provedor.

Modo de teste

Aviso

We recommend using the test mode on a duplicate or a test database to avoid potential issues with invoice numbering.

To try a payment provider without affecting live transactions, set the State field in the payment provider form to Test mode. Then, enter the provider’s dedicated test or sandbox credentials in the Credentials tab. Each payment provider has its own separate test account or environment for this purpose.

Nota

Por padrão, o provedor de pagamento permanece não publicado no modo de teste para que não fique visível para os visitantes.

Formas de pagamento

Cada provedor de pagamento está relacionado a uma lista de formas de pagamento suportados; os métodos listados no campo Formas de pagamento na aba Configuração do formulário do provedor de pagamento são os que foram ativados. Para ativar ou desativar um método de pagamento para um provedor, clique em Habilitar formas de pagamento e, em seguida, clique no botão de alternância do método relacionado.

Dica

  • To view the complete list of supported payment methods, go to Accounting ‣ Configuration ‣ Payment Methods, Website ‣ Configuration ‣ Payment Methods, or Sales ‣ Configuration ‣ Payment Methods.

  • Payment methods are displayed on the ecommerce website based on their sequence order. To reorder them, drag and drop the payment methods into the desired order in the Payment Methods list.

Ícones e marcas

The icons displayed next to the payment method on your website are either the icons of the brands activated for the payment method or, if there aren’t any, the icons of the payment methods themselves. To modify them, access the list of payment methods, then click the relevant one.

Para modificar o ícone de uma forma de pagamento, passe o mouse sobre a imagem no canto superior direito do formulário da forma de pagamento e clique no ícone (lápis).

Select the Brands tab to view the brands that have been activated for the payment method. The brands and their related icons are displayed based on their sequence order; to reorder them, drag and drop them into the desired order. To modify a brand’s icon, select the brand, then, in the popup window that opens, hover the mouse over the image in the upper-right corner and click the (pencil) icon.

Configuração avançada

To further configure payment methods, follow these steps:

  1. Ativar o modo modo de desenvolvedor.

  2. Access the list of payment methods and click the relevant one.

  3. Go to the Configuration tab and adjust the features as needed.

Perigo

  • Cada forma de pagamento é pré-configurada de modo a se alinhar com o comportamento dos provedores de pagamento e sua integração com o Odoo. Qualquer alteração nessa configuração pode resultar em erros e deve ser testada primeiro em uma base de dados duplicada ou de teste.

  • As modificações na configuração da forma de pagamento só funcionam até o limite dos recursos do método e do provedor. Por exemplo, adicionar países para uma forma de pagamento suportado somente em um país ou ativar a tokenização para um método vinculado a um provedor que não o suporta não produzirá os resultados pretendidos.

Tokenização

Se o provedor de pagamento suportar esse recurso <payment_providers/online_providers>, os clientes poderão salvar os detalhes de suas formas de pagamento para uso posterior. Para ativar esse recurso, vá para a aba Configuração do provedor de pagamento selecionado e ative Permitir salvar formas de pagamento.

In this case, a payment token is created in Odoo to be used as a payment method for subsequent payments without the customer having to enter their payment method details again. This is particularly useful for the eCommerce conversion rate and subscriptions that use recurring payments.

Dica

To add or delete their saved payment method details, customers can click Manage payment methods in the customer portal.

PCI DSS and Attestation of Compliance

Odoo is not PCI DSS-certified because it does not store cardholder data or process payments. Instead, it outsources tokenization and payment to external payment providers, which means that as an Odoo customer, you only need to complete the minimal Self-Assessment Questionnaire (SAQ) with the provider to obtain the Attestation of Compliance (AoC) and achieve PCI compliance. Odoo should not be mentioned as a payment processor or a third-party service provider in the SAQ.

Manual capture

If the payment provider supports this feature, you can authorize and capture payments in two steps instead of one. To enable this feature, go to the Configuration tab of the selected payment provider and enable Capture Amount Manually.

When you authorize a payment, the funds are reserved on the customer’s payment method but not immediately charged. They are charged when you manually capture the payment later on. You can also void the authorization to cancel it and release the reserved funds. Capturing payments manually is helpful in many situations:

  • Receive the payment confirmation and wait until the order is shipped to capture the payment.

  • Review and verify that orders are legitimate before the payment is completed and the fulfillment process starts.

  • Avoid potentially high refund fees for refunded payments: payment providers will not charge you for voiding an authorization.

  • Hold a security deposit to return later, minus any deductions (e.g., in case of damages).

To capture the payment after it was authorized, go to the related sales order or invoice and click the Capture Transaction button. To release the funds, click the Void Transaction button.

Nota

  • Some payment providers support capturing only part of the authorized amount. The remaining amount can then be either captured or voided. These providers have the value Full and partial in the table above. The providers that only support capturing or voiding the total amount have the value Full only.

  • The funds are likely not reserved forever. After a certain time, they may be automatically released back to the customer’s payment method. Refer to your payment provider’s documentation for the exact reservation duration.

  • Adyen and Stripe allow to capture payments manually directly from their website interface.

Reembolso

If your payment provider supports this feature, you can refund payments directly from Odoo. It does not need to be enabled first. To refund a customer payment, navigate to it and click the Refund button.

Nota

  • Some payment providers support refunding only part of the amount. The remaining amount can then optionally be refunded, too. These providers have the value Full and partial in the table above. The providers that only support refunding the total amount have the value Full only.

  • Adyen and Stripe allow to refund payments directly from their website interface.

Checkout expresso

If the payment provider supports this feature, you can allow customers to use the Google Pay and Apple Pay buttons and pay their eCommerce orders in one click. When they use one of these buttons, customers go straight from the cart to the confirmation page without filling out the contact form. They just have to validate the payment on Google’s or Apple’s payment form.

To enable this feature, go to the Configuration tab of the selected payment provider and enable Allow Express Checkout.

Nota

All prices shown on the express checkout payment form always include taxes.

Disponibilidade

You can adapt the payment provider’s availability by specifying the Maximum amount allowed and modifying the Currencies and Countries in the Configuration tab.

Dica

To display an availability report for payment providers and payment methods, and to help diagnose potential availability issues on the payment form, enable the Modo de desenvolvedor (modo de depuração), then click the (bug) icon next to the Choose a payment method heading on the payment form. The report includes a list of enabled payment providers and payment methods, reasons for any payment providers or methods not being available, if applicable, and a list of supported providers for each payment method.

Currencies and countries

All payment providers have a different list of available currencies and countries. They serve as a first filter during payment operations, i.e., the payment methods linked to the payment provider are not available for selection if the customer’s currency or country is not in the supported list. As there might be errors, updates, and unknowns in the lists of available currencies and countries, adding or removing a payment provider’s supported currencies or countries is possible.

Nota

  • Payment methods also have their own list of available currencies and countries that serves as another filter during payment operations.

  • If the list of supported currencies or countries is empty, it means the list is too long to be displayed, or Odoo does not have information on that payment provider. The payment provider remains available, even though it is possible the payment will be refused at a later stage should the country or currency not be supported.

Maximum amount

You can restrict the Maximum Amount that can be paid with the selected provider. Leave the field to 0.00 to make the payment provider available regardless of the payment amount.

Importante

This feature is not intended to work on pages that allow the customer to update the payment amount, e.g., the Donation snippet and the Checkout page when paid shipping methods are enabled.

Payment journal

A payment journal must be defined for the payment provider to record the payments on an outstanding account. By default, the Bank journal is added as the payment journal for all payment providers. To modify it, go to the Configuration tab of the selected payment provider and select another Payment journal.

Nota

  • The payment journal must be a Bank journal.

  • The same journal can be used for several payment providers.

  • Payment journals must only be configured if the Invoicing or Accounting app is installed.

Perspectiva contábil

From an accounting perspective, there are two types of online payment workflows: the payments that are directly deposited into your bank account and follow the usual reconciliation workflow, and those coming from third-party online payment providers and require you to follow another accounting workflow. For these payments, you need to consider how you want to record your payments’ journal entries. We recommend you ask your accountant for advice.

By default, the Bank Account defined for the payment journal is used, but you can also specify an outstanding account for each payment provider to separate the provider’s payments from other payments.

Define an outstanding account for a payment provider.