Payment Facilitator Guide

๐Ÿ””Payment Facilitators must fill out all the required metadata object in the API request. Check out the table below for the list of fields.

See also the following related guides:

Field

Description

Sample Values

subMerchantRequestReferenceNumberReference number of the sub-merchant for the related transaction63d9934f9281
pfFor a payment facilitator, this provides details regarding the sub-merchant
pf.smiSub-merchant IDstarbucks012
pf.smnSub-merchant nameStarbucks
pf.mciSub-merchant city locationMandaluyong City
pf.mpcISO 4217 Numeric currency code608 (for PHP)
pf.mcoISO 3166 Alpha-3 country codePHL
pf.mstSub-merchant abbreviated state location (required if country is USA)optional
pf.mccISO 18245 merchant category code5812
pf.postalCodeSub-merchant postal code1554
pf.contactNoContact number without spaces, dashes, or parentheses0211111111
pf.stateSub-merchant state location in full textoptional
pf.addressLine1Sub-merchant street address66-70 Sheridan cor United Sts

Sample online payment user journey

The following details will be displayed when you have successfully inputted the required pf metadata fields.

Step 1: Scan QR or login to pay

The sub-merchant name value inputted in the smn field will be displayed on the orange box above.

Step 2: Review purchase details

The sub-merchant name value inputted in the smn field will be displayed on the orange box above.

Step 3: Payment Successful

Need support?

If you need further assistance, you may contact these channels for the following topics:


FAQs

You may also refer to the following sources to find further details on FAQs, discussions, and more:


  • FAQ โ€“ view questions asked by other developers that have been answered
  • Discussions โ€“ view open discussions within the developer community or ask your own questions
  • Knowledge Base - use the Maya developer helpdesk