FAQ
Frequently asked questions about WAPIs
What is a WAPI Configuration?
A WAPI Configuration is a WiPay-provisioned setup used for Main Merchant Account integrations.
It enables WAPI workflows where one WiPay account acts as the controlling account for that integration. Most developers encounter it when using the WAPI Accounts endpoints.
Does every WAPI integration need a WAPI Configuration?
No.
Most WAPI usage does not require one. Verified WiPay PERSONAL and BUSINESS accounts can use the general WAPI surface, subject to each endpoint's requirements.
You typically need a WAPI Configuration for MMA-centered workflows, especially the /accounts/* endpoints.
What is a Main Merchant Account?
A Main Merchant Account, or MMA, is the WiPay account that WiPay has provisioned to operate certain integration-managed workflows.
That account becomes the controlling account for those workflows. The primary MMA-specific surface is the Accounts API under /accounts/*.
Which WAPI features usually depend on a WAPI Configuration?
The Accounts API endpoints:
These endpoints are intended for MMA account-management workflows and should not be treated as universally available to every verified WiPay account.
Can a PERSONAL account use WAPIs?
Yes, in many cases.
WAPI support is feature-specific, not a blanket BUSINESS-only model. Verified PERSONAL and BUSINESS accounts can use general WAPI features such as authentication, transaction lookups, trusted-card flows, and withdrawals, unless an endpoint documents an additional requirement.
For authentication, WiPay PERSONAL accounts can use only the OAuth bearer-token flow.
See WAPIs Overview for the current support summary.
Is a WAPI Configuration the same as a WAPI Key?
No.
A WAPI Key is one way to authenticate protected WAPI requests. A WAPI Configuration is a provisioned integration setup that enables certain MMA workflows.
WAPI Keys are available only on WiPay BUSINESS accounts. BUSINESS merchants create and manage them on the Developer page — see WAPI Keys for the full process. PERSONAL accounts can use only the OAuth bearer-token flow.
They solve different problems:
- WAPI Keys authenticate requests
- WAPI Configurations enable specific integration capabilities
How do I get a WAPI Configuration?
WAPI Configurations are provisioned by WiPay.
If your integration needs MMA workflows, especially the Accounts API, contact WiPay to confirm that your account has been provisioned for that use case before you build against those endpoints.