Introduction

The Subtotal API is built on REST principles, ensuring a stateless, scalable, and reliable interface for interacting with merchant accounts on behalf of customers.

Our API reference provides all the necessary details to integrate Subtotal’s features into your application, including endpoint descriptions, request and response formats, and examples.

Base URL

Append an endpoint to the base URL root address to form a complete request URL.

https://api.subtotal.com

Authentication

All API endpoints are authenticated using API keys. Include the following headers in every request.

headers = {
  "X-Api-Key-Id": "{yourkeyid}",
  "X-Api-Key": "{yourkeyvalue}",
  ...
}

Authorization

We reserve the Authorization header for endpoints that require a connection token.

headers = {
  "Authorization": "Bearer: {connection_token}",
  ...
}