Requesting for API Authentication Keys

Please send the process details for requesting API authentication keys:

  1. Public-authorization key

  2. Secret-authorization key

  3. Refund-authorization key

To request API authentication keys for Maya, follow these steps:

  1. Public Key (pk-…) and Secret Key (sk-…): These are the only two types of API keys used for authentication in Maya. There is no separate ‘Refund-authorization key’; refunds use the same Secret Key as other transactional operations.
  • For Maya Checkout, Maya Vault, or Pay with Maya:

    • Use Maya Manager 1.0 (for Sandbox and Production): Log in, navigate to API Keys, select your merchant, and generate both Public and Secret keys.
    • Use Maya Business Manager (for Production only): Go to Solutions > Maya Checkout > Set up Online Payments, and generate the keys.
  • For Payments Processing Platform, Cash-in via Maya Login, or other solutions:

    • Contact your Maya Relationship Manager. You will need to provide:
      • The email address of your nominated key recipient.
      • Your public GPG key for encrypted delivery of the keys.
    • After onboarding, your API keys will be sent via an encrypted file, which you decrypt using your private GPG key.
  1. Important Notes:
  • Public and Secret keys are environment-specific (Sandbox vs. Production). Do not mix them.
  • Store keys securely. If compromised, revoke them and request new ones from your Relationship Manager or via the Manager portal.
  • Use Basic Authentication: Encode ‘pk-…:’ or ‘sk-…:’ in Base64 and include it in the Authorization header as ‘Basic ’.

It seems you may be referring to ‘Refund-authorization key’ as a separate entity, but Maya does not issue such a key. Refund operations are authenticated using the same Secret Key (sk-…) as other payment actions.

For Sandbox concerns and other technical implementation inquiries, please get in touch with us via:

  • Sandbox Health Page: Check real-time service status updates.
  • Maya Developer Hub Service Desk: File
    a ticket in Sandbox.

To Know More:

We value your input and would love to hear your insights. Please submit you feedback here.