Merchant Settings

Get merchant settings with our Integrator API service.

Perform the steps in this guide to get the payment card types and currencies supported by a specified merchant ID. See Merchant Settings in API Reference for field definitions.


Prerequisites

  1. Contact Maast Support at [email protected] to set up an integrator sandbox account with Integrator API capacity. Save the account's API security key.
  2. Save the merchant ID (mid) that Maast provides for your integrator sandbox account. Alternatively, follow the instructions in Generate Test Account to generate and save a new merchant ID (found as merchant_id in the response).

Implement

Write a GET request. For the request endpoint, include the merchant ID (mid) value by appending it to the end of /platform/vendor/settings/. The resulting endpoint will read /platform/vendor/settings/mid, where the merchant ID value replaces mid.

Your request will resemble the sample code below:

curl --request GET \
     --url https://api-test.maast.com/platform/vendor/settings/210000000289 \
     --header 'accept: application/json' \
     --header 'authorization: Basic OjllZGVjMjFhMzFjMHh5ejc4OWUzMGEzNDE2YWJjMTIz'

Integrate

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

{
  "code": 0,
  "message": "Success",
  "data": {
    "merchant_id": 210000000289,
    "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
      }
    ],
  }
}

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 information about the specified merchant account, including an array of accepted payment types and currencies and an array of payment profiles available for the merchant account. See Merchant Settings in API Reference for 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.