Taxation · Clients & orders

Create taxation order

Place an order using client_id and service_id. Wallet is debited at catalog price.

POST request

URL: https://uat-api.vizodigital.com/api/v1/taxation/orders

Body

{
    "client_id": 42,
    "service_id": 1,
    "client_request_id": "ORDER_001"
}

Include a valid Bearer token with every request

Code sample

curl -X POST "https://uat-api.vizodigital.com/api/v1/taxation/orders" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "client_id": 42,
    "service_id": 1,
    "client_request_id": "ORDER_001"
}'

Success Response

{
    "status": "success",
    "message": "Order created successfully.",
    "data": {
        "order_id": 10,
        "api_request_id": "TX260819080011abcd1234",
        "client_request_id": "ORDER_001",
        "client_id": 42,
        "service_id": 1,
        "service_name": "PRIVATE LIMITED COMPANY REGISTRATION",
        "amount": 5499,
        "status": "pending",
        "created_at": "2026-08-19T08:00:11+00:00"
    },
    "fee": 5499,
    "wallet_balance": 4501
}

Failure response

{
    "status": "error",
    "message": "Request failed. Check credentials, wallet balance, or validation errors."
}

Overview

Debits the catalog price from the developer wallet (and white-label float when applicable). Do not send amount or service name.

On success the order is pending for fulfillment. Commission is credited immediately.

White-label developers also require the partner Taxation access to be Active.

Body

application/json required

Create taxation order request body

Schema

{
    "type": "object",
    "required": [
        "client_id",
        "service_id"
    ],
    "properties": {
        "client_id": {
            "type": "integer",
            "description": "From Create taxation client"
        },
        "service_id": {
            "type": "integer",
            "description": "From List taxation services"
        },
        "client_request_id": {
            "type": "string"
        }
    }
}

Example

{
    "client_id": 42,
    "service_id": 1,
    "client_request_id": "ORDER_001"
}

Responses

200 · application/json default

Successful response

Example

{
    "status": "success",
    "message": "Order created successfully.",
    "data": {
        "order_id": 10,
        "api_request_id": "TX260819080011abcd1234",
        "client_request_id": "ORDER_001",
        "client_id": 42,
        "service_id": 1,
        "service_name": "PRIVATE LIMITED COMPANY REGISTRATION",
        "amount": 5499,
        "status": "pending",
        "created_at": "2026-08-19T08:00:11+00:00"
    },
    "fee": 5499,
    "wallet_balance": 4501
}

Rate Limits

60/min