If you integrated with the Hosted Payment Page, all of the following additional parameters are required in a payment submission to us. If an item is to be unset then it should be omitted or submitted with an empty value.
Please also refer to Limited Agreement Examples for further information.
Parameter |
Format |
Option |
Comments |
Limitations |
futurePayType |
String: "regular" |
|
|
|
startDate |
yyyy-mm-dd |
all |
The date from which payments can occur. |
Must be in the future and not today. Can be left unset. |
startDelayUnit |
One digit: 1-day, 2-week, 3-month, 4-year. |
all |
Unit of the delay between when the agreement is created and when the payments can occur. |
Cannot be set if startDate is specified. |
startDelayMult |
integer |
all |
Delay unit multiplier. |
Should not be set if startDate is specified. The actual delay is obtained by multiplying the startDelayUnit by startDelayMult If set must be >=1 |
noOfPayments |
integer |
0 |
Limit on the number of payments which can be made under the agreement |
Positive integer. Set to 0 or leave unset for unlimited. |
1 |
Limit on the number of payments possible in each interval period |
Cannot be unlimited. Must be set to the number of payments. |
||
2 |
N/A |
Must be 0 or unset. |
||
3 |
N/A |
Must be 0 or unset. |
||
intervalUnit |
One Digit:1-day, 2-week, 3-month, 4-year. |
0 |
Unit of the minimum interval between payments. |
Can be left unset. Must not be set if noOfPayments is 1. |
1 |
Unit of the period in which number of payments is limited. |
Must be set. |
||
2 |
N/A |
Must not be set. |
||
3 |
Unit of the period in which payment amount is limited. |
Must be set. |
||
intervalMult |
integer |
0 |
Unit multiplier of the minimum interval between payments. |
Can be left not set. Must not be set if noOfPayments is 1. |
1 |
Unit multiplier of the period in which number of payments is limited. |
Must always be set to the value 1. |
||
2 |
N/A |
Must not be set. |
||
3 |
Unit multiplier of the period in which payment amount is limited. |
Must always be set to the value 1. |
||
amountLimit |
decimal |
0 |
Individual payment amount limit. |
Leave unset or set to zero for unlimited. |
1 |
Individual payment amount limit. |
Must be set to a positive, non-zero value. |
||
2 |
Agreement payment amount limit. |
Must be set to a positive, non-zero value. |
||
3 |
Payment amount limit for interval period. |
Must be set to a positive, non-zero value. |
||
endDate |
yyyy-mm-dd |
all |
End date of the agreement, past which no payments are possible. |
Must be in the future and not before the startDate. Can be left unset. |
lengthUnit |
One Digit: 1-day, 2-week, 3-month, 4-year. |
all |
The unit of the period of time for which payments will be possible under the agreement. |
Cannot be set if endDate is specified. |
lengthMult |
integer |
all |
The unit multiplier for the period of time for which payments will be possible under the agreement. |
The period is calculated by multiplying lengthUnit by lengthMult The period must be at least one day. Cannot be set if endDate is specified. |
option |
One Digit: 0, 1 or 2. |
|
Determines the operation of the agreement. |
Must be one of the listed values. |
In addition to the above parameters, the parameters shown below must be set as for a normal purchase submission.
Parameters |
Comments |
instId |
Merchant's installation reference. |
cartId |
Merchant's reference for the agreement and immediate payment if present. The following special characters are not allowed for the cartId parameter: |
amount |
Should be set to 0 unless there is also an immediate payment. |
currency |
Currency for amounts defined in the agreement and immediate payment, if present. |
desc |
Description for the agreement and immediate payment, if present. The following special characters are not allowed for the desc parameter: |