Creating an installment payment

This payment mode allows the merchant to make the payment process easier for the buyer.

The payment form defines the number of installments and the interval between them.

The first installment is similar to the immediate payment.

The next installment is similar to a defered payment.

Note:

Notifications rules have to be activated according the installment. See chapter Setting up notifications for more information.

Precisions :

On the payment day, the merchant is not credited with the total amount and the payment guarantee cannot apply to the future installments.

The date of the last installment cannot be later than one year after the date of the submission of the form. If it is, an error message will appear and the form will be rejected.

  1. Use all the fields below to create your payment form.
    Table 1. Field list - Installment payment
    Field name Description Value
    vads_site_id Shop ID Eg.: 12345678
    vads_ctx_mode Operating mode TEST or PRODUCTION
    vads_trans_id Transaction number Eg.: 123456
    vads_trans_date Date and time of the payment form in UTC format Eg.: 20140129130025
    vads_amount Payment amount (in the smallest currency unit) Eg.: 3000 for 30 euros
    vads_currency Code of the payment currency Eg.: 978 for euro
    vads_action_mode Acquisition mode for credit card data INTERACTIVE
    vads_page_action Action to perform PAYMENT
    vads_version Version of the exchange protocol V2
    vads_payment_config Payment type

    see step 2.

    vads_capture_delay Delay before capture by the bank 0
    vads_validation_mode Validation mode 0 (automatic) or 1 (manual)
  2. Set the value of the vads_payment_config field using the following syntax:
    • Fixed payment amounts and dates:

      MULTI:first=1000;count=3;period=30 where:

      "first" is the amount (in the smallest currency unit) of the first installment processed on the day of payment, "count" is the total number of installments, "period" defines the period (in days) between each installment.
    • Customized payment amounts and dates:

      MULTI_EXT:date1=amount1;date2=amount2;date3=amount3 where:

      date1=amount1 defines the date and the amount of the first installment. The amounts are presented in the smallest currency unit. The total amount must be equal to the value of the vads_amount field. The dates are presented in the YYYYMMDD format.
  3. Set vads_capture_delay to 0. The first payment will be captured by the bank on the same day.
  4. Set vads_validation_mode to 0 for an automatic validation (the payment will be automatically captured by the bank) or to 1 for a manual validation (manual operation made from the Back Office).
    The validation mode is applied to each installment payment.
  5. Fill in the vads_currency field with the code of the desired currency using the currency table (example: 978 for Euro; , 840 for US dollar).
  6. Add optional fields according to your requirements (see chapter Using additional functions).
  7. Compute the value of the signature field using all the fields of your form starting with vads_(see chapter Computing the signature).
Example of a payment form for an installment payment (fixed amounts and payment dates):
<form method="POST" action="https://secure.payzen.eu/vads-payment/">
<input type="hidden" name="vads_action_mode" value="INTERACTIVE" />
<input type="hidden" name="vads_amount" value="3000" />
<input type="hidden" name="vads_ctx_mode" value="TEST" />
<input type="hidden" name="vads_currency" value="978" />
<input type="hidden" name="vads_page_action" value="PAYMENT" />
<input type="hidden" name="vads_payment_config" value="MULTI:first=1000;count=3;period=30"/>
<input type="hidden" name="vads_site_id" value="12345678" />
<input type="hidden" name="vads_trans_date" value="20140129180150" />
<input type="hidden" name="vads_trans_id" value="180150" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value= "zrhUNkAciZSEl6mS4BbhV3qkYUBB9RYJQCdg1kU0ELU="/>
<input type="submit" name="pay" value="Pay" />
</form>

Example of a payment form for an installment payment (customized amounts and payment dates):
<form method="POST" action="https://secure.payzen.eu/vads-payment/">
<input type="hidden" name="vads_action_mode" value="INTERACTIVE" />
<input type="hidden" name="vads_amount" value="3000" />
<input type="hidden" name="vads_capture_delay" value="0" />
<input type="hidden" name="vads_ctx_mode" value="TEST" />
<input type="hidden" name="vads_currency" value="978" />
<input type="hidden" name="vads_page_action" value="PAYMENT" />
<input type="hidden" name="vads_payment_config" value=" 
MULTI_EXT:20140201=1000;20140301=1000;20140401=1000" />
<input type="hidden" name="vads_site_id" value="12345678" />
<input type="hidden" name="vads_trans_date" value="20140129130025" />
<input type="hidden" name="vads_trans_id" value="130025" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="7Sds6Z+R1Q1axRsblpChyQh5OU3oCle5FOirD4V/Bzk="/>
<input type="submit" name="payer" value="Pay"/>
</form>