Complete Basket - Minted Connect

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:

Accept-Language

string

optional

Default:

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

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": 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