From ca6e77044b58a867e4327bfc956bb021162a350d Mon Sep 17 00:00:00 2001 From: luca Date: Mon, 9 Nov 2020 22:07:36 +0100 Subject: [PATCH] Update docs on payment methods deprecation --- .../developers/payments/payment-methods.html.md | 4 ++++ .../payments/payment-service-providers.html.md | 13 +++++++++++++ 2 files changed, 17 insertions(+) diff --git a/guides/source/developers/payments/payment-methods.html.md b/guides/source/developers/payments/payment-methods.html.md index e55cc5ce77b..63004d77a3e 100644 --- a/guides/source/developers/payments/payment-methods.html.md +++ b/guides/source/developers/payments/payment-methods.html.md @@ -30,6 +30,10 @@ service providers][payment-service-providers] article. - `available_to_users`: Determines if the payment method is visible to users. - `available_to_admin`: Determines if the payment method is visible to administrators. +- `type_before_removal`: Contains the previous real payment type, in case `type` has + been removed after switching Payment Service Provider. Defaults to `nil`. For more + information, see the [Payment service providers][payment-service-providers] + article. [payment-method-base]: https://github.com/solidusio/solidus/blob/master/core/app/models/spree/payment_method.rb [payment-service-providers]: payment-service-providers.html diff --git a/guides/source/developers/payments/payment-service-providers.html.md b/guides/source/developers/payments/payment-service-providers.html.md index 7310e8f8c5f..e1846b80ef1 100644 --- a/guides/source/developers/payments/payment-service-providers.html.md +++ b/guides/source/developers/payments/payment-service-providers.html.md @@ -66,3 +66,16 @@ You would need to extend or rewrite this class with your preferred PSP integration. [credit-card-base]: https://github.com/solidusio/solidus/blob/master/core/app/models/spree/payment_method/credit_card.rb + +### Switching payment service provider + +After switching payment service provider, there may be `Spree::PaymentMethod` +records referencing a `type` class that does not exist anymore. Trying to +retrieve these records through an `ActiveRecord` query raises a +`Spree::PaymentMethod::UnsupportedPaymentMethod` error. + +If you cannot delete these records, you can deactivate them running +`rake payment_method:deactivate_unsupported_payment_methods`. +This way, their `type` will be set to `Spree::PaymentMethod`, allowing for +records retrieval without errors. Also, their real `type` value will be stored +in the `type_before_removal` attribute.