Home > Aria6 User Documentation > Best Practices > User Self Service > Updating Payment Information

Updating Payment Information

Preconditions

  • An account exists for the customer.
  • A Direct-Post Configuration Set for Updating Payment Information exists.

You can use Direct-Post to securely update a customer’s payment information. To create a Direct-Post configuration set for updating payment information, define the following key-value pairs using the set_reg_uss_config_params API call:

  1. Set the client_no field to your Aria-assigned client number.
  2. Set the auth_key field to your Aria-assigned authorization key.
  3. Set the set_name field to the name of your configuration set. The name of your configuration set must begin with direct_post_.

Example: The configuration set for updating payment information could be named direct_post_updatepayinfo.

  1. Set the redirecturl field in the in_reg_uss_config_params array to the URL in your User Self Service application on which you display error or success messages. These messages are sent by Direct-Post.

Postcondition

The customer’s updated payment information is saved in the User Self Service application.

Process Flow Diagram

The diagram below illustrates the process in which a customer adds or updates payment information.

UserSelfServices3.jpg

* The grey box indicates a function automatically triggered by Direct-Post based on your configuration set.

Note: After a customer logs in, use the validate_session call at every page load to determine the validity of the session and the user with which the session is associated.  

Instructions

  1. Use the set_session_auth call to authenticate the user.
  2. Use the get_acct_details_all call to provide any existing payment information on file for the customer.
  3. Transmit data from the payment information page to Direct-Post.

Transmit the following fields and values from the payment information page to Direct-Post:

  1. Set the mode field to the suffix of the configuration set that you created.

Example:  If you named your configuration set direct_post_updatepayinfo, then you would set the mode field to updatepayinfo. The mode field is a hidden field.

  1. Set the inSessionID field to the session ID returned by the set_session_auth call. The inSessionID field is a hidden field.
  2. Set the client_no field to your Aria-assigned client number. The client_no field is a hidden field.
  3. Set the formOfPayment field to the payment method that the customer selected. Examples: CreditCard, ACH, Net30.

If the customer updated or added credit card information:

  • Set the cc_no field to the credit card number that the customer entered.
  • Set the cc_exp_mm field to the credit card expiration month that the customer entered.
  • Set the cc_exp_yyyy field to the credit card expiration year that the customer entered.
  • Set the cvv field to the Card Verification Value (CVV) that the customer entered.

If the customer updated or added bank account information:

  • Set the bank_routing_num field to the bank routing number that the customer entered.
  • Set the bank_acct_num field to the bank account number that the customer entered.

 

Last modified

Tags

This page has no custom tags.

Classifications

This page has no classifications.