Quick Start Guide

Quick Start Guide: Maya Biller Direct API

Acquire

Acquire the following documents or information from Maya:

  1. Technical Integration Form:
    1. For Direct API

ℹ️ 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 Direct API
    1. Accomplished Integration form and requirements.
    2. Provide Consolidated Business Requirements.
    3. Icon/logo in PNG or JPG/JPEG format.
    4. Your Public GPG Key which will be used in this step. Don't have PGP keys yet? Learn how.
    5. Callback strategy and expiration configuration, you may refer to Biller API Tech Guide.

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

Review

Check out the references provided:

📝Biller API Technical Details

view documentation
  1. Solution Kits, including:
    • API specification
    • API requirement
    • Sample codes (i.e. Applying keys and decrypting data, etc.)
    • Tutorial
    • FAQs
  2. Supporting articles
  3. Technical Overview / Walkthrough

Create

Maya Biller API Integration

  1. Receive the credentials and API keys from Maya:
    1. 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.
  2. Create the following endpoints in preparation to the integration activity:
    1. Validate URL
    2. Post URL
    3. Inquire URL (optional)
    4. Get Fee URL (optional)
  3. Receive access to the Maya Business Manager.

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

Integrate

Perform integration testing:

  1. Make sure that Maya IPs are whitelisted
  2. Use Staging credentials and API keys acquired provided by Maya.

Perform user acceptance testing:

  1. Create integration test script. For sample test scripts, you may download the Biller API Postman Collection.
  2. Validate the transactions, callbacks, settlement reports, and provide sign-off.

After your team is done with the development and you have been onboarded in the Staging Environment, you may now use the Biller API Postman Collection for testing. This requires a Postman application.

ℹ️ 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. 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

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

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.