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.

Use the optional vads_contracts field to define the Merchant ID (MID).
  • To define a list of MIDs, separate them by a semi-colon “;”.
  • To exclude a network, add network name=NO.
  • To force the TID, separate the MID number and the TID number by a colon: “:” .
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

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="20190627145218" />
<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>