> For the complete documentation index, see [llms.txt](https://docs.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verifone.com/psdk-latest/psdk-user-guide-and-training/psdk-user-guide/multi_merchant.md).

# Multi-Merchant Transactions

A multi-merchant terminal allows several business entities to process payment cards on a single terminal, with each business having a separate merchant account. The payment terminal communicates its merchant configuration to the PSDK during initialization.

When there are multiple merchants supported on the terminal, the POS needs to select one of the merchants when logging in. The POS can select a merchant prior to login by calling [PaymentSdk.getDeviceInformation().getMerchantConfig() ](https://docs.verifone.com/psdk-api-latest/android-java/index/psdkdeviceinformation#getmerchantconfig)to access an array of sponsored merchants. The field [Merchant.mRecordId](https://docs.verifone.com/psdk-api-latest/android-java/index/merchant#getrecordid) contains the reference id to the merchant to include in the login credentials.

The POS can also perform a login without specifying a merchant. If the terminal supports multiple merchants, it will reject this login and send a user input event with text content “Please select the merchant”, as well as an array of menu entries containing the common names of all of the sponsored merchants supported by the terminal. This may be accessed at [UserInputEvent.getRequestParameters().getContent().](https://docs.verifone.com/psdk-api-latest/android-java/index/requestparameters#getcontent) At this point, the POS must select one of the menu entries corresponding to the desired merchant (see [UserInputEvent.getRequestParameters().getMenuEntries()](https://docs.verifone.com/psdk-api-latest/android-java/index/requestparameters#getmenuentries)) and return the menu selection in [UserInputEventResponse](https://docs.verifone.com/psdk-api-latest/android-java/index/userinputeventresponse) to the PSDK, which in turn resends the original login request with the selected merchant identifier added to the credentials.

{% hint style="info" %}
**See also**

* [Merchant](https://docs.verifone.com/psdk-api-latest/android-java/index/merchant)
* [UserInputEvent](https://docs.verifone.com/psdk-api-latest/android-java/index/userinputevent)
* [RequestParameters](https://docs.verifone.com/psdk-api-latest/android-java/index/requestparameters)
  {% endhint %}

***

{% columns %}
{% column width="25%" %}

<figure><img src="/files/9ezXRridnCaI1awLr3X9" alt="" width="150"><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="25%" %}

{% endcolumn %}

{% column width="16.66666666666666%" %}
**Version:**\
**Date:**
{% endcolumn %}

{% column width="33.333333333333336%" %} <code class="expression">space.vars.psdk\_version</code>\ <code class="expression">space.vars.psdk\_date</code>
{% endcolumn %}
{% endcolumns %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verifone.com/psdk-latest/psdk-user-guide-and-training/psdk-user-guide/multi_merchant.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.