Skip to main content
Aria Knowledge Central

Returned Key-Value Pairs from the Direct Post Query String


Upon submittal to the Direct Post Payment Handler URL, the handler returns the following key-value pairs to the return URL specified in your configuration set. The key-value pairs returned vary depending on various success or error states. The table below details the possible key-value pairs:



Expected Value




This must be the same session ID string that was posted originally to the Direct Post Payment Handler using the Form of Payment Entry Page.

This session ID may no longer be valid if too much time passed before submitting to the Direct Post Payment Handler. The default time-out period on an Aria-assigned session ID is 10 minutes. An error is returned if a time-out has occurred.



The number of errors encountered by the Direct Post Payment Handler.

This always returns 0 if no errors occurred. The most basic error handling can be accomplished by checking if this number is greater than 0.



If there are errors, this returns an associative array of “error_key” “error_code” and “error_field” key-value pairs.

This does not exist in the query string if there are 0 errors. If this key exists, it can be parsed in to an an associative array of readable error keys (error_key), an error code (error_code), and the offending form field (error_field). For example, if an error occurred because the end user entered an invalid credit card number in the <cc_no> form field, the error_field is “cc_no.” This is useful for focusing and printing error messages adjacent to the offending form field.



An Aria-assigned invoice number returned if an invoice was settled.

This invoice number can be used to create a receipt page using various invoice-related API methods such as get_invoice_details_m. This is not returned if no invoice processing occurs.

No An Aria-assigned billing sequence number. This allows you to map the newly created payment method as the primary or backup payment method on a billing group using Aria's existing APIs.
  • Was this article helpful?