Accounts APIs

Contents

Overview

The Account represents a merchant’s customer. As such it can contain as much or as little information as you collect about the customers (people or organizations) to which you offer billing and subscriptions. Subscriptions and Transactions must belong to an Account - as such, Accounts will be required in MarketONE for billing. An Account can have any number of children accounts and may have up to one parent account. An Account owns the “on file” payment methods to be used by it in billing. Payment Methods can be created at the same time as an Account is created or updated, but when updating an existing Payment Method the Payment Method endpoint must be used.

Accounts APIs

The following table lists and describes the Accounts APIs.

API Description
GET /v2/accounts This API retrieves a list of accounts according to specific criteria.
GET /v2/accounts/{id} This API retrieves a specific account.
POST /v2/accounts This API creates an account.
POST /v2/accounts/{id} This API updates a specific account.
Note: Any parameters provided will be updated, leaving other parameters unchanged.

MarketONE Developer Portal

Please refer to the MarketONE APIs - V2 section under the API Reference menu on the MarketONE Developer Portal for an OpenAPI instance of these APIs.

Revision History

Version Description
2020.01 Added this topic.
2020.05 Added the MarketONE Developer Portal sections.