Defining the Merchant ID (MID)

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

This feature is used only if you have several MIDs that accept the same currency within the same acceptance network.

  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
    Missing or empty Using the MID respecting the priority order as specified in the Expert Back Office (Settings > Shop > Merchant IDs).
    CB=12312312 CB Network
    AMEXGLOBAL=949400444000 American Express network
    PAYPAL=nom@paypal.com PayPal

    To define several MIDs, separate them with 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 MIDs: 1231230 and 1231231
  • two AMEXGLOBAL MIDs: 949400444000 and 949400444001

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

To offer 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.lyra.com/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_currency" value="" />
<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>