Acknowledge a Seller Agreement

Sellers are required to acknowledge their assigned marketplace agreement before gaining access to the system.

Upon logging into the Dashboard for the first time, sellers will be presented with the agreement. Alternatively, they can also acknowledge it programmatically through the API.

This tutorial provides a step-by-step guide on how to acknowledge an agreement as a seller.

1

Authenticate as the seller owner

Authenticate as the seller admin linked as the owner of the seller account:

1. Use the tokenCreate mutation to generate an authentication token with the seller's credentials.
2. Include the generated token in the Authorization header of subsequent requests.

HTTP header

  {
  "Authorization" : "JWT {user-token}"
  }

2

Query the plan and seller ID

The following query returns the agreement information as well as the id of the seller attached to the current user:

Request

query {
  me {
    seller {
      id
      agreement {
        id
        commissionType
        defaultCommission
        granularCommissions {
          commission
          id
        }
        fixedFee
        feeFormat
        fees {
          feeType
          feeName
          feeScope
          feeValue
        }
        title
        content
        contentHtml
      }
    }
  }
}

Show more ↓

3

Acknowledge the agreement

With the seller id returned from the me query, the following mutation acknowledges the agreement:

Request

mutation {
  sellerAgreementAcknowledge(id: "U2VsbGVyOjI4") {
    user {
      id
      lastLogin
      email
      seller {
        companyName
        id
        agreementAcknowledged
      }
    }
  }
}