Create Seller

If you want to create a permanent record of a seller's details, use the Seller API to create it. See Non-Virtual Sellers.

📘

Note

If you do not want to store the seller's details, you can use the Transaction API to create the required seller information directly in the same request as the transaction. These sellers are called Virtual Sellers and they do not use this request.

For more information about the settings, see Seller Settings Overview.

For a list of the available fields, see Seller Settings Fields.

To create the seller, use a POST method and the following URL:

{service_uri}/marketplace/v1/sellers

where {service_uri} is the service's URI.

For example:

$ curl \
    -H "x-marketplace-token: ms_{ACCESS_TOKEN}" \
    -H "Content-Type: application/json" \
    -X POST \
    --data '{JSON}' \
    https://sellers-api.sandbox.marketplace.taxamo.com/marketplace/v1/sellers

where:

• {ACCESS_TOKEN} is your access token used for authentication.
• {JSON} is the body of the request where you specify the seller's details.

Details

Fields

A complete list of the available fields is provided in the Seller Settings Fields topic.

Response

When the record is created successfully, a 200 code is returned.