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 be used.
  • To define a list of MIDs, separate them with a semi-colon “;”.
    vads_contracts=NETWORK_CODE_A=MID_A1;NETWORK_CODE_B=MID_B2

  • To exclude a network, add network name=NO.
    vads_contracts=NETWORK_CODE_A=NO

  • To force the TID, separate the MID number and the TID number by a colon: “ : ”
    vads_contracts=NETWORK_CODE_A=MID_A1:TID_1

  • If the field is submitted empty, the MID used will be the one defined by the priority order in the Merchant Back Office (Settings > Shop > MID association tab).
List of available networks:
Network code Description
ACCORD * Oney network (private and gift cards)
ACCORD_SANDBOX * Oney network (private and gift cards) - sandbox
AMEXGLOBAL American Express network
AURORE Cetelem Aurore network (Brand cards and universal Aurore card)
CB CB Network
CERIDIAN Ceridian network (gift card)
COFINOGA * Cofinoga network (Be Smart and brand cards)
CONECS * Titre-Restaurant Conecs network
EPNF EPNF (Choozeo) network
GATECONEX * GATECONEX Network
GICC * GICC network
GICC_DINERS * GICC network (Diners Club cards)
GICC_MAESTRO * GICC network (Maestro cards)
GICC_MASTERCARD * GICC network (Mastercard cards)
GICC_VISA * GICC network (Visa cards)
GIROPAY * GIROPAY network
GOOGLEPAY Google Pay network
IDEAL * IDEAL network
JCB * JCB Network
KLARNA * Klarna Internet Banking network
MASTERPASS * MasterPass network
PAYLIB * Paylib network
PAYPAL PayPal network
PAYPAL_SB PayPal network - sandbox
POSTFINANCEV2 * POSTFINANCE network
SOFORT * Sofort Banking network
WIRECARD WIRECARD network

Examples:

You have:

  • Two MIDs within the A network: MID_A1 and MID_A2
  • Two MIDs within the B network: MID_B1 and MID_B2

To specify which MID to use for these two networks, vads_contracts must be populated as follows:

vads_contracts=A=MID_A2;B=MID_B1

To offer a payment only for the MID_A1 contract and prevent payments within the B network, populate vads_contracts as follows:

vads_contracts=A=MID_A1;B=NO

In order to force the TID to be used within the A network:

vads_contracts=A=MID_A1:TID_A1