assign_collections_acct_group_m Guide

Last updated
Save as PDF

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. Please note: If you attempt to use this API call to assign an account to a functional account group, you will encounter an error. You can use the assign_functional_acct_group call to assign an account to a functional account group.

API Specification:	assign_collections_acct_group_m
Required Fields:	<client_no> <auth_key> <acct_no> or <client_acct_id> <group_no> or <client_acct_group_id>
Error Messages:	assign_collections_acct_group_m Error Messages

Additional Guidance:

Input Fields

Field Name:	Notes:
<client_acct_id>	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: <acct_no> <client_acct_id>
<client_billing_group_id>	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. Aria will use this order of precedence when selecting the payment gateway to use for processing a payment: Collection group assigned to the billing group associated with the master plan instance being invoiced; Collection group to which the customer is assigned at the account level. Aria 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.

Field Name:

Notes:

<client_acct_id>

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:

<acct_no>
<client_acct_id>

<client_billing_group_id>

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.

Aria will use this order of precedence when selecting the payment gateway to use for processing a payment:

Collection group assigned to the billing group associated with the master plan instance being invoiced;
Collection group to which the customer is assigned at the account level.

Aria 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.