Payment Token

class odoo.addons.payment.models.payment_token.PaymentToken[source]
_get_available_tokens(providers_ids, partner_id, is_validation=False, **kwargs)[source]

Return the available tokens linked to the given providers and partner.

For a module to retrieve the available tokens, it must override this method and add information in the kwargs to define the context of the request.

Parameters
  • providers_ids (list) – The ids of the providers available for the transaction.

  • partner_id (int) – The id of the partner.

  • is_validation (bool) – Whether the transaction is a validation operation.

  • kwargs (dict) – Locally unused keywords arguments.

Returns

The available tokens.

Return type

payment.token

_build_display_name(*args, max_length=34, should_pad=True, **kwargs)[source]

Build a token name of the desired maximum length with the format •••• 1234.

The payment details are padded on the left with up to four padding characters. The padding is only added if there is enough room for it. If not, it is either reduced or not added at all. If there is not enough room for the payment details either, they are trimmed from the left.

For a module to customize the display name of a token, it must override this method and return the customized display name.

Note: self.ensure_one()

Parameters
  • args (list) – The arguments passed by QWeb when calling this method.

  • max_length (int) – The desired maximum length of the token name. The default is 34 to fit the largest IBANs.

  • should_pad (bool) – Whether the token should be padded.

  • kwargs (dict) – Optional data used in overrides of this method.

Returns

The padded token name.

Return type

str

_get_specific_create_values(provider_code, values)[source]

Complete the values of the create method with provider-specific values.

For a provider to add its own create values, it must overwrite this method and return a dict of values. Provider-specific values take precedence over those of the dict of generic create values.

Parameters
  • provider_code (str) – The code of the provider managing the token.

  • values (dict) – The original create values.

Returns

The dict of provider-specific create values.

Return type

dict

_handle_archiving()[source]

Handle the archiving of tokens.

For a module to perform additional operations when a token is archived, it must override this method.

Returns

None

get_linked_records_info()[source]

Return a list of information about records linked to the current token.

For a module to implement payments and link documents to a token, it must override this method and add information about linked document records to the returned list.

The information must be structured as a dict with the following keys:

  • description: The description of the record’s model (e.g. “Subscription”).

  • id: The id of the record.

  • name: The name of the record.

  • url: The url to access the record.

Note: self.ensure_one()

Returns

The list of information about the linked document records.

Return type

list