Quick Start Guide

Accomplish these requirements to become an app within Maya

Acquire

Acquire the following documents or information from Maya:

  1. Onboarding form and checklist
  2. Vendor Security Questionnaire
  3. List of Maya IPs that needs to be whitelisted

📝 For Payment Onboarding requirements, kindly contact your Maya Relationship Manager.


Submit

Submit the following to your Maya account manager:

  1. Accomplished Onboarding form and checklist.
  2. Accomplished Vendor Security Questionnaire.

🔔 Review and approval of Vendor Security Questionnaire (VSQ) is mandatory for Production Go-live.

  1. Your Public GPG Key. Don't have GPG keys yet? Learn how .
  2. Icon in PNG or JPG/JPEG format

Review

Check out the references provided:

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

Create

Create the following endpoints in preparation to the integration activity:

  1. Session URL
  2. Landing page

ℹ️ See Before you integrate to learn more.

Receive the credentials and API keys from Maya:

Upon completion of partner onboarding you will be provided with the following tokens or keys.

  1. Maya Connect client ID
  2. Maya Connect client secret
  3. JWE and JWK keys to be used to decrypt profile data
  4. p2mid, if you have payments use case
  5. Fund Maya Wallet API Key, for withdrawal use case.

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


Integrate

Perform integration testing:

  1. Make sure that Maya IPs are whitelisted,
  2. Use Sandbox credentials and API keys acquired provided by Maya.
  3. Download the Sandbox application sent to your email, and use whitelisted Maya account. (This is based on email and mobile number provided on the Onboarding form.)
  4. [For Maya Payments Only] Set up your Sandbox Maya Business Manager account to view and manage transactions.
  5. [For Fund a Maya Wallet Only] Set up your MDTR Report Recipient, for the Sandbox Daily Transaction Reconciliation, see Know before you code .

Perform user acceptance testing:

  1. Create your own integration test scripts.
  2. Validate the session handshakes, transactions, settlement reports, and other scenarios based on Maya API requirements.
  3. Provide the Test cases to the Maya Relationship Manager 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 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. [For Maya Payments Only] Set up your Maya Business Manager account to view and manage transactions.
  3. [For Fund a Maya Wallet Only] Set up your MDTR Report Recipient, for the Daily Transaction Reconciliation, see Know before you code .
  4. Receive production credentials (API keys, etc.)
  5. 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/private GPG keys. Learn how .