Cash-in to Maya Wallet
Overview
Cash-in is the primary enabler of transactions within the Maya ecosystem. As a Maya partner, your online and offline channels allow Maya users to top up their wallets.
Example User Journeys
Cash-in via Maya Login
Let customers authorize funds transfer from your platform to their Maya account through Maya login.
Cash-in via Code
Leverage Maya’s code generation to allow Maya users to do Cash-in through your platform.
Cash-in via Bank Transfer
Transfer funds from other sources to the customer's Maya Wallet through or
.
The customer will be redirected to a Maya-hosted login page to sign in and authorize the transaction.
The customer will be prompted to enter the one-time password (OTP) sent to their registered mobile number in Maya.
The customer will be redirected back to your website.
The customer can view the transaction from the transaction list in the Maya App.
By clicking on a transaction record in the list, the customer can view the transaction summary.
The customer initiates cash-in via the Maya App.
The customer completes the request form to generate the cash-in code.
Once the steps are completed, Maya will generate a Cash-in code and provide it to the customer through the Maya app.
After generating the Cash-in Code, the customer may go to your nearest branch or kiosks to provide and process the Cash-in Code.
The customer can view the transaction from the transaction list in the Maya App.
By clicking on a transaction record in the list, the customer can view the transaction summary.
Transfer funds from your Business Deposit to a single recipient or multiple accounts.
For more details, go to Transfer funds from your Business Deposit via Maya Business Manager .
Maya uses OAuth 2.0 for user authorization. For more details, refer to authorization_code grant.
and
are the latest electronic funds transfer service that enables users to transfer funds to an account holder or multiple recipient accounts of other participating banks, e-money issuers, or mobile money operators in the Philippines.
For more details, refer to this page .
Check out our Cash-in via Maya Login Technical Guide for guidance on implementing this use case.
See the Technical Guide for Cash-in via Code Technical Guide on how to implement this use case.
Maya Partner Journey
Contact [email protected] to gain access to Maya’s platform and products. Existing partners can reach out to their dedicated Maya Relationship Manager for assistance.
By completing the steps below, you should be able to begin coding, or you may already have made substantial progress in developing your application or installing Maya's plugins.
Explore Maya Solutions
Maya API Products showcases all of Maya solutions. Explore the solutions and their functionalities to find the ideal for your needs. It includes links to references and guides for you to get started with your development.
Estimated Activities and Timelines
Considering internal complexities like engineering resources, system integrations, and team coordination, the integration with Maya can take anywhere from less than weeks to up to months.
| PHASE | ESTIMATES | TASKS |
|---|---|---|
| Merchant Account creation and Sandbox onboarding | 1 week | Creation of your merchant account begins upon submission of complete documentary requirements. Sandbox access is provided during this phase. |
| Build | 2-4 weeks | Build your application and integration. This may vary depending on your development timelines. |
| Test | 2-3 business days | Complete your end-to-end testing in Sandbox and provide your sign-off to Maya. This may vary depending on your testing activities and timelines. |
| Transition to Production | 1-2 weeks | This is based on Maya's estimated timeline which will only begin once you have completed all sandbox requirements. Access to Production is given during this phase. |
| Go Live | 2-3 business days | You may do pilot testing in Production or proceed to launch. Please share your public launch date to your Maya Relationship Manager. |
Know your Integration
Subject to the availability, Maya Solutions offers support for REST API, Plugin, and SDK integrations.
- REST APIs are widely used in web development because of their simplicity, scalability, and flexibility. It uses HTTP requests to perform CRUD (Create, Read, Update, Delete) operations on data.
- Plugins extend the capabilities of the host application, allowing users to utilize modular component software to customize and enhance their experience based on their specific needs and preferences.
- SDK stands for Software Development Kit. It offers pre-built components and functionalities that developers can use to build applications without starting from scratch. Available for Maya Checkout solution
| API | Plugins | SDK | |
|---|---|---|---|
| Integration Type | Protocol-based integration over HTTPS. | Installation via the host platform such as Shopify, WooCommerce or Magento. | Incorporates pre-built libraries, tools, and APIs into your application. |
| Developer Requirements | Understanding of HTTP methods (GET, POST, PUT, DELETE), JSON data format, and API documentation. and be able to build a platform that will directly interact with Maya's API endpoints. | Understanding of the host application and compatibility requirements to develop and deploy plugins. | Knowledge of programming languages supported by the SDK, familiarity with the SDK's APIs and tools, and development environment setup. |
| Benefits | Platform-independent, scalable, facilitates data exchange between different systems, and enables integration with third-party services. | Extends application functionalities without modifying the core application. | Provides pre-built components and tools, simplifies development, ensures consistency, and offers advanced features and functionalities. |
| Limitations | Requires network connectivity, potential latency issues, rate limits, data transfer costs, and security concerns related to data transmission and authentication. | Compatibility issues with host applications, potential performance overhead, security risks if plugins are not vetted or maintained, and dependency on host application updates. | Dependency on SDK updates and maintenance, platform-specific, potential learning curve for developers, compatibility challenges with different application versions. |
Know the Required Compliance
All Merchants that accept cards and/or are involved with the processing, transmitting, or storing of card data must comply with the Payment Card Industry Data Security Standards (PCI DSS) .
For more details, make sure to read the PCI DSS Merchants Guideline .
Set up your sandbox environment. Your technical team is responsible for developing, debugging, and testing your sandbox.
The Sandbox environment provides an instance for integrating Maya solutions and testing development builds, without the risk of impacting live transactions and real customers. See also API Environments .
Sandbox Access
You will be onboarded to Maya’s sandbox environment for access and testing. Generate your API keys via Maya Manager or coordinate with your Maya Relationship Manager.
You must use these sandbox keys for building and testing your integration in the sandbox.
Sandbox Test Accounts
Use the sandbox Maya Wallet account and mock cards listed in Sandbox Credentials and Cards .
Maya is the only e-wallet available for testing in Sandbox. Other e-wallets like GCash, QRPh, ShopeePay, and WeChat can only be tested in the Production environment. For further inquiries, you may reach out to your Maya Relationship Manager.
Testing Use Cases
Conduct your testing in the sandbox, covering successful transactions, and error handling.
Not all errors can be tested in the Sandbox. However, clients should check all possible scenarios to ensure their system handles them correctly.
Refer to the API reference or troubleshooting guides for the list of errors and handling. Alternatively, use the search box (upper right corner of the Maya Developer Hub) to find the related information.
If you require technical assistance, please submit a ticket to the Maya Developer Hub Service Desk (also known as the ASKMAYADEV). For more information about the ASKMAYADEV, refer to this guide .
Submit your sandbox testing result along with your signoff, to your Maya Relationship Manager.
This will also initiate Maya’s acceptance testing and review of your platform. Maya will review your integration, conduct testing, provide feedback, or approve to proceed to production. Your Maya Relations Manager will coordinate with you on the schedule of Maya's acceptance testing.
Coordinate with your Maya Relationship Manager and complete the following checklists to go live in production.
The Production environment represents the live setting where actual transactions will result in real charges. Your technical team is responsible for the maintenance, debugging, and monitoring of your production environment. API Environments
Before Going to Production
Checklist before going live in Production:
After Going Live in Production
Checklist after going live in Production:
You must use real cards and e-wallet accounts when testing transactions in production. Keep in mind that transactions performed in production will incur real charges.
Download the Maya App now and create a Maya Account to test your integration in production.
Please refrain from raising production concerns in ASKAMAYADEV.
Should you encounter any issues or have concerns in production, kindly reach out to our production support team at [email protected].
Share your feedback by completing the
Maya Developer Hub Integration Survey
to help us enhance our service and support.
Periodic Compliance Review
For further information, you may refer to PCI DSS Merchants Guideline and reach out to your Maya Relationship Manager.
Back-office and Operations
Maya understands that successful partner integration is crucial to your business operations, and we are dedicated to ensuring your continued success.
If you have immediate concerns about your onboarding and after-sales support with Maya, don’t hesitate to contact the assigned relationship manager for your account.
Our Support page resources are also available if you need help on issues encountered during your pre-production and post-production integration with Maya such as account funding, updating the recipients of Daily Transaction Reconciliation
, requests for API key renewal, inquiries related to settlement, and transaction reconciliation.
Daily Transaction Reconciliation
Supported for: Cash-in via Maya Login, Cash-in via Code, Cash-in from Maya Mini App
A daily report is generated and electronically mailed to the nominated recipient. This report includes all successful and failed transactions from the previous day. Refer to the Daily Transaction Reconciliation for more details.
Updated 3 months ago