Direct Post Handler Use Cases

Last updated
Save as PDF

Overview

This article provides common use cases for the Direct Post Payment Handler. These use cases are examples only, and are not all‐inclusive of Direct Post capabilities.

Change Method of Payment

Use Case
No authorization, collection, or payment validation required. This updates the default payment method without any validation.

To accomplish this:

Set <redirecturl> to the URL to which the direct post application returns.

Update Method of Payment

Use Case 1
Authorize electronic payment if credit card is the selected payment method.

To accomplish this:

Set <redirecturl> to the URL to which the direct post application returns.
Set <do_combined_auth_and_collect> to 0.

Use Case 2
Authorize electronic payment if credit card is the selected payment method, suspending the master plan instance if authorization fails, and setting the master plan instance to Active Trial if authorization succeeds.

To accomplish this:

Set <redirecturl> to the URL to which the direct post application returns.
Set <do_combined_auth_and_collect> to 0.
Set <change_mp_status_on_failure> to 1.
Set <mp_status_on_failure> to ‐1 (i.e., suspended).
Set <change_mp_status_on_success> to 1.
Set <mp_status_on_success> to 41 (i.e., active trial).

Manage Pending Invoices

The following two use cases are affected by the following system settings:

System Setting	Description	Status
Auto Collect on Pending Invoice Approval	Immediately attempt to collect when a pending invoice is approved.	True
Auto Send Statement On Pending Invoice Approval	Immediately create a statement and send the standard email statement message to the account when a pending invoice is approved.	True

Note: If both of these settings are true, the system attempts a collection and sends a statement to the customer when the pending invoice is approved.

Use Case

Update the account with the entered credit card information and authorize the amount of the pending invoice with that credit card, if credit card is the selected method of payment, and if the amount of the pending invoice is $5 or more.

To accomplish this:

Set <redirecturl> to the URL to which the direct post application should return.
Set <do_combined_auth_and_collect> to 0.
Set <min_cc_auth_threshold>to 5.

Collect an Arbitrary Monetary Amount

Use Case
Collect an arbitrary monetary amount with a credit card or bank draft.

To accomplish this:

Set <redirecturl> to the URL to which the direct post application should return.
Set <do_one_time_collection> to 1.

Make a Customer Purchase using the MOTO Transaction Type

Aria Billing Cloud has enhanced the Chase Paymentech integration with support for the mail/telephone order (MOTO) transaction type. This means that you will not see the 3DS challenge when you make a purchase for a customer who is not physically present at your business location and:

You call the authorize_electronic_payment_m API and you set the <transaction_type> value to 1 and pass false into the <attempt_3d_secure> field; or
In your Direct Post configuration, you set the Transaction Type field to Single transaction mail/telephone order (MOTO) and pass false into the <attempt_3d_secure> field in your Form of Payment page.