Skip to main content
Aria Knowledge Central

assign_collections_acct_group_m

Assigns a specified account to a collections account group. If the account's payment method is credit card, a $1 authorization will be performed on the credit card using the new group's payment processor before the group assignment is completed. Unlike the Aria UI, you can use this API to assign additional collection account groups to an account, if the collection account groups do not have overlapping supported payment methods.

For information on error messages generated by this API, see assign_collections_acct_group_m Error Messages.

Input Arguments

 
Req Field Name Field Type Max Length Description
required-icon.png client_no long 22 Aria-assigned unique identifier indicating the Aria client providing service to this account.
required-icon.png auth_key string 32 Aria-assigned unique key to be passed with each method call for authenticating the validity of the requestor.
required-icon.png acct_no long 22 Aria-assigned account identifier. This value is unique across all Aria-managed accounts.
  OR      
  client_acct_id string 50

Client-defined account identifier.

Note: If you pass in a <client_acct_id> and an <acct_no>, Aria will use this order of precedence to decide which account to take action on:

  1. <acct_no>
  2. <client_acct_id>
required-icon.png group_no long 22 Aria-assigned collections account group Identifier to which the account is assigned. If client_acct_group_id is valued, this value must be blank.
  OR      
  client_acct_group_id string 100 Aria-assigned unique identifier indicating the Aria client providing service to this account. If group_no is valued, this value must be blank.
  alt_caller_id string 30 Person or process that submitted the API call. This can be someone's user ID, or the name of an application.
  optional_transaction_qualifiers array   Array of additional values you can associate with this API call.
  qualifier_name string 100 Name of the field you want to associate with this API call.
  qualifier_value string 100 Corresponding value of the field you want to associate with this API call.
  application_id string 300 The application identifier in which the API is being used in. (Example: “Sales Force”)
  application_date string 300 The application date/timestamp, ie. 01/01/2014 10:00:00 to track when the application called the API.
 

billing_group_no

OR

client_billing_group_id

long

string

22

100

Aria-assigned billing group identifier

Client-defined billing group identifier

For cost savings or for other reasons,
you may choose to have payments
made with a particular payment method
(associated with a billing group)
processed by a specific payment
gateway. To do so, you can assign a
collection group to a billing group by
passing the following into this API:

  • a <billing_group_no> or <client_billing_group_id>; and
  • a <collections_group_bg_no> or <client_collections_group_bg_id> to identify the collection group to assign to the specified billing group.

Notes:

  • Aria will use this order of precedence when selecting the payment gateway to use for processing a payment:
  1. Collection group assigned to the billing group associated with the master plan instance being invoiced;
  2. Collection group to which the customer is assigned at the account level.
  • Aria now will allow accounts to have multiple billing groups with different collection groups when using tokenized credit cards that were tokenized outside of Aria. To facilitate multiple payment methods, the billing agreement ID (token) is validated against the specific collection group. When there is no collection group specified, then the agreement ID will be validated against the account level collection group. When no collection group at account level or billing group level is specified, then the agreement ID will be validated against the last processor mapped to that client.
 

collections_group_bg_no

OR

client_collections_group_bg_id

long

string

22

100

Aria-assigned identifier of the collection group assigned to a billing group

Client-defined identifier of the collection group assigned to a billing group

Output Arguments

 
Field Name Field Type Description
error_code long Aria-assigned error identifier. 0 indicates no error.
error_msg string Description of any error that occurred. "OK" if there was no error.
  • Was this article helpful?