PayID

A PayID is an alias for a bank account number, designed to simplify payments and enable confirmation of the person you're paying.

We issue PayIDs linked to our Virtual Account Numbers, offering your users an easier way to send you money. Once a PayID is registered with a Virtual Account Number or Ledger Account, any payment made to that PayID will be deposited into your mAccount or Ledger Account. Currently, only email-based PayIDs are supported through the API.

The Register PayID endpoint enables the registration of a PayID linked to a Virtual Account Number. Before registering a PayID, you must first create either a Virtual Account Number or a Ledger Account. We recommend waiting up to 10 minutes after account creation to ensure the account is fully registered with the NPP.

When a customer pays to your PayID, the payIdName passed when registering the PayID will be displayed in their online banking.

When registering a PayID, you have the option to provide an email address in the payId parameter for a custom PayID name. If no email is provided, a numeric PayID will be automatically generated on the monoova.me domain, such as [email protected].

Currently, Monoova PayIDs can only be email addresses.

By default, PayIDs use the monoova.me domain, however we can configure PayIDs to use your own domain. Speak to your Monoova Client Success representative to request setup of your domain. Once configured, you can pass an email with your domain in the payId parameter when registering a new PayID.

PayIDs can be disabled, deregistered or transferred to a new account through the Update a PayID's Status endpoint. You can also Update a PayID's Name if needed.