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
Modified at 2024-08-11 13:02:31
Previous
Payment Get All Types
Next
Get Orders
Built with