trytond-account-payment-stripe

Account Payment Stripe Module #############################

The account_payment_stripe module allows to receive payment from Stripe. It uses Stripe.js and Stripe Elements in a checkout form to handle Setup Intent_ and Payment Intent_ by card.

.. _Stripe: https://stripe.com/ .. _Stripe.js and Stripe Elements: https://stripe.com/docs/payments/elements .. _Setup Intent: https://stripe.com/docs/api/setup_intents .. _Payment Intent: https://stripe.com/docs/api/payment_intents

Account

---

The Account stores the information about the Stripe account like the secret key, the publishable key and the webhook signing secret.

The account's webhook endpoint is the URL used by stripe webhooks_. For additional security, the Stripe's requests signature can be verified if the webhook signing secret_ is set on the Account. If no webhook is setup, a cron task fetches the new events.

.. _webhooks: https://stripe.com/docs/webhooks .. _signing secret: https://dashboard.stripe.com/webhooks

Customer

---

The Customer allow to register parties as Stripe customers. The checkout button opens the Stripe checkout form.

A cron task runs every hour to create new customers on Stripe and another to delete them if they are inactivated.

Journal

---

The journal has a new field for the Stripe account.

Payment

---

The payment has also a checkout button which opens the Stripe checkout form. A payment can be processed off-session using a source_ or payment method_ from the customer. In case the payment method requires authorization, an email is sent to the party with a link to the checkout form. In case of error, it has also new fields which display the error messages.

A cron task runs every 15 minutes to charge each processing payment.

The capture box can be unchecked to only authorize on processing and capture the amount in a second step.

If the payment is disputed, it will be updated at the closure of the dispute.

It is possible to partially or completely refund a payment.

.. _source: https://stripe.com/docs/sources .. _payment method: https://stripe.com/docs/payments/payment-methods

Configuration

---

The account_payment_stripe module uses the section account_payment_stripe to retrieve some parameters:

• sources_cache: defines the duration in seconds the sources are kept in the cache. The default value is 15 * 60.

• max_network_retries: defines the maximum number of retries the Stripe library may perform. The default value is 3.