Defining the Merchant ID (MID)

In the payment form, the merchant must specify the value of the Merchant ID (MID).

This function is used only if you have several MID within the same acceptance scheme.

  1. Use the fields required for your use case (see chapter Generating a payment form) to create your payment form.
  2. Use the optional vads_contracts field to define the Merchant ID (MID).
    Example:
    Value Description
    Absent or empty Using the MID respecting the priority order as specified in the Back Office (Settings > Shop > Merchant ID).
    Card=12312312 Card Scheme
    AMEXGLOBAL=949400444000 American Express network
    PAYPAL=name@paypal.com PayPal

    To define several MID, separate them by a semi-colon ";".

    To exclude a network, add network name=NO

  3. Compute the value of the signature field using all the fields of your form starting with vads_ (see chapter Computing the signature).

Example:

You have:

  • two CB MID: 1231230 and 1231231
  • two AMEXGLOBAL MID: 949400444000 and 949400444001

To specify which MID to use for these two schemes, vads_contracts must be populated as follows: vads_contracts= CB =1231231; AMEXGLOBAL=949400444000

To propose a payment only within the 1231231 MID and not within one of the AMEXGLOBAL MID, the values of vads_contracts will be:

vads_contracts= CB =1231231; AMEXGLOBAL=NO

Example of a payment form defining the Merchant ID (MID) used for the 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="4000" />
<input type="hidden" name="vads_capture_delay" value="0" />
<input type="hidden" name="vads_ctx_mode" value="TEST" />
<input type="hidden" name="vads_contracts" value="CB=1231231;AMEXGLOBAL=949400444000" />
<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_site_id" value="12345678" />
<input type="hidden" name="vads_trans_date" value="20140327145218" />
<input type="hidden" name="vads_trans_id" value="571381" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="7mjGsUAcl4Ox6p5WZ8RNN7ROsxlJ0py3SMtSzdfbHEM="/>
<input type="submit" name="pay" value="Pay"/>
</form>