API Authentication

Authenticating requests

Every request made to the Seller Transaction API needs to include a header that includes secret token that will prove the identity of the source of the request.

That secret token should be put in the x-marketplace-seller-token HTTP header:

A properly authenticated POST request looks like this:

POST https://.../api/v3/seller/tax/calculate HTTP/1.1
x-marketplace-seller-token: seller_token_********
Content-Type: application/json
Accept: */*
Content-Length: 1048

{ ... }

You can also use the curl command line utility to perform the authentication. The following is an example of this:

$ curl --request POST \
  --url https://.../api/v3/seller/tax/calculate \
  --header 'Content-Type: application/json' \
  --header 'x-marketplace-seller-token: seller_token_********' \
  --data '{ ... }'

API token

The token is available in the Dashboard under Settings -> API access -> View API tokens

Credit Card Verification

If you have not specified your credit card details, your requests will return an error code indicating that these are missing.

If you are using the sandbox environment, you need to add the test credit card details. If you are using the production environment, you need to add your credit card details.