# MIDs

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FthMYnLDFZV2L9iplxNrp%2Fimage.png?alt=media&#x26;token=656b994b-6a4b-41ec-a206-51a3004aac91" alt=""><figcaption></figcaption></figure>

**STEP 1**

Obtain **AccountId** and **ApiKey** from your MIDs account

&#x20;

**STEP 2**

Go to **Gateways > Gateway Integrations**

Activate the MIDs gateway tile. Enter all the information from Step 1.

**Service** = Enter the payment service associated with credit cards.  For example, payment\_card\_usd\_hpp.  This will get overwritten for alternate payment methods (see below).

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2F8qHlGC0t9T4R0ignIsmU%2Fimage.png?alt=media&#x26;token=bb180977-f259-4427-be83-7e3dab711365" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2F1sF26fQR2aE5Snnj8J4v%2Fimage.png?alt=media&#x26;token=bb835d49-18a7-4f36-927b-82aa641ab52c" alt=""><figcaption></figcaption></figure>

**STEP 3**

If using 3DS then verify the checkout page follows these instructions

[Basic 3DS Instructions](https://help.konnektive.com/konnektive-crm/gateway-setup/basic-3ds-instructions)

#### Alternate Payment Methods

MIDs supports alternate (non-card) payment methods.  The available methods are on your MIDs account.  Fetch the list of methods from MIDs, present the choice on your checkout page, and process the sale.

Follow these steps:

1. Call the [Import Click API](https://apidocs.konnektive.com/#834b3843-dd86-40b5-82f0-85a3384fbcfd) on your checkout page with:
   1. standard parameters
   2. midsBilerId = the MIDs gateway id on which to transact
2. Import Click API returns a sessionId along with a list of alternate payment methods (services)
   1. example:  \
      midsApms: \[
      \
      {
      \
      'serviceName' => 'example\_service',
      \
      'serviceCurrency' => 'USD'
      \
      }
      \
      ]
3. Present the payment methods on the checkout page
4. Once the shopper selects a method, call [Import Order API](https://apidocs.konnektive.com/#436cbeab-a41a-4f36-bfb9-7b74fd82a0c0) with:
   1. standard parameters
   2. paySource = PREPAID
   3. prepaidType = MIDS
   4. forceMerchantId = the MIDs gateway id on which to transact (should be the same as **midsBilerId** on the Import Click APIn request)
   5. custom\_order\_service = the name of the chosen payment method (this must match a **serviceName** from the Import Click API response)
   6. custom\_order\_document\_type = one of the following, based on the chosen service
      1. DNI|CUIT|CUIL|CPF|CNIC|CNPJ|RUT|RUN|ID|CC|NIT|CE|PASS|PPT|KTP|NIK|CURP|RFC|IFE|RUC|CPP|PSN|PCN|POC|RIC|NID|CI|CIP|CIC|CRP|CRC|DL|DPI|DUI|TDI|HC|UID|CIE|RD|RIF|NRIC|CNP|RNC|RC|RRN|TCKK
   7. custom\_order\_document\_id = the value of the document type, entered by shopper on the checkout page.  For example, if **document\_type** is PASS then **document\_id** is the passport number.
5. Import Order will return a url.  Follow the [standard 3DS workflow](https://help.konnektive.com/konnektive-crm/gateway-setup/basic-3ds-instructions) to allow the shopper to complete checkout.