Creating a payment Paydirekt

Paydirekt payment is an immediate payment with one-hour delay.

The buyer pays the total sum for the purchase at once.

The payment is captured in the bank on the same day except if the merchant configures another date.

  1. Use all the fields of the table below to create your payment form.
    Table 1. List of required fields for a payment Paydirekt
    Field name Description Value
    vads_site_id Shop ID E.g.: 12345678
    vads_ctx_mode Operating mode TEST or PRODUCTION
    vads_trans_id Transaction number E.g.: 123456
    vads_trans_date Date and time (in UTC format) of the payment form E.g.: 20161019130025
    vads_capture_delay Delay before capture by the bank E.g.: 0

    It is a deferred payment, therefore the merchant can modify the value.

    vads_payment_config Payment type SINGLE
    vads_amount Payment amount (in the smallest currency unit) E.g.: 3000 for 30 euros
    vads_currency Country code of the card in compliance with the ISO 4217 standard. E.g.: 978 for euro or 840 for USD
    vads_action_mode Acquisition mode for credit card data INTERACTIVE
    vads_page_action Action to perform PAYMENT
    vads_contract_used Value of the contract associated with the transaction.

    Example: 8a82941854bf24050154bfd1f3200891

    vads_validation_mode Validation mode 0 (Automatic)
    signature Alphanumeric signature E.g.:
    +NS0gyNeJw5IbQZZgX4XrFkKiQAC7r03OgBlhkgScJM=
    vads_version Version of the exchange protocol V2
  2. Use all the fields of the table below to set the mandatory buyer information to include in the authorization request to send to Paydirekt.
    Field name Description Format Required Value
    vads_cust_title Buyer's marital status. string   E.g.: Mister
    vads_cust_first_name Buyer's first name. an..63 yes E.g.: John
    vads_cust_last_name Buyer's last name. an..63 yes E.g.: Dupont
    vads_cust_address Buyer's street name.

    Can contain space, dot, period, apostrophe, dash and slash (/)

    ans..255 yes E.g.: test street
    vads_cust_zip Buyer's zip code

    n5

    yes E.g.: 31000
    vads_cust_city Buyer's city.

    Can contain dash and apostrophe.

    an..128 yes E.g.: Toulouse
    vads_cust_country Allows to specify the country code in compliance with the ISO 3166 standard.

    Only French country code can be set.

    a2 yes FR
    vads_cust_cell_phone Buyer's cell phone number.

    from 0 to 9 without space

    n10   E.g.: 0612345678
    vads_cust_email Buyer's e-mail address. ans..255 yes E.g.: name@example.com
    vads_cust_status Status string (enum) yes

    PRIVATE

    vads_cust_status
    Only the PRIVATE value can be set (private individual). A company (COMPANY) can not benefit from this payment method.
  3. Add optional fields according to your requirements (see chapter Using additional features of the Payment form implementation guide available on our website: https://payzen.io/de-DE/ ).
    You can transmit information about the buyer, the delivery, the content of the order ...
  4. Compute the value of the signature field using all the fields of your form starting with vads_ (see chapter Computing the signature of the Payment form implementation guide available on our website: https://payzen.io/de-DE/ ).

Example of a form for an immediate payment:

<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="SINGLE" />
<input type="hidden" name="vads_contract_used" value="8a82941854bf24050154bfd1f3200891" />
<input type="hidden" name="vads_site_id" value="12345678" />
<input type="hidden" name="vads_trans_date" value="20161019101407" />
<input type="hidden" name="vads_trans_id" value="239848" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="+NS0gyNeJw5IbQZZgX4XrFkKiQAC7r03OgBlhkgScJM="/>
<input type="submit" name="pay" value="Pay"/>
</form>