Add to Basket (New basket)

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

x-client-id

string

required

Default value: web

Default:

web

api-version

string

optional

Latest version: 3

Default:

Accept-Language

string

optional

Default:

Body Params application/json

external_customer_id

string

required

>= 1 characters<= 110 characters

sku

string

required

qty

number

required

card_bin

string

optional

>= 6 characters<= 6 characters

Example

{
    "external_customer_id": "{{customer_external_id}}",
    "sku": "MNT0001",
    "qty": 1,
    "card_bin": "535616"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

data

object (Ecom Order)

required

pricefix

object

required

integer

required

guid

string

required

order_creation_status

enum<string>

required

Allowed values:

basketorder

token

string

required

external_id

string | null

optional

>= 1 characters<= 110 characters

increment_id

string

required

>= 16 characters<= 16 characters

price

number

required

tax

number

required

total

number

required

delivery_price

number

required

insurance_price

number

required

market_commission

number

required

minted_markup_price

number

required

silver_craftsmanship

number

required

paid_total

number

required

currency_rate

number

optional

currency_total

number

optional

status_id

integer

required

status_name

enum<string>

required

Allowed values:

PendingProcessingCancelledCompletedPreparingPackedShippedTransferringRefundingRefundedPayment Confirmed

delivery

object | null

optional

order_at

string <date-time>

required

Example:

2024-07-19T09:39:03.000000Z

payment_cost

number

required

items

array[object (Ecom OrderItem) {13}]

optional

customer

object (Order customer schema)

required

shippingaddress

optional

billingaddress

optional

payment

required

success

boolean

required

code

integer

required

message

string

required

Example

{
    "data": {
        "pricefix": {
            "remaining": -2,
            "nextUpdate": "2024-07-19T12:42:34+03:00"
        },
        "id": 207,
        "guid": "8C624BD0-3BE4-45A2-9B63-D570477007FA",
        "order_creation_status": "basket",
        "external_id": null,
        "increment_id": "MC_66C7446E7F53E",
        "token": "KOQS6Kh6j3dd0TdcmXqoC68h5O6i2tc2",
        "price": 2960.3,
        "delivery_price": 65,
        "insurance_price": 8.12,
        "market_commission": 209.69,
        "minted_markup_price": 31.81,
        "silver_craftsmanship": 0,
        "tax": 0,
        "total": 2960.3,
        "payment_cost": 0,
        "paid_total": 2960.3,
        "currency_code": "TRY",
        "status_id": 1,
        "status_name": "Created",
        "customer": {
            "external_id": "66b3666fcc19b0487e691695",
            "firstname": "John",
            "middlename": "",
            "lastname": "Due",
            "fullname": "John Due",
            "email": "[email protected]",
            "phone": "+905330000000",
            "gender": "M",
            "identity_number": "12345677937",
            "birthdate": "1970-01-31"
        },
        "shippingaddress": {
            "id": 6,
            "tax_number": "12312312",
            "external_id": "66b3666fcc19b0487e691695",
            "fullname": "John Due",
            "phone": "+905330000000",
            "city": "İstanbul",
            "county": "Beykoz",
            "district": "Acarlar Mah.",
            "street": "Sokak adı",
            "zipcode": "",
            "address": "54 sok. No: 12"
        },
        "billingaddress": {
            "id": 7,
            "type": "billing",
            "invoice_type": "Individual",
            "company_name": "Minted LTD",
            "tax_office": "Beykoz",
            "tax_number": "2838293932",
            "external_id": "66b3666fcc19b0487e691695",
            "fullname": "John Due",
            "phone": "+905330000000",
            "email": "[email protected]",
            "city": "İstanbul",
            "county": "Beykoz",
            "district": "Acarlar Mah.",
            "street": "Sokak adı",
            "zipcode": "",
            "address": "54 sok. No: 13"
        },
        "payment": null,
        "order_at": "2024-07-19T09:39:03.000000Z",
        "items": [
            {
                "item_currency_id": 1000006,
                "item_currency_name": "Physical Gold",
                "product_id": 3000065,
                "sku": "MNT0001",
                "product_name": "Minted 1 Gr 999,9 Külçe Altın (NadirGold)",
                "product_weight": 1.01,
                "price": 2960.3,
                "tax_rate": 0,
                "tax": 0,
                "amount": 1,
                "total": 2960.3,
                "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": 1,
                        "name": "Minted Markup",
                        "price": 0
                    },
                    {
                        "id": 2,
                        "name": "Sigorta",
                        "price": 5.44
                    },
                    {
                        "id": 4,
                        "name": "Kargo",
                        "price": 0
                    },
                    {
                        "id": 3,
                        "name": "Market Komisyon",
                        "price": 190.68
                    }
                ]
            }
        ]
    },
    "success": true,
    "code": 0,
    "message": ""
}

🟠401Unauthorized

🟠422Parameter Error

🟠404Record Not Found