Overview
This guide walks you through the full integration journey for Maya Checkout using the Maya Business Manager, from onboarding and setup to generating API keys and finally going live in Production.
Before you begin, make sure you have read About Maya Checkout to understand its requirements, supported integration methods, and key concepts.
By the end of this guide, you will know the tools, credentials, and configurations required before writing any code.
Getting Started
Step 1: Define your Setup
- Choose your integration method: API or SDK
- Select the payment methods you want to support: Cards, QRPh, Maya Wallet, or other channels
- Specify additional features you want enabled, such as:
- Authorize (Hold) & Capture transactions
- Fraud Protection
- Payment Facilitator processing
Step 2: Sign up for a Maya Business Account
Maya Checkout requires a Maya Business Manager account. Access is Production-only (no Sandbox sign-up).
2.1. Create an account
Go to Maya Business Manager and create an account.
2.2. Submit KYC requirements
Complete your business profile and upload documents (e.g., valid IDs, business permits, SEC/DTI registration).
2.3. Provide the preferred setup
2.4. Approval & Account Activation
Once verified, your business account will be activated, and you’ll gain access to the Maya Business Manager.
For help during onboarding, email [email protected].
If you are an existing partner, reach out to your dedicated Maya Relationship Manager.
Step 3: Generate Your API Keys
API keys are required to authenticate your application with Maya Checkout. Currently, Maya Business Manager supports Production API key generation only for Maya Checkout.
Steps to generate your API keys in the Maya Business Manager:
3.1. Log in to Maya Business Manager
3.2. In the sidebar, go to Solutions → Maya Checkout
3.3. Click Set up Online Payments
3.4. Fill in the form
- Website name
- Intended platform (e.g., Shopify, WooCommerce, custom site)
- Where you will use Maya Checkout
3.5. Click Submit
3.6. Copy your API keys
The public and secret keys will be displayed once.
Copy and store the generated public and secret API keys in a secure and encrypted location. Do not store your keys anywhere that unauthorized personnel can access. Once you exit the screen, only masked values will be visible.
Step 4: Configure & Implement
4.1. Now that you have your account and API keys, check How API Authentication Works in Maya Checkout
4.2. Proceed to the implementation guides that match your integration type:
- Accept One-time Payment using Maya Checkout
- Authorize (Hold) and Capture Payments in Maya Checkout
- Accept Payments as a Payment Facilitator in Maya Checkout
Step 5: Apply Best Practices
Before going live, ensure your system handles all key payment states and scenarios:
- Understanding Payment Statuses in Maya Checkout
- Configuring Your Webhook for Maya Checkout
- Managing Voids and Refunds in Maya Checkout
- If Fraud Protect is enabled, review the Implementing Fraud Protection in Maya Checkout
- Testing and Validating Your Maya Checkout Integration
- Understanding Errors in Maya Checkout
Step 6: Go Live
When ready, coordinate with your Maya Relationship Manager and complete the Go Live Checklists.
After Going Live in Production
- Conduct your pilot testing in production (using real cards and wallets; charges will apply).
- Submit your final signoff.
- Prepare for your public launch.
Do not raise production concerns in ASKAMAYADEV. For production support, email [email protected].
FAQs
Q: Where can I find my API keys after initial setup?
A: Only masked values are available later. Always save your keys securely when first generated.
Next Steps
You have now set up Maya Checkout in Production following the integration guides and best practices.
- For merchant account-related requests (e.g., feature enablement), reach out to your Maya Relationship Manager.
- If you run into issues in Production, check the Understanding Errors in Maya Checkout for proper handling.