Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Tamara Orders API

Authorize, capture, cancel, retrieve, and update orders created via Tamara checkout sessions. Mirrors the online checkout lifecycle (new → approved → authorised → captured → refunded) and is the merchant's primary post-checkout integration surface.

Tamara Orders API is one of 11 APIs that Tamara publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Orders, Authorise, Capture, Cancel, and BNPL. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, and 1 JSON Schema.

This API exposes 4 operations across 4 paths, and defines 7 schemas. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against 2 base URLs: https://partner-api.tamara.co, https://partner-api-sandbox.tamara.co.

4 operations 4 paths 7 schemas 1 GET2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Base URL
https://api.tamara.co
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Tamara Orders API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth).

Paths & Operations 4

Across 4 paths, the API surfaces 4 operations — 1 GET, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Orders 4
GET
/orders/{order_id}
Get Order Details by Order ID
getOrderDetails 1 param → 200404
POST
/orders/{order_id}/authorise
Authorise Order
authoriseOrder 1 param → 200409
POST
/orders/{order_id}/cancel
Cancel Order
cancelOrder 1 param body → 200
PUT
/orders/{order_id}/reference-id
Update Order Reference ID
updateOrderReferenceId 1 param body → 200

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are Order (16 properties), AuthoriseResponse (7 properties), Item (6 properties), CancelRequest (5 properties). Each schema is shown below with its type and property counts.

Item
object
6 properties
Order
object
16 properties
CancelRequest
object
5 properties 1 required
Money
object
2 properties 2 required
AuthoriseResponse
object
7 properties
Error
object
2 properties
CancelResponse
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tamara-orders-api-openapi.yml Raw ↑

Other APIs Tamara publishes across the network.

Tamara In-Store Checkout API
Tamara Webhooks API
Tamara Disputes API
Tamara Pre-Checkout Eligibility API
Tamara Captures API
Tamara Channel Partner Webhooks API
Tamara Checkout Sessions API
Tamara Merchant API Keys API
Tamara Merchant Onboarding API
Tamara Refunds API