Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Expand
titleaccounts_receivable_payment_preference object parameter data
Web API - Updating Sets

If no records are specified in the set then nothing will be updated. To update a record use action: "update". To add a record use action:"add". Only one action can be used within the same set. For example:

Name

Type

Description

action

(mandatory)

String

Defines if a new or existing payment preference will be used. In the case of a payment preference then it also defines if the existing payment preference should be updated or not. The supported values are the following:

ADD, UPDATE, REMOVE

accounts_receivable_payment_preference_identifier

(mandatory and applicable only on update or remove)

Accounts Receivable Payment Preference Identifier  

The identifier of the accounts receivable payment preference to be updated. The allowed accounts receivable payment preference identifier fields are the following:

Include Page
accounts_receivable_payment_preference_identifier
accounts_receivable_payment_preference_identifier

payment_preference_identifier

(mandatory and applicable only on add)

Payment Preference Identifier  

The identifier of the payment preference to be updated on the related accounts receivable payment preference object. The allowed payment preference identifier fields are the following:

Include Page
payment_preference_identifier
payment_preference_identifier

account_holder

(optional)

String

The account holder of the retrieved payment preference

is_default

(mandatory)

Boolean

Defines if the payment preference is default or not.

 

bank_account_number

(optional on conditions)

String

The bank account number of the retrieved payment preference

Tip

For releases prior R13.1.0, this parameter is optional

From releases R13.1.0 and onwards, this parameter is optional on conditions (if the "sepa" parameter is specified and no related information exists in the system)

bank_account_type_identifier

(optional)

Bank Account Type Identifier 

The identifier of the bank account type to be added on account payment preference object. The allowed bank account type identifier fields are the following:

Include Page
bank_account_type_identifier
bank_account_type_identifier

bank_identifier

(optional)

Bank Identifier 

The identifier of the bank to be added on account payment preference object. The allowed bank identifier fields are the following:

Include Page
bank_identifier
bank_identifier

bank_branch_identifier

(optional)

Bank Branch Identifier 

The identifier of the bank branch to be added on account payment preference object. The allowed bank branch identifier fields are the following:

Include Page
bank_branch_identifier
bank_branch_identifier

notes

(optional)

String

The notes to be added on account payment preference object.

Tip

Available from CRM.COM R10.1.0

payment_medium_identifier

(optional)

String

The payment medium identifier to be added on account payment preference object.

Tip

Available from CRM.COM R11.0.0


payment_medium_type_identifier

(optional)

Payment Medium Type Identifier

The payment medium type to be added on account payment preference object. The allowed payment medium type identifier fields are the following:

Include Page
payment_medium_type_identifier
payment_medium_type_identifier

Tip

Available from CRM.COM R11.0.0

payment_medium_brand_identifier

(optional)

Payment Medium Brand Identifier

The payment medium brand to be added on account payment preference object. The allowed payment medium brand identifier fields are the following:

Include Page
payment_medium_brand_identifier
payment_medium_brand_identifier

Tip

Available from CRM.COM R11.0.0

use_for_recurring_payments

(optional)

Boolean

Indicates if the specific accounts receivable payment preference will be used to automatically pay any unsettled billes allocated to the related accounts receivable

cards_set

(mandatory on add)


Set of payment gateway cards objects

The cards that are related with the accounts receivable payment preference, in case the payment preference is related with a payment gateway such as Stripe. This information is applicable only if the payment preference is related with a payment gateway. In that case it is mandatory to specify at least one card, which also needs to be set as the default card

Include Page
Web API - Updating Sets
Web API - Updating Sets

sepa

(optional)


SEPA Object

The Single Euro Payments Area (SEPA) information that is related with the Accounrs Receivable Payment Preference

This parameter is only applicable if the Payment Preference is of type Direct Debit or Custom. Application on Custom Type Payment Preferences may be vary based on the Custom Type Payment Preference configuration

Include Page
Web API - Updating Sets
Code Block
themeConfluence
languagejavascript
linenumberstrue
"set": [
	   		{
            	"action": "add",
            	...........
        	},
			{
            	"action": "update",
            	...........
			}
		]
Tip

Available from CRM.COM R13.1.0

Anchor
accounts_receivable_payment_preference_update_parameters referred objects
accounts_receivable_payment_preference_update_parameters referred objects
Referred Objects Response Data

Include Page
payment_gateway_card_update_parameters
payment_gateway_card_update_parameters

Include Page
payment_preference_sepa_update_parameters
payment_preference_sepa_update_parameters