This guide shows you how to use API to generate a new test merchant account. This returns a login name and a URL to set a password and access the account. See Generate Test Account in API Reference for field definitions.

Prerequisites

Contact Maast Support at [email protected] to set up an integrator sandbox account with Integrator API capacity. Save the API security key associated with that account.

Implement

Write a POST request to send to the /platform/vendor/settings/account/add request endpoint. See the sample code below:

curl --request POST \
     --url https://api-test.maast.com/platform/vendor/settings/account/add \
     --header 'accept: application/json' \
     --header 'authorization: Basic OjllZGVjMjFhMzFjMHh5ejc4OWUzMGEzNDE2YWJjMTIz' \
     --header 'content-type: application/json'

You now have the option to include test account information in the body of the request, such as the user name, email, and login information. See this function's API Reference for details.

Your configured request will resemble the sample code below:

curl --request POST \
     --url https://api-test.maast.com/platform/vendor/settings/account/add \
     --header 'accept: application/json' \
     --header 'authorization: Basic OjllZGVjMjFhMzFjMHh5ejc4OWUzMGEzNDE2YWJjMTIz' \
     --header 'content-type: application/json' \
     --data '
{
     "dba_name": "My Test Account",
     "user_login": "testusername",
     "user_first_name": "Joe",
     "user_last_name": "Smith",
     "user_email": "[email protected]"
}
'

Integrate

Send your request. You will receive a response like this from the Maast server:

{
  "code": 0,
  "message": "Success",
  "data": {
    "app_id": 501722,
    "merchant_id": 212000010001,
    "dba_name": "My Test Account",
    "payments_accepted": [
      {
        "card_type": "VS",
        "currency": "[840,124]"
      }
    ],
    "payment_profiles": [
      {
        "profile_id": "21200001000100000840",
        "label": "YOUR PROFILE - USD",
        "currency": "840",
        "auto_close_time": 2100
      }
    ],
    "user_login": "testusername",
    "reset_url": "https://app-test.maast.com/login/recover/b8b1e2cf5f7811e8bf8bacde48001122"
  }
}

Check the code field in the request response: 0 confirms success. If the value is something other than 0, check Platform API Response Codes in Reference.

The data field shows the test account's information, including the reset_url that the test user can follow to insert their login name (user_login) and create a new password for the test account. See Generate Test Account in API Reference for all response field definitions.

Test

Start testing now at https://api-test.maast.com.

Go Live

Follow these steps to start transacting with an active production account:

• Contact your sales representative or apply for your production account here.
• Once Maast has approved your production account, log in to Maast Manager.
• Get your production API key and production merchant ID the same way you got your sandbox credentials.
• Start transacting at https://api.maast.com.