Acquire and Submit

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

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.

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)

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.

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

Credentials and keys will be encrypted and received via e-mail. You should be able to decrypt it using your private GPG key. Learn how.

Step 2: Perform Sandbox Integration testing

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

Step 3: Perform User Acceptance testing

1. Maya’s Relationship Manager to set a schedule with the Biller Partners and perform the demo of the transactions.

Go Live

After testing the integration in our Sandbox 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 Production credentials (API keys, etc.) and configure/use them in your Production environment services.
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.

Acquire

Acquire the following documents or information from Maya:

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

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
   5. List of preferred fields to be included in your Daily Transaction Report (Daily Extract Report).

Review

Check out the references provided:

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.

Integrate

Perform user acceptance testing:

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

1. Maya’s Relationship Manager 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.

Go Live

After testing the integration in our Sandbox 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.

Acquire

Acquire the following documents or information from Maya:

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

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.
   4. List of e-mail addresses to be given initial access to the Biller Portal in Production.

Review

Check out the references provided:

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

Integrate

Perform user acceptance testing:

1. After you have been onboarded in the Sandbox Environment, next step is the user acceptance testing.
   1. Maya’s Relationship Manager 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, and provide sign-off.

Go Live

After testing the integration in our Sandbox 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. Manually validate transactions done.
   4. Validate Biller Portal reports and settlement report.