Minted Connect
  1. Checkout
Minted Connect
E-Commerce API
  • Partner
  • E-Commerce API
  • Catalog
    • Products
      GET
    • Get Product
      GET
    • Prices
      GET
    • Categories
      GET
  • Customers
    • Create Customer
      POST
    • Update Customer
      PATCH
    • Remove Customer Id
      DELETE
    • Get Customer
      GET
  • Customer Address
    • Customer Address - List
      GET
    • Customer Address - Delete
      DELETE
    • Customer Address - Create (Shipping)
      POST
    • Customer Address - Create (Billing)
      POST
    • Customer Address - Create Multiple
      POST
  • Checkout
    • Get Basket
      GET
    • Get Incomplete Baskets
      GET
    • Add to Basket (New basket)
      POST
    • Add to Basket (Existing Basket)
      POST
    • Set Existing Address
      PATCH
    • Set Custom Address
      PATCH
    • Update Item
      PATCH
    • Delete Item
      DELETE
    • Clear Basket (Delete Items)
      DELETE
    • Payment Get All Types
      GET
    • Complete Basket
      PUT
    • Get Orders
      GET
    • Get Order
      POST
  • Legal
    • Legal Types
    • Partner Legal PDF
  1. Checkout

Complete Basket

Testing
Testing Env
https://api.staging.mintedconnect.com
Testing Env
https://api.staging.mintedconnect.com
PUT
https://api.staging.mintedconnect.com
/partner/ecom/basket/complete
Last modified:2024-08-11 13:02:31
Maintainer:Not configured
Payment & Card save callback regex patterns:
Payment: {{DOMAIN}}/pay/{token}/callback/(?:(success|fail))
Save Card: {{DOMAIN}}/pay/cards/{token}/callback/(?:(success|fail))
All error codes and messages comes from the Sipay; https://apidocs.sipay.com.tr/index.html#tag/appDurum
Examples;
Success; https://api.staging.mintedconnect.com/pay/cards/{token}/callback/success
Fail; https://api.staging.mintedconnect.com/pay/cards/{token}/callback/fail?reason=Error%20message&code=050

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:
3
Accept-Language
string 
optional
Default:
tr
Body Params application/json
external_customer_id
string 
required
>= 1 characters<= 110 characters
cart_token
string 
required
>= 32 characters<= 32 characters
payment_type
enum<string> 
required
Allowed values:
credit-cardcash
payment_reference
string 
required
>= 8 characters
payment
object 
required
card_holder
string 
required
>= 3 characters
card_number
string 
required
card_expiry
string 
required
>= 5 characters<= 5 characters
card_cvv
string 
required
>= 3 characters<= 4 characters
customer_ip
string 
optional
Example
{
    "external_customer_id": "{{external_customer_id}}",
    "cart_token": "{{cart_token}}",
    "payment_type": "credit-card",
    "payment_reference": "{% faker datatype.uuid %}",
    "payment": {
        "card_holder": "John Due",
        "card_number": "4048095010857528",
        "card_expiry": "05/28",
        "card_cvv": "000",
        "customer_ip": "127.0.0.1"
    }
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://api.staging.mintedconnect.com/partner/ecom/basket/complete' \
--header 'x-client-id;' \
--header 'api-version: 3' \
--header 'Accept-Language: tr' \
--header 'Content-Type: application/json' \
--data-raw '{
    "external_customer_id": "MTD0018232",
    "cart_token": "{{cart_token}}",
    "payment_type": "credit-card",
    "payment_reference": "{% faker datatype.uuid %}",
    "payment": {
        "card_holder": "John Due",
        "card_number": "4048095010857528",
        "card_expiry": "05/28",
        "card_cvv": "000",
        "customer_ip": "127.0.0.1"
    }
}'

Responses

🟢200OK
application/json
Body
data
object (Ecom Order) 
required
pricefix
object 
required
id
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": 19,
            "nextUpdate": "2024-06-26T04:01:41+03:00"
        },
        "id": 64,
        "guid": "C91D3611-8941-4D9D-AC13-367152DD155C",
        "token": "nuZJKTNkW2GqH4n0KXt4FZtnXl4tJFKq",
        "order_code": "AKAJZE2C",
        "external_id": "ee55cdc5-241e-4b86-9a49-96212ec77831",
        "increment_id": "MC_66C7446E7F53E",
        "channel": "api",
        "tx_type": "cart",
        "price": 2805.37,
        "tax": 0,
        "delivery_price": 65,
        "insurance_price": 8.12,
        "market_commission": 209.69,
        "minted_markup_price": 31.81,
        "silver_craftsmanship": 0,
        "total": 2805.37,
        "paid_total": 2886.16,
        "currency_rate": 1,
        "currency_total": 2805.37,
        "status_id": 1,
        "status_name": "Created",
        "order_at": "2024-06-26T03:58:19+03:00",
        "payment_cost": 80.79,
        "customer": {
            "external_id": "34788694-390a-4ed3-9426-555ff71f9685",
            "firstname": "John",
            "middlename": "",
            "lastname": "Due",
            "fullname": "John Due",
            "email": "[email protected]",
            "phone": "+905322808035",
            "gender": "M",
            "identity_number": "12345677938",
            "birthdate": "1970-01-31"
        },
        "items": [
            {
                "item_currency_id": 1000006,
                "item_currency_name": "Physical Gold",
                "product_id": 3000065,
                "product_name": "Minted 1 Gr 999,9 Külçe Altın (NadirGold)",
                "product_weight": 1.01,
                "spot_price": 2805.37,
                "price": 2805.37,
                "tax_rate": 0,
                "tax": 0,
                "amount": 1,
                "total": 2805.37,
                "currency_id": 1000003,
                "currency_rate": 1,
                "currency_total": 0
            }
        ],
        "shippingaddress": {
            "id": 9,
            "type": "shipping",
            "fullname": null,
            "phone": null,
            "city": "İstanbul",
            "county": "Beykoz",
            "district": "Acarlar Mah.",
            "street": "Sokak adı",
            "zipcode": null,
            "address": "54 sok. No: 12"
        },
        "billingaddress": {
            "id": 8,
            "type": "billing",
            "invoice_type": "Individual",
            "company_name": "Minted LTD",
            "tax_office": null,
            "tax_number": "2838293932",
            "fullname": null,
            "phone": "+905551112233",
            "email": "[email protected]",
            "city": "İstanbul",
            "county": "Beykoz",
            "district": "Acarlar Mah.",
            "street": "Sokak adı",
            "zipcode": null,
            "address": "54 sok. No: 13"
        },
        "payment": {
            "redirect_url": "http://mintedconnect.local/pay/lGJ5yPwJZ7mVH1w0BBj06WS0xGPkYaLJmoaEiZH3jtTyuNCiTRgQulrJ3GTMN8or3qyth42w08iI1lNQ2Ob1TFSAdPdgjD1pQyhdWeQ7IgiDeNteNs1qoIF0PUreVwAK/redirect",
            "token": "2qj2bdZrx9RlcMTgFTdcuAUA3bxJ3d9TOR5tThZcXZ2daSSi74KF3B45i3cEllmhO1O8UOp2J5UdaLJCndF0nQl9MXu5ozpG31deX6uFxBp7TFWHQ06oJOGrIthaWImm",
            "is_3d": true,
            "auth_mode": "auth",
            "amount": 2805.37,
            "state": "new",
            "comission": 80.79,
            "total": 2886.16,
            "details": []
        }
    },
    "success": true,
    "code": 0,
    "message": ""
}
🟠401Unauthorized
🟠422Parameter Error
Previous
Payment Get All Types
Next
Get Orders
Built with