Payment Facilitator Integration

Hi, I would like to clarify the metadata requirement regarding the Payment Facilitator (PF) integration. For all transaction types, do we need to consistently pass the sub-merchant information (e.g., smi, smn, mci) witin the metadata field?

Sub-merchant information (e.g., smi, smn, mci) must be included in the metadata field only when processing payments on behalf of sub-merchants under a Payment Facilitator (PayFac) setup. It is not required for all transaction types. If you are processing payments directly under your main merchant account (not on behalf of a sub-merchant), you can omit the PayFac metadata. However, when integrating as a PayFac, the following fields are required in the metadata object for each sub-merchant transaction: pf.smi (Sub-merchant ID), pf.smn (Sub-merchant name), and pf.mci (Sub-merchant city location).

For Sandbox concerns and other technical implementation inquiries, please get in touch with us via:

  • Sandbox Health Page: Check real-time service status updates.
  • Maya Developer Hub Service Desk: File
    a ticket in Sandbox.

To Know More:

We value your input and would love to hear your insights. Please submit you feedback here.