Quick Start Guide

Quick Start Guide: Maya Biller Direct API

Click here to view full details

Acquire and Submit

New to the Bills Payment API integration? Your team would need to acquire and submit the following requirements.

ℹ️ Reach out to your designated Maya Relationship Manager or email [email protected] ,to acquire the complete list of documents and forms.

Acquire the following documents or information from Maya:

  1. Get the Onboarding form and checklist.
  2. Provide consolidated Business requirements.
  3. Maya Bills Pay integration form (For API integration)
    1. Includes all technical requirements, such as test data, server details, input field requirements, etc.
    2. High-resolution icon/logo in PNG or JPG/JPEG format.
    3. Your Public GPG Key will be used in the Sandbox Integration stage. Don't have PGP keys yet? Learn how.
    4. For callback strategy and expiration configuration, refer to Biller API Tech Guide.
  4. Request for the Biller API Specifications.

⚠️ For Card Billers, use "Dummy" Card details when providing sample fields in the Integration Form.


Create and Develop

Step 1: Review the Biller API Technical Integration Guide and API SPecifications

Understand the different Biller APIs, its specifications, how authentication is performed, and integrated within the Bills payment transaction lifecycle.

Step 2: Create the following endpoints in preparation for the integration activity.

Before your Biller tile can be available within the Maya app, you will need to develop the prerequisite endpoints of your application to be integrated: Validate URL, Post URL, and Inquire URL.

  1. Validate URL
  2. Post URL
  3. Inquire URL
  4. Get Fee URL (optional)

ℹ️ Reach out to your designated Maya Relationship Manager or email [email protected] ,to request for the Biller API specifications (if not yet provided).

Step 3: Local Development Mock Testing

After developing your endpoints, use the Biller API Local Development Mock Testing Postman collection, to simulate the API calls between Maya and your platform.

⚠️ This tool is only for mock simulation only with your developed endpoints.

Step 4: Submit URLs and other onboarding requirements

Send to your designated Maya Relationship Manager, the following information to proceed with the technical onboarding in Maya's Sandbox environment.

  • Accomplished Maya Bills Payment Integration Form (for API integration)
  • Submit Submit Local Development Mock Testing results.

Sandbox Integration

Step 1: Setup the credentials and API keys

⚠️ As part of security measures, sharing of keys between Maya and the Partner shall follow secure key protocols, such as GPG encryption. Misuse or mishandling of tokens or keys within the jurisdiction of the Partner, could entail risk and vulnerability of transactions.

Credentials and keys will be received via an encrypted email. You should be able to decrypt it using your public and private GPG keys. Learn how.

ℹ️ Make sure to follow the type of request header per API endpoint. Refer to API Signature and Authorization , to learn more.

Step 2: Perform Sandbox Integration testing

  1. Make sure that Maya IPs are whitelisted
  2. Use Sandbox credentials and API keys acquired and provided by Maya.
  3. Download the Biller API Sandbox Integration Testing Postman collection, and follow the steps for integration testing between Maya and your platform.
  4. Validate the transactions, payment details, processing and posting, and the reports.

ℹ️ Email the Sandbox Integration testing results and sign-off to your desginated Maya Relationship Manager.


Go Live

After testing the integration in our staging environment, it is time to move to Production.

  1. Maya’s Fulfillment Team to send you your MID and Production Maya Business Manager Access.
  2. Set up your Maya Business Manager account
  3. Receive new credentials (API keys, etc.)
  4. Be ready for the Post Production Testing. Once launched in production, prepare the following:
    1. Download the Maya App
    2. Transaction Live accounts provided to Maya
    3. Reconciliation of expected transactions versus the settlement report and your database reports.

ℹ️ New credentials and keys will be provided for Production. It will be received via an encrypted email from Maya.
You may decrypt it using your public and private GPG keys. Learn how

Quick Start Guide: Maya Check Digit Validation

Click here to view full details

Acquire

Acquire the following documents or information from Maya:

  1. Technical Integration Form:
    1. Check Digit Validation (CDV)

ℹ️ Contact your Maya Relationship Manager to acquire the complete list of required documents and forms.

Submit

ℹ️ Pre-requisite: You have been onboarded to Maya business via your Relationship Manager

Submit the following to your Maya account manager:

  1. For Check Digit Validation
    1. Accomplished Integration form and requirements.
    2. Provide Consolidated Business Requirements.
    3. Icon/logo in PNG or JPG/JPEG format.
    4. Check digit logic

⚠️ If account numbers are random, too complex logic, does not have a pattern, and/or you only have a list of valid accounts, then Maya’s Bills Payment integration via Check Digit is NOT Possible.
For other integration options, you may refer here.

Review

Check out the references provided:

📝Check Digit Technical Details

view documentation
  1. Solution Kits, including:
    • Bills Payment CDV Flow
    • Tutorials (How to access Maya Manager, how to generate settlement reports, etc.)
    • FAQs
  2. Supporting articles
    1. How to Make your own Check Digit
  3. Technical Overview / Walkthrough

Create

Maya Biller CDV Integration

  1. Receive access to the Maya Business Manager.

⚠️ After submission of requirements, coordinate with your assigned Maya Relationship Manager for the Staging Integration.

Integrate

Perform user acceptance testing:

After the team is done with the CDV algorithm and onboarding, and you have been onboarded in the Staging Environment, next step is the user acceptance testing.

  1. Maya’s Quality Engineer to set a schedule with the Biller Partners and perform the demo of the transactions.
  2. The Biller Partners to validate transactions, settlement report, and provide sign-off.

ℹ️ Coordinate with your assigned Maya Relationship Manager for the sign-offs after the User Acceptance Testing.

Go Live

After testing the integration in our staging environment, it is time to move to Production.

  1. Maya’s Fulfillment Team to send you your MID and Production Maya Business Manager Access.
  2. Set up your Maya Business Manager account
  3. Be ready for the Post Production Testing. Once launched in production, prepare the following:
    1. Download the Maya App
    2. Transaction Live accounts provided to Maya
    3. Receiving of Daily Transaction Report via email.
    4. Validate Daily Transaction Report and Settlement Report.

Quick Start Guide: Maya Biller Portal

Click here to view full details

Acquire

Acquire the following documents or information from Maya:

  1. Technical Integration Form:
    1. For Maya Biller Portal

ℹ️ Contact your Maya Relationship Manager to acquire the complete list of required documents and forms.

Submit

ℹ️ Pre-requisite: You have been onboarded to Maya business via your Relationship Manager

Submit the following to your Maya account manager:

  1. For Maya Portal
    1. Accomplished Integration form and requirements.
    2. Provide Consolidated Business Requirements.
    3. Icon/logo in PNG or JPG/JPEG format

Review

Check out the references provided:

📝Maya Biller Portal Technical Details

view documentation
  1. Solution Kits, including:
    • Maya Biller Portal Flow
    • API requirement
    • Tutorials (How to access Maya Manager, how to generate settlement reports, etc.)
    • FAQs
  2. Supporting articles
  3. Technical Overview / Walkthrough

Create

Maya Biller Portal Integration

  1. Receive access to the Maya Business Manager
  2. Receive access to the Maya Biller Portal

⚠️ After submission of requirements, coordinate with your assigned Maya Relationship Manager for the Staging Integration.

Integrate

Perform user acceptance testing:

  1. After you have been onboarded in the Staging Environment, next step is the user acceptance testing.
    1. Maya’s Quality Engineer to set a schedule with the Biller Partners and perform the demo of the transactions.
    2. The Biller Partners to validate transactions, Maya Biller Portal, settlement reports, and provide sign-off.

ℹ️ Coordinate with your assigned Maya Product Manager for the sign-offs after the User Acceptance Testing.

Go Live

After testing the integration in our staging environment, it is time to move to Production.

  1. Maya’s Fulfillment Team to send you your MID and Production Maya Business Manager Access.
  2. Set up your Maya Business Manager account
  3. Set up your Maya Biller Portal
  4. Be ready for the Post Production Testing. Once launched in production, be ready with the following:
    1. Download the Maya App
    2. Transaction Live accounts provided to Maya
    3. Validate Biller Portal reports and settlement report.