Create Basket / Add Basket Item

📌 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/jsonRequired

Example

{
  "external_customer_id": "{{customer_external_id}}",
  "cart_token": "{{cart_token}}",
  "type": "buy",
  "sku": "MNTBAE0001",
  "qty": 1
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

Examples

SuccessException

{
    "data": {
        "pricefix": {
            "remaining": 207,
            "nextUpdate": "2026-03-13T15:17:35+03:00"
        },
        "id": 11119,
        "guid": "7978F1C8-7D5E-45F3-897C-A08C21390F89",
        "order_creation_status": "basket",
        "external_id": null,
        "increment_id": "40399701194",
        "token": "26OIDShjUxwGkIhMqJC23XdQlt8xVvAT",
        "price_token": "v9OXM7OhQLHey4m3xieyeUwuJqhaUHX6",
        "type": "buy",
        "price": 1595.27,
        "tax": 0,
        "total": 1595.27,
        "payment_cost": 0,
        "paid_total": 2181.53,
        "delivery_cost": 0,
        "insurance_price": 0,
        "conversion_price": 0,
        "market_commission": 0,
        "minted_markup_price": 0,
        "silver_craftsmanship": 0,
        "charge_fee": 159.53,
        "charge_fee_rate": 10,
        "minting_fee": 79.76,
        "storage_fee": 319.05,
        "storage_fee_rate": 20,
        "charges_vat": 27.92,
        "vat_rate": 5,
        "currency_code": "AED",
        "status_id": 1,
        "status_name": "Created",
        "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": null,
        "billingaddress": null,
        "payment": null,
        "delivery": null,
        "order_at": "2026-03-13T12:13:17.000000Z",
        "items": [
            {
                "item_currency_id": 1000019,
                "item_currency_name": "Dirham Silver",
                "product_id": 3000100,
                "sku": "MNTBAE0013",
                "product_name": "Minted 50 g 999.0 Silver Bar",
                "product_weight": 50,
                "price": 496,
                "tax_rate": 0,
                "tax": 0,
                "amount": 1,
                "total": 496,
                "product_images": [
                    "https://minted-tr.mncdn.com/products/25/YToYYHKI2qwxGY6hFhLg2t01b7ktbZHeaqip9PvN.png",
                    "https://minted-tr.mncdn.com/products/25/nNuD08frgQLkbrL8UicTht6XexeHP3fSdhs73OTD.png"
                ],
                "prices": [
                    {
                        "id": 7,
                        "name": "Mint Ücreti",
                        "price": 24.8
                    }
                ]
            },
            {
                "item_currency_id": 1000019,
                "item_currency_name": "Dirham Silver",
                "product_id": 3000100,
                "sku": "MNTBAE0013",
                "product_name": "Minted 50 g 999.0 Silver Bar",
                "product_weight": 50,
                "price": 496,
                "tax_rate": 0,
                "tax": 0,
                "amount": 1,
                "total": 496,
                "product_images": [
                    "https://minted-tr.mncdn.com/products/25/YToYYHKI2qwxGY6hFhLg2t01b7ktbZHeaqip9PvN.png",
                    "https://minted-tr.mncdn.com/products/25/nNuD08frgQLkbrL8UicTht6XexeHP3fSdhs73OTD.png"
                ],
                "prices": [
                    {
                        "id": 7,
                        "name": "Mint Ücreti",
                        "price": 24.8
                    }
                ]
            },
            {
                "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": 603.27,
                "tax_rate": 0,
                "tax": 0,
                "amount": 1,
                "total": 603.27,
                "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": 7,
                        "name": "Mint Ücreti",
                        "price": 30.16
                    }
                ]
            }
        ],
        "tx_type": "oneoffpurchase"
    },
    "success": true,
    "code": 0,
    "message": ""
}

🟠422Validation

Create Basket / Add Basket Item

📌 General Definitions#

🛒 Buy Basket (Extra Fee Fields)#

💰 Sell Basket (Extra Fee Fields)#