SecureNet Gateway Implementation Guide 4.1.5
XML Tag
</CUSTOMER_VAULT>
Data Type /
Max Length Required Notes Reference XML Tag
</CUSTOMER_VAULT
>
6.20.4
OPERATIONPARAMETERS
This object is used to specify operation type (Add, Update, or Delete) and to specify whether Vault information is to be added even when transaction is declined in ProcessVaultTransaction method.
XML Tag
<OPERATIONPARAMETERS>
Data Type /
Max Length Required
<ACTIONCODE>
<ADD_IF_DECLINED>
</OPERATIONPARAMETERS>
Integer / 1
Integer / 1
False
False
Notes
1—ADD
2—Update
3—Delete
Add Customer/Account if transaction is declined:
0—False
1—True
Reference
Refer to Section 4.1 and 4.2 for
Methods and Section 8.2 for Vault
Object Specification.
If not included, the default will be to
ADD the transaction data to the Vault.
6.21 AutoBill Transactions
The AutoBill feature allows merchants to set up automatic scheduled and recurring credit card and ACH transactions. Using the “Recurring AutoBill” payments can be scheduled for daily, weekly, monthly, quarterly, and yearly recurrence. Merchants can use the “Variable AutoBill” to set up one or more future-dated payments. Lastly, the “Installment AutoBill” will take a total amount due and split the payment amount evenly across the designated time period with flexible variability on the recurrence schedule (i.e. weekly, monthly, etc.).
6.21.1
PLAN_AB Object Specification
6.21.1.1 PLAN_AB
This object defines the information that can be submitted to the Gateway for AutoBill transaction processing.
XML Tag
<PLAN_AB>
Data Type /
Max Length Required Methods Used
This object can be used with the following methods:
AddABAAccount
UpdateABAccount
UpdateABSchedule
Reference
Available through:
36
SecureNet Gateway Implementation Guide 4.1.5
XML Tag
Data Type /
Max Length Required Methods Used Reference
<CUSTOMERID>
<ENDDATE>
< >
<MAXRETRIES>
< >
String / 25
String / 8
Object / 1
Integer / 1
Object / 1
<NEXTPAYMENT_DATE> String / 8
<PAYMENTID>
<PAYMENTID2>
<
INSTALLMENT
MERCHANT_KEY
RECURRING
<SCHEDULE>
>
<STARTDATE>
String / 25
String / 25
Object / 1
Array of
PAYMENT_AB
String / 8
Available in response. Shows whether recurring billing on this record is enabled or disabled.
0—Inactive
1—Active
True Contains customer ID associated with payment plan. It cannot be a valid card number.
Required if
NOEND_FLAG = 0
(recurring bill has an end date)
True
Plan end date. MMDDYYYY.
False
True
Refer to PLAN_AB
Object Summary
AutoBill offers the ability to reattempt a declined transaction every day for up to five consecutive days.
Enter maximum number of retries, default is
0, maximum is 5.
This object is used to verify merchant before processing any transaction and is required for any operation.
Refer to
MERCHANT_KEY
Object
False
True
False
Update only
True
Available in response.
Next payment date. MMDDYYYY.
SecureNet Vault Payment ID.
Must be enabled on the account.
It cannot be a valid card number.
Process through Payment ID 2 if there is a problem with Payment ID.
Payment plan ID, auto-generated by the system and given to the merchant at the time
Plan is added.
True
True
Refer to
RECURRING Object
Refer to
PAYMENT_AB
Object
<TYPE>
</PLAN_AB>
String / 3 True
Plan start date. MMDDYYYY.
Verify the date is on or after current date.
Billing types offered include Recurring
Billing, Installment Billing and Variable
Billing.
Set TYPE to one of the following:
REC—for recurring
INS—for installment
VAR—for variable
37
