Contents

Skipping the first payment

 

So far we have discussed the processing of subscriptions, where the first payment is processed immediately and subsequent payments are processed automatically at regular intervals defined in the POST.

This page covers scheduling a subscription where the first payment is skipped, meaning no transactions are processed until after the first interval (e.g. 1 month) has passed. E.g. customer agrees to a monthly subscription, and the first month is free of charge.

Warning
The first payment that is skipped is still counted against the final number value submitted in the POST.

 e.g. When a subscription with final number of 12 is submitted, if the first payment is skipped, only 11 payments will be processed in total.

 


 

Requirements

Contact our Support Team and enquire about the following:

(Required)

 

(Optional)

 

Info
This page assumes you have read the other pages in the Subscription topic, and understand how to process a regular subscription.

 


 

Process overview

1. Modify the POST

You will need to update your POST used to request a subscription and add the field requesttypedescriptions, as shown in the following example:


<html>
<head>
</head>
<body>
<form method="POST" action="<DOMAIN>/process/payments/choice">
<input type="hidden" name="sitereference" value="test_site12345">
<input type="hidden" name="stprofile" value="default">
<input type="hidden" name="currencyiso3a" value="USD">
<input type="hidden" name="mainamount" value="15.00">
<input type="hidden" name="version" value="2">
<input type="hidden" name="subscriptionunit" value="MONTH">
<input type="hidden" name="subscriptionfrequency" value="1">
<input type="hidden" name="subscriptionfinalnumber" value="12">
<input type="hidden" name="subscriptiontype" value="RECURRING">
<input type="hidden" name="credentialsonfile" value="1">
<input type="hidden" name="subscriptionbegindate"
value="2013-04-30">
<input type="hidden" name="requesttypedescriptions" value="ACCOUNTCHECK">
<input type="hidden" name="requesttypedescriptions" value="SUBSCRIPTION">
<input type="submit" value="Pay">
</form>
</body>
</html>

Replace <DOMAIN> with a supported domain. Click here for a full list.

 

2. Customer enters their details

Once they have reached the Payment Pages, the customer enters their payment and billing details, as with a standard payment.

 

3. Account check is processed

The customer’s bank checks the billing address and card security code details entered match those held on their records for their card.

 

4. Subscription is scheduled

Providing the checks are successful, the customer is shown a confirmation message and the subscription is scheduled in our subscription engine.

 

5. Scheduled payments are processed after the first interval

Payments are automatically processed for the customer at the intervals defined in the POST. Because the first payment was skipped, the total number processed will be one less than the final number specified in the POST.