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
- Contact Maast Support at [email protected] to set up an integrator sandbox account with Integrator API capacity. Save the account's API security key.
- 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 asmerchant_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.
Updated almost 2 years ago