Technical Documentations
Maya Tech BlogGo to Maya Business Manager

About Unified Transfer

⚠️

Unified Transfer is in active development. As a pioneer merchant, you will be informed of the updates through your Maya Relationship Manager.

Overview

The Unified Transfer is a secure, standards-based funds transfer solution that enables partners to initiate peer-to-peer (P2P) transfers between accounts across various financial institutions in the Philippines.

It serves as Maya’s unified fund transfer solution, providing streamlined access to the Philippines’ financial ecosystem through a single integration. Built on industry-standard protocols and designed for enterprise-grade reliability, Unified Transfer enables real-time and batch fund transfers across the country's major banking networks.

This reference provides a high-level technical overview of Unified Transfer, including supported environments and integration options, to help you understand the capabilities and requirements before you begin development.

Key Capabilities

Multi-Network Connectivity

Connect to over 100 Philippine financial institutions through multiple processing channels, including InstaPay (real-time), PESONet (batch), covering major banks, rural banks, and digital financial services providers across the Philippines.

Flexible Transfer Options

  • Real-time transfers via InstaPay for immediate fund availability (up to ₱50,000 per transaction, subject to network, bank, and account limits)
  • Batch processing via PESONet for higher-value transactions (up to ₱300,000 per transaction, subject to network, bank, and account limits)
  • Cross-network compatibility to ensure broad reach across different banking systems

Enterprise-Grade Security

Unified Transfer follows Financial-grade API (FAPI) standards, combining OAuth 2.0 authentication, cryptographic request signing, and encrypted transport to protect sensitive financial data and meet regulatory requirements.

Asynchronous Processing

Uses a two-phase transaction model (Initiate → Confirm) with callback-based notifications, enabling reliable processing during high-volume periods or temporary network interruptions.

Comprehensive Monitoring

Built-in transaction tracking, status inquiry endpoints, and detailed error reporting provide full visibility into transfer lifecycle and enable proactive issue resolution.

Business Value

  • Reduced Integration Complexity: A single integration provides access to multiple transfer networks, eliminating the need for separate integrations with individual banks or processors.

  • Enhanced User Experience: Real-time transfers and reliable status updates enable fast and transparent money movement experiences.

  • Regulatory Compliance: Built-in transaction monitoring, audit trails, and reporting support help partners meet BSP (Bangko Sentral ng Pilipinas) regulatory requirements.

  • Scalable Architecture: Cloud-native design supports high transaction volumes with automatic scaling and load balancing, making it suitable for mission-critical financial operations.

Target Use Cases

  • Digital wallets and fintech apps requiring interbank transfer capabilities
  • E-commerce platforms needing disbursement and payout functionality
  • Corporate treasury systems for supplier payments and payroll
  • Banking-as-a-Service (BaaS) providers building embedded financial products

Technical Summary

  • Product type: RESTful API for inter-bank domestic fund transfers
  • Integration method: REST APIs with OAuth 2.0 Client Credentials and FAPI-compliant request signing
  • Transaction Model: Two-phase (Initiate → Confirm) with asynchronous processing
  • Transfer Channels:
    • Maya - Internal channel for Maya-to-Maya transfers
    • InstaPay - ACH network for real-time interbank transfers
    • PESONet - ACH network for batch interbank transfers
  • Supported Currency: PHP (Philippine Peso)
  • Transaction Limits:
    • Maya: Varies by account and risk profile (see Maya Account Limits for details)
    • InstaPay: Up to ₱50,000 per transaction (subject to network and bank limits)
    • PESONet: Up to ₱300,000 per transaction (subject to network and bank limits)
  • Security:
    • OAuth 2.0 Client Credentials (Bearer tokens)
    • FAPI-compliant JWS request signing
    • HTTPS/TLS-only communication
  • Primary integration touchpoints:
    • Initiate Transfer – via REST API, to validate request and create transfer request
    • Confirm Transfer – via REST API, to begin processing
    • Callback notifications – for asynchronous, to receive transaction status updates
    • Status Inquiry – via REST API, retrieve transaction status at any time

Supported Environments

Unified Transfer is available in Sandbox and Production environments.

UTC Timezone

Unified Transfer, both Sandbox and Production, use Coordinated Universal Time (UTC, offset 0). This ensures consistency across partners operating in different time zones.

Sandbox Environment

  • Purpose: Initial development and basic functionality testing
  • API Base URL: https://sandbox.api.maya.ph/v1
  • OAuth Token URL: https://connect-sb-issuing.paymaya.com/token
  • Features: Full API simulation with test data
  • Limitations: No real money transactions

Production Environment

  • Purpose: Live production environment with real transactions
  • API Base URL: https://api.maya.ph/v1
  • OAuth Token URL: https://connect-issuing.paymaya.com/token
  • Features: Full production functionality
  • Access: Requires production credentials and approval

FAQs

Q: What makes the Unified Transfer different from other transfer solutions?

A: Unified Transfer provides a single integration point to access Maya, InstaPay, and PESONet. It removes the need for separate integrations while maintaining enterprise-grade security and regulatory compliance.

Q: Which financial institutions can I transfer funds to and from?

A: Unified Transfer supports transfers to and from over 100 Philippine financial institutions, including major commercial banks, rural banks, and digital providers. Transfers are processed via Maya (Maya-to-Maya), InstaPay (real-time interbank), and PESONet (batch interbank).

Q: What are the transaction limits and processing times?

Answers:

  • InstaPay: Real-time, up to ₱50,000 (subject to network and bank limits)
  • PESONet: Batch, typically same-day or next business day, up to ₱300,000 (subject to network and bank limits)
  • Maya: Limits vary by account

Q: Does the API support bulk or scheduled transfers?

A: Bulk and scheduled transfer capabilities are planned for future releases. Contact your Maya Relationship Manager for updates.

Q: Is the Unified Transfer suitable for high-volume operations?

A: Yes. The API is designed for high-throughput, enterprise-scale transaction processing.

Q: What compliance and regulatory requirements does the API meet?

A: The API is designed to support BSP regulatory requirements, with built-in transaction monitoring, audit trails, and reporting capabilities. It implements Financial-grade API (FAPI) security standards to protect sensitive financial data.

Next Steps

You now have an overview of Unified Transfer’s capabilities, security model, transaction lifecycle, and supported environments.

To continue: