---
updatedAt: 2026-06-24T07:43:44.000Z
agentTools:
projectIndex: https://docs.tamara.co/llms.txt
---
# Authorise Order
This endpoint plays a crucial role in the online checkout flow and should be executed upon receipt of the `approved` status webook event from **Tamara**. Its primary function is to update the order status to `authorised` ensuring status synchronization and smooth progression of the online order flow.
We now support Auto-authorisation!
If this is enabled, then the order status will move from New --> Approved --> Fully Captured without you having to call the Authorisation API explicitly.
If an order is not Captured within 21 days from when it is Authorised, Tamara will auto-capture that order and it will be moved to Fully Captured status.
# OpenAPI definition
```json
{
"openapi": "3.0.3",
"info": {
"title": "Tamara Public APIs v1.0",
"version": "1.0.0",
"contact": {}
},
"servers": [
{
"url": "https://{environment}.tamara.co/",
"variables": {
"environment": {
"enum": [
"api-sandbox",
"api"
],
"default": "api-sandbox",
"description": "Choose the environment you'd like to test on, either Sandbox (uses testing API tokens) `api-sandbox` or Production (uses live API tokens) `api`"
}
}
}
],
"components": {
"securitySchemes": {
"bearerToken": {
"type": "http",
"scheme": "bearer",
"description": "Enter the API token that is provided by Tamara to be sent in Authorization header."
}
}
},
"security": [
{
"bearerToken": []
}
],
"paths": {
"/orders/{order_id}/authorise": {
"post": {
"tags": [
"Online Checkout"
],
"summary": "Authorise Order",
"description": "This endpoint plays a crucial role in the online checkout flow and should be executed upon receipt of the `approved` status webook event from **Tamara**. Its primary function is to update the order status to `authorised` ensuring status synchronization and smooth progression of the online order flow.",
"operationId": "authoriseOrder",
"responses": {
"200": {
"description": "Authorisation Successful",
"content": {
"application/json": {
"schema": {
"properties": {
"order_id": {
"type": "string",
"format": "uuid"
},
"status": {
"type": "string"
},
"order_expiry_time": {
"type": "string"
},
"payment_type": {
"type": "string",
"enum": [
"PAY_BY_INSTALMENTS",
"PAY_NOW"
]
},
"auto_captured": {
"type": "boolean"
},
"authorized_amount": {
"type": "array",
"items": {
"properties": {
"amount": {
"type": "number"
},
"currency": {
"type": "string",
"enum": [
"SAR",
"AED",
"KWD",
"BHD",
"OMR"
]
}
}
}
},
"capture_id": {
"type": "string",
"format": "uuid"
}
},
"x-readme-ref-name": "authorise"
},
"examples": {
"Success": {
"value": {
"order_id": "0ac038ef-de4a-491c-828e-b02ec0d4582d",
"status": "authorised",
"order_expiry_time": "2023-06-04T15:07:47.000Z",
"payment_type": "PAY_BY_INSTALMENTS",
"auto_captured": false,
"authorized_amount": {
"amount": 300,
"currency": "SAR"
},
"capture_id": ""
}
},
"Success - Auto Capture Enabled": {
"value": {
"order_id": "0ac038ef-de4a-491c-828e-b02ec0d4582d",
"status": "fully_captured",
"order_expiry_time": "2023-07-04T12:07:43.000Z",
"payment_type": "PAY_BY_INSTALMENTS",
"auto_captured": true,
"authorized_amount": {
"amount": 300,
"currency": "SAR"
},
"capture_id": "bd10fc2c-4db8-426e-a1fd-b16388d42c01"
}
}
}
}
}
}
}
},
"parameters": [
{
"name": "order_id",
"in": "path",
"required": true,
"description": "Unique Tamara `order_id`, obtained from the response of create checkout/in-store checkout session endpoint.",
"schema": {
"type": "string",
"format": "uuid",
"example": "ff776045-513b-4cd7-8b4f-e60673daad84",
"default": "ff776045-513b-4cd7-8b4f-e60673daad84"
}
}
]
}
},
"tags": [
{
"name": "Online Checkout"
}
],
"x-readme": {
"explorer-enabled": true,
"proxy-enabled": true,
"samples-languages": [
"json",
"shell",
"python",
"php",
"swift",
"http",
"java",
"kotlin",
"r",
"ruby",
"node",
"javascript",
"c",
"csharp",
"cplusplus",
"go",
"objectivec"
]
}
}
```