Skip to main content
Aria Knowledge Central

issue_refund_to_acct_m Guide

Issues refunds of payment amounts, and any invoice line items to be reversed for a specified account. The refund of a payment will increase the account/master plan instance balance to its pre-payment state (or near, if a partial refund). A refund related reversal would almost retain the balance "as is", as you are reversing the invoice line item charges, along with the refund.

Reversing an invoice charge line item proportionately reverses the corresponding tax (tax to reverse = original tax - tax for revised charge). In the case of tax-inclusive charges, the specified line item reversal amount will be considered as a tax-inclusive reversal amount. In the case of external tax engines, there will be a tax-posting that will occur to update the new taxes to the external tax engine against the customer's account.

As an aside, tax-posting to external tax engines occurs for all generated invoices, voided invoices, write-offs, refund-related reversals, proration reversal/credit (and credit-memo/rebills).

Note: If you use the NETS payment processor, "Enable Refund for NETS Payment" must be set to "True" in the UI before you use this API, or you receive the error message "The payment processor does not support refunds".

API Specification: issue_refund_to_acct_m
Required Fields:
  • <client_no>
  • <auth_key>
  • <acct_no> or <client_acct_id>
  • <payment_transaction_id>
  • <reason_code>

Error Codes

Error Code/Description Associated Inputs

1001: unexpected error

 

1004: authentication error

Associated Inputs: auth_key, client_id, client_no

<auth_key>, <client_no>

1009: account does not exist, Account not found: AriaNo (acct_no), Account not found: Userid (userid), or Account not found: ClientId (client_acct_id)

Associated Inputs: acct_no, account_no, client_acct_id, user_id, userid, parent_acct_no

<acct_no, <client_acct_id

1024: invalid date format

Associated Inputs: bill_birthdate, birthdate, degrade_date, initial_credit_date, invoice_line_reversing_date, service_fulfillment_date, queue_date, start_bill_date, end_bill_date, start_date, end_date, stmt_birthdate, bill_birthdate

Additional Comments: All date inputs must be in yyyy-mm-dd format.

<application_date>, <invoice_line_reversing_date>

1033:  a parameter that represents a true or false value contains invalid input

Associated Inputs: alt_collect_on_approve, alt_send_statement_on_approve, cancel_orders_on_discard, cascade_action, do_auto_discard, do_collect, change_status_after_coll, reset_dates_after_status, disable_existing_on_update, do_write, exclude_terminated_plan_inst, include_all_rate_schedules, include_plan_hierarchy, retrieve_bundled_nso, retrieve_included_nso, include_translations, include_inactive_items, include_invoice_activity_eligibility, include_rs_summary, include_translations, include_service_supp_fields/include_product_fields/, include_plan_instance_fields/include_plan_services/, include_surcharges, include_void_transactions, include_voided, invoice_unbilled_usage, is_unlinked_refund, record_cc_on_auth_failure, retrieve_excluded_usage, send_email, usage_pooling, do_write

<do_write>, <auto_calc_refund>, <is_unlinked_refund>

2010: The payment ID is not valid or is not associated with account number.

Associated Input: payment_transaction_id

<payment_transaction_id>

2011: The payment ID is no longer eligible for refund processing (remaining refundable amount now equal to zero).

Associated Input: payment_transaction_id

<payment_transaction_id>

2014: The total amount of invoice line items selected for refund-related reversal amount exceeds the total designated refund amount.

Associated Inputs: invoice_no, invoice_line_no, invoice_line_reversing_amount

<invoice_no>, <invoice_line_no>, <invoice_line_reversing_amount>

2015: The refund amount submitted must be a valid number greater than zero but no greater than the remaining refundable payment amount.

Associated Input: total_refund_amount

<total_refund_amount>

2016: Could not find the corresponding charge line for the reversal line item number.

Associated Inputs: invoice_no, invoice_line_no

<invoice_no>, <invoice_line_no>

2017: Invalid refund-related reversal amount input. Please provide entries that are greater than zero and no greater than the remaining reversible amount of the invoice line item.

Associated Inputs: invoice_no, invoice_line_no

<invoice_no>, <invoice_line_no>

2018: Refunds of non-electronically-collected payments may only be recorded if a numeric refund check number is supplied.

Associated Input: refund_check_number

<refund_check_number>

2019: Could not create reversal transaction.

 

2020: The given payment is not eligible  for refund on this day.

 

2021: Refund Check Number is longer than allowed

Associated Input: refund_check_number

Additional Comments: Maximum length is 38 characters.

<refund_check_number>

3113: Invalid amount entered. Please enter an amount for the maximum allowed currency specific decimal places for the issue_refund_to_acct_m API.

Associated Inputs: total_refund_amount, invoice_line_reversing_amount, open_amount

<total_refund_amount>, <invoice_line_reversing_amount>, <open_amount>

3114: A Refund Reversal, using a Rebill Action, is not supported for refunding NETS payments.

 

3115: A Refund Reversal, using a Rebill Action, is not supported for reversing child account invoices.

 

3020: Reversing date is not applicable for non-recurring service lines

Associated Input: Invoice_line_reversing_date

<invoice_line_reversing_date>

3021: refund amount cannot be null when do_write is set to true and auto_calc_refund is set to false or auto_calc_refund cannot be set to false when do_write is set to true and refund amount is not provided

Associated Inputs: total_refund_amount, do_write, auto_calc_refund

<total_refund_amount>, <do_write>, <auto_calc_refund>

3022: Invalid refund reason code

Associated Input: reason_code

<reason_cd>

4009: invalid cc number

Associated Inputs: cc_number, alt_pay_method, cc_num, pay_method_type

<cc_number>, <alt_pay_method>

4011: cc authorization failed

Associated Inputs: alt_pay_method, cc_number, cc_expire_mm, cc_expire_yyyy, pay_method_type

Additional Comments: $1 authorization has failed.

<alt_pay_method>, <cc_number>, <cc_expire_mm>, <cc_expire_yyyy>

4016: The payment processor does not accept refunds beyond the standard refund window

 

4031: The payment processor does not support refund on this card.

Associated Inputs: alt_pay_method

Additional Comments: Refunds are not supported on all credit cards by all payment processors.

<alt_pay_method>

6052: The original payment was not made through a credit card.

Additional Comments: An alternate card is only permitted when payment was by credit card.

 

6054: Refund cannot be processed for this payment, since its original payment method is inactive now.

 

25020: Illegal characters entered

Associated Inputs: All character field inputs like firstname lastname, dunning_group_name, comments, etc.

<auth_key>, <client_acct_id>, <refund_check_number>, <comments>, <do_write>, <auto_calc_refund>, <invoice_line_reversing_date>, <client_receipt_id>, <is_unlinked_refund>, <cc_number>, <cvv>, <bill_first_name, <bill_last_name, <bill_company_name, <bill_address1, <bill_address2>, <bill_address3>, <bill_city>, <bill_locality>, <bill_country>, <bill_state_prov>, <bill_zip>, <bill_phone>, <bill_cell_phone>, <bill_work_phone>, <bill_email>, <soft_descriptor>, <soft_descriptor_customer_service>, <application_id>, <application_date>, <alt_caller_id>, <attach_qualifier_option>, <qualifier_name>, <qualifier_value>

Additional Guidance:

Issues refunds of payment amounts and any invoice line items to be reversed for a specified account. The refund of a payment will increase the account/master plan instance balance to its pre-payment state (or near, if a partial refund). A refund related reversal would almost retain the balance "as is", as you are reversing the invoice line item charges, along with the refund. Reversing an invoice charge line item proportionately reverses the corresponding tax (tax to reverse = original tax - tax for reversed charge). In the case of tax-inclusive charges, the specified line item reversal amount will be considered as a tax-inclusive reversal amount. In the case of external tax engines, there will be a tax posting that will occur to update the new taxes to the external tax engine against the customer's account. As an aside, tax-posting to external tax engines occurs for all generated invoices, voided invoices, write-offs, refund-related reversals, proration reversal/credit (and credit-memo/rebills).

Note: If you use the NETS payment processor, "Enable Refund for NETS Payment" must be set to "True" in the UI before you use this API, or you receive the error message "The payment processor does not support refunds".

Input Fields
Field Name: Notes:
<invoice_trans_to_reverse> If sending multiple line items, you must send the line items in ascending order using the invoice_line_no field in the invoice_trans_to_reverse array for the tax line items to be calculated correctly.
<reason_code>
Allowable Values
Values Description
1 Account charged in error
2 Goods/services not delivered
3 Customer dissatisfaction
4 Cancellation of pre-paid service
5 Good Will
6 Overpayment / Duplicate payment
7 Wrong/undesired payment source charged
99999999 Other
<do_write>
Allowable Values
Values Description
TRUE true
FALSE false
<auto_calc_refund>
Allowable Values
Values Description
TRUE true
FALSE false
NULL equate to 'false'
<is_unlinked_refund>
Allowable Values
Values Description
TRUE true
FALSE false
NULL equate to 'false'
<refund_payment_ind>
Allowable Values
Values Description
NULL

Honor what is set on alt_payment_method (for backward compatibility)

2 Original or External Payment - if original payment method fails then external payment is issued. Check number is required.
3 External Payment
<open_line_item_action>
Allowable Values
Values Description
NULL Continue to age (meaning, the aging counter continues from original post date - default)
1 Re-age as of today (meaning, aging is reset as of today)
  • Was this article helpful?