Complete Delivery

📌 General Definitions

total: Raw price of the basket.

paid_total: The final total amount the user will pay.

🛒 Buy Basket (Extra Fee Fields)

Field	Description	Example
`total`	Raw price	2184.24
`payment_cost`	Transaction cost	0
`paid_total`	Final price	2986.94
`charge_fee`	Service fee (10%)	218.42
`minting_fee`	Minting cost	109.21
`storage_fee`	Storage fee (20%)	436.85
`charges_vat`	VAT (5%)	38.22

Note: Depending on the rate settings, all of them can be zero, but the storage_fee will be 0 regardless of the rate if the storage limit is not exceeded (e.g., 50kg of precious metal - gold and/or silver).

💰 Sell Basket (Extra Fee Fields)

Field	Description	Example
`total`	Raw market value	2730.3
`charge_fee`	Service fee (10%)	273.03
`charges_vat`	VAT (5%)	13.65
`paid_total`	Net amount to receive	2443.62

🚚 Delivery Basket (Extra Fee Fields)

Field	Description	Example
`total`	Base price	3
`delivery_cost`	Shipping cost	3
`charges_vat`	VAT (5%)	0.17
`paid_total`	Final delivery cost	3.17

Request

Authorization

Provide your encrypted digest scheme data in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Digest username=guest, realm="test", nonce="2", uri="/uri", response="***"

Header Params

Body Params application/json

Example

{
  "external_customer_id": "{{customer_external_id}}",
  "cart_token": "{{cart_token}}",
  "shipping": {
    "fullname": "Ahmet Özer",
    "phone": "+905550001122",
    "email": "[email protected]",
    "city": "İstanbul",
    "county": "Çekmeköy",
    "district": "Alemdağ",
    "street": "Bulunmaz Sk.",
    "zipcode": "34711",
    "address": "No:1 D:2"
  }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

Examples

SuccessException

{
    "data": {
        "id": 11120,
        "guid": "2D71E4DE-EEEF-4584-A1E2-18D3E6C31DE7",
        "order_creation_status": "order",
        "external_id": null,
        "increment_id": "52214401357",
        "token": "1pdzioOizEzaJmEWwXa4Lydonrflc2Hx",
        "price_token": "yfWDT608zVUBk0iajLjSfu2eaWDxpiup",
        "type": "walletable_ecommerce",
        "price": 0,
        "tax": 0,
        "total": 3,
        "payment_cost": 0,
        "paid_total": 3.15,
        "delivery_cost": 3,
        "insurance_price": 0,
        "conversion_price": 0,
        "market_commission": 0,
        "minted_markup_price": 0,
        "silver_craftsmanship": 0,
        "charge_fee": 0,
        "charge_fee_rate": 10,
        "minting_fee": 0,
        "storage_fee": 0,
        "storage_fee_rate": 20,
        "charges_vat": 0.15,
        "vat_rate": 5,
        "currency_code": "AED",
        "status_id": 2,
        "status_name": "Pending",
        "customer": {
            "external_id": "7885b032-38fd-428e-b632-3af75c7df2c3",
            "firstname": "Terrence",
            "middlename": "",
            "lastname": "Brown",
            "fullname": "Terrence Brown",
            "email": "[email protected]",
            "phone": "+905322808035",
            "gender": "M",
            "identity_number": "12345677938",
            "tax_office": null,
            "birthdate": "1970-01-31",
            "account_type": "person"
        },
        "shippingaddress": {
            "id": 1931,
            "tax_number": "",
            "external_id": null,
            "fullname": "Ahmet Özer",
            "phone": "+905550001122",
            "email": "[email protected]",
            "city": "İstanbul",
            "county": "Çekmeköy",
            "district": "Alemdağ",
            "street": "Bulunmaz Sk.",
            "zipcode": "34711",
            "address": "No:1 D:2"
        },
        "billingaddress": null,
        "payment": null,
        "delivery": {
            "cargo_tracking_url": null,
            "cargo_tracking_number": null,
            "estimated_arrival_date": "2026-03-30"
        },
        "order_at": "2026-03-26T10:50:06.000000Z",
        "items": [
            {
                "item_currency_id": 1000013,
                "item_currency_name": "Dirham Gold",
                "product_id": 3000099,
                "sku": "MNTBAE0001",
                "product_name": "Minted 1 g 999.9 Gold Bar",
                "product_weight": 1,
                "price": 0,
                "tax_rate": 0,
                "tax": 0,
                "amount": 1,
                "total": 0,
                "product_images": [
                    "https://minted-tr.mncdn.com/products/10/Z1P5eT1ggOvmgyS5bwFeW1qZwS41zj5FOL3gu4Fv.png",
                    "https://minted-tr.mncdn.com/products/10/JxMzuWaZkljzWoVXzfKZPWYY2FeAU1TQY1sAtMnv.png",
                    "https://minted-tr.mncdn.com/products/10/qzyXgt51f7ndySM5QpMQqyDN6QBZXqAomsyshp5r.png",
                    "https://minted-tr.mncdn.com/products/10/sKZiiWqLA9PdejL5mG2sMWOyPJl7FWD95ILsYtx4.png"
                ],
                "prices": [
                    {
                        "id": 4,
                        "name": "Kargommmm",
                        "price": 3
                    }
                ]
            }
        ]
    },
    "success": true,
    "code": 0,
    "message": ""
}

🟠422NotExists

📌 General Definitions#

🛒 Buy Basket (Extra Fee Fields)#

💰 Sell Basket (Extra Fee Fields)#