Criar pedido - Yampi Developer Portal

Criar pedido

curl --request POST \
  --url https://api.dooki.com.br/v2/{alias}/orders \
  --header 'Content-Type: application/json' \
  --header 'User-Secret-Key: <api-key>' \
  --header 'User-Token: <api-key>' \
  --data '
{
  "number": 123,
  "customer_id": 123,
  "value_total": 123,
  "value_products": 1,
  "value_discount": 1,
  "value_shipment": 1,
  "shipment_service": "<string>",
  "days_delivery": 1,
  "items": [
    {
      "product_id": 123,
      "sku_id": 123,
      "sku": "<string>",
      "quantity": 2,
      "price": 1,
      "gift": true,
      "gift_value": 1,
      "has_recomm": true
    }
  ],
  "address": [
    {
      "receiver": "<string>",
      "zipcode": "<string>",
      "street": "<string>",
      "number": "<string>",
      "neighborhood": "<string>",
      "city": "<string>",
      "uf": "<string>"
    }
  ],
  "marketplace_id": 123,
  "marketplace_account_id": 123,
  "authorized": true,
  "marketplace_sale_number": "<string>",
  "value_tax": 1,
  "ip": "200.179.10.10",
  "transactions": [
    {
      "customer_id": 123,
      "authorized_at": "2025-07-31 23:59:59",
      "amount": 1,
      "installments": 2,
      "holder_name": "<string>",
      "holder_document": "<string>",
      "payment_id": 123,
      "affiliation_id": 123,
      "marketplace_id": 123,
      "marketplace_account_id": 123,
      "authorized": true,
      "captured": true,
      "captured_at": "2025-07-31 23:59:59",
      "cancelled": true,
      "billet_url": "<string>",
      "billet_date": "2023-12-25"
    }
  ],
  "sent_to_antifraud": true,
  "capture_date": "2023-12-25",
  "authorized_at": "2025-07-31 23:59:59",
  "captured_at": "2025-07-31 23:59:59",
  "cancelled_at": "2025-07-31 23:59:59",
  "track_code": "<string>",
  "track_url": "<string>"
}
'

import requests

url = "https://api.dooki.com.br/v2/{alias}/orders"

payload = {
    "number": 123,
    "customer_id": 123,
    "value_total": 123,
    "value_products": 1,
    "value_discount": 1,
    "value_shipment": 1,
    "shipment_service": "<string>",
    "days_delivery": 1,
    "items": [
        {
            "product_id": 123,
            "sku_id": 123,
            "sku": "<string>",
            "quantity": 2,
            "price": 1,
            "gift": True,
            "gift_value": 1,
            "has_recomm": True
        }
    ],
    "address": [
        {
            "receiver": "<string>",
            "zipcode": "<string>",
            "street": "<string>",
            "number": "<string>",
            "neighborhood": "<string>",
            "city": "<string>",
            "uf": "<string>"
        }
    ],
    "marketplace_id": 123,
    "marketplace_account_id": 123,
    "authorized": True,
    "marketplace_sale_number": "<string>",
    "value_tax": 1,
    "ip": "200.179.10.10",
    "transactions": [
        {
            "customer_id": 123,
            "authorized_at": "2025-07-31 23:59:59",
            "amount": 1,
            "installments": 2,
            "holder_name": "<string>",
            "holder_document": "<string>",
            "payment_id": 123,
            "affiliation_id": 123,
            "marketplace_id": 123,
            "marketplace_account_id": 123,
            "authorized": True,
            "captured": True,
            "captured_at": "2025-07-31 23:59:59",
            "cancelled": True,
            "billet_url": "<string>",
            "billet_date": "2023-12-25"
        }
    ],
    "sent_to_antifraud": True,
    "capture_date": "2023-12-25",
    "authorized_at": "2025-07-31 23:59:59",
    "captured_at": "2025-07-31 23:59:59",
    "cancelled_at": "2025-07-31 23:59:59",
    "track_code": "<string>",
    "track_url": "<string>"
}
headers = {
    "User-Token": "<api-key>",
    "User-Secret-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'User-Token': '<api-key>',
    'User-Secret-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    number: 123,
    customer_id: 123,
    value_total: 123,
    value_products: 1,
    value_discount: 1,
    value_shipment: 1,
    shipment_service: '<string>',
    days_delivery: 1,
    items: [
      {
        product_id: 123,
        sku_id: 123,
        sku: '<string>',
        quantity: 2,
        price: 1,
        gift: true,
        gift_value: 1,
        has_recomm: true
      }
    ],
    address: [
      {
        receiver: '<string>',
        zipcode: '<string>',
        street: '<string>',
        number: '<string>',
        neighborhood: '<string>',
        city: '<string>',
        uf: '<string>'
      }
    ],
    marketplace_id: 123,
    marketplace_account_id: 123,
    authorized: true,
    marketplace_sale_number: '<string>',
    value_tax: 1,
    ip: '200.179.10.10',
    transactions: [
      {
        customer_id: 123,
        authorized_at: '2025-07-31 23:59:59',
        amount: 1,
        installments: 2,
        holder_name: '<string>',
        holder_document: '<string>',
        payment_id: 123,
        affiliation_id: 123,
        marketplace_id: 123,
        marketplace_account_id: 123,
        authorized: true,
        captured: true,
        captured_at: '2025-07-31 23:59:59',
        cancelled: true,
        billet_url: '<string>',
        billet_date: '2023-12-25'
      }
    ],
    sent_to_antifraud: true,
    capture_date: '2023-12-25',
    authorized_at: '2025-07-31 23:59:59',
    captured_at: '2025-07-31 23:59:59',
    cancelled_at: '2025-07-31 23:59:59',
    track_code: '<string>',
    track_url: '<string>'
  })
};

fetch('https://api.dooki.com.br/v2/{alias}/orders', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dooki.com.br/v2/{alias}/orders",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'number' => 123,
    'customer_id' => 123,
    'value_total' => 123,
    'value_products' => 1,
    'value_discount' => 1,
    'value_shipment' => 1,
    'shipment_service' => '<string>',
    'days_delivery' => 1,
    'items' => [
        [
                'product_id' => 123,
                'sku_id' => 123,
                'sku' => '<string>',
                'quantity' => 2,
                'price' => 1,
                'gift' => true,
                'gift_value' => 1,
                'has_recomm' => true
        ]
    ],
    'address' => [
        [
                'receiver' => '<string>',
                'zipcode' => '<string>',
                'street' => '<string>',
                'number' => '<string>',
                'neighborhood' => '<string>',
                'city' => '<string>',
                'uf' => '<string>'
        ]
    ],
    'marketplace_id' => 123,
    'marketplace_account_id' => 123,
    'authorized' => true,
    'marketplace_sale_number' => '<string>',
    'value_tax' => 1,
    'ip' => '200.179.10.10',
    'transactions' => [
        [
                'customer_id' => 123,
                'authorized_at' => '2025-07-31 23:59:59',
                'amount' => 1,
                'installments' => 2,
                'holder_name' => '<string>',
                'holder_document' => '<string>',
                'payment_id' => 123,
                'affiliation_id' => 123,
                'marketplace_id' => 123,
                'marketplace_account_id' => 123,
                'authorized' => true,
                'captured' => true,
                'captured_at' => '2025-07-31 23:59:59',
                'cancelled' => true,
                'billet_url' => '<string>',
                'billet_date' => '2023-12-25'
        ]
    ],
    'sent_to_antifraud' => true,
    'capture_date' => '2023-12-25',
    'authorized_at' => '2025-07-31 23:59:59',
    'captured_at' => '2025-07-31 23:59:59',
    'cancelled_at' => '2025-07-31 23:59:59',
    'track_code' => '<string>',
    'track_url' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "User-Secret-Key: <api-key>",
    "User-Token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dooki.com.br/v2/{alias}/orders"

	payload := strings.NewReader("{\n  \"number\": 123,\n  \"customer_id\": 123,\n  \"value_total\": 123,\n  \"value_products\": 1,\n  \"value_discount\": 1,\n  \"value_shipment\": 1,\n  \"shipment_service\": \"<string>\",\n  \"days_delivery\": 1,\n  \"items\": [\n    {\n      \"product_id\": 123,\n      \"sku_id\": 123,\n      \"sku\": \"<string>\",\n      \"quantity\": 2,\n      \"price\": 1,\n      \"gift\": true,\n      \"gift_value\": 1,\n      \"has_recomm\": true\n    }\n  ],\n  \"address\": [\n    {\n      \"receiver\": \"<string>\",\n      \"zipcode\": \"<string>\",\n      \"street\": \"<string>\",\n      \"number\": \"<string>\",\n      \"neighborhood\": \"<string>\",\n      \"city\": \"<string>\",\n      \"uf\": \"<string>\"\n    }\n  ],\n  \"marketplace_id\": 123,\n  \"marketplace_account_id\": 123,\n  \"authorized\": true,\n  \"marketplace_sale_number\": \"<string>\",\n  \"value_tax\": 1,\n  \"ip\": \"200.179.10.10\",\n  \"transactions\": [\n    {\n      \"customer_id\": 123,\n      \"authorized_at\": \"2025-07-31 23:59:59\",\n      \"amount\": 1,\n      \"installments\": 2,\n      \"holder_name\": \"<string>\",\n      \"holder_document\": \"<string>\",\n      \"payment_id\": 123,\n      \"affiliation_id\": 123,\n      \"marketplace_id\": 123,\n      \"marketplace_account_id\": 123,\n      \"authorized\": true,\n      \"captured\": true,\n      \"captured_at\": \"2025-07-31 23:59:59\",\n      \"cancelled\": true,\n      \"billet_url\": \"<string>\",\n      \"billet_date\": \"2023-12-25\"\n    }\n  ],\n  \"sent_to_antifraud\": true,\n  \"capture_date\": \"2023-12-25\",\n  \"authorized_at\": \"2025-07-31 23:59:59\",\n  \"captured_at\": \"2025-07-31 23:59:59\",\n  \"cancelled_at\": \"2025-07-31 23:59:59\",\n  \"track_code\": \"<string>\",\n  \"track_url\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("User-Token", "<api-key>")
	req.Header.Add("User-Secret-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dooki.com.br/v2/{alias}/orders")
  .header("User-Token", "<api-key>")
  .header("User-Secret-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"number\": 123,\n  \"customer_id\": 123,\n  \"value_total\": 123,\n  \"value_products\": 1,\n  \"value_discount\": 1,\n  \"value_shipment\": 1,\n  \"shipment_service\": \"<string>\",\n  \"days_delivery\": 1,\n  \"items\": [\n    {\n      \"product_id\": 123,\n      \"sku_id\": 123,\n      \"sku\": \"<string>\",\n      \"quantity\": 2,\n      \"price\": 1,\n      \"gift\": true,\n      \"gift_value\": 1,\n      \"has_recomm\": true\n    }\n  ],\n  \"address\": [\n    {\n      \"receiver\": \"<string>\",\n      \"zipcode\": \"<string>\",\n      \"street\": \"<string>\",\n      \"number\": \"<string>\",\n      \"neighborhood\": \"<string>\",\n      \"city\": \"<string>\",\n      \"uf\": \"<string>\"\n    }\n  ],\n  \"marketplace_id\": 123,\n  \"marketplace_account_id\": 123,\n  \"authorized\": true,\n  \"marketplace_sale_number\": \"<string>\",\n  \"value_tax\": 1,\n  \"ip\": \"200.179.10.10\",\n  \"transactions\": [\n    {\n      \"customer_id\": 123,\n      \"authorized_at\": \"2025-07-31 23:59:59\",\n      \"amount\": 1,\n      \"installments\": 2,\n      \"holder_name\": \"<string>\",\n      \"holder_document\": \"<string>\",\n      \"payment_id\": 123,\n      \"affiliation_id\": 123,\n      \"marketplace_id\": 123,\n      \"marketplace_account_id\": 123,\n      \"authorized\": true,\n      \"captured\": true,\n      \"captured_at\": \"2025-07-31 23:59:59\",\n      \"cancelled\": true,\n      \"billet_url\": \"<string>\",\n      \"billet_date\": \"2023-12-25\"\n    }\n  ],\n  \"sent_to_antifraud\": true,\n  \"capture_date\": \"2023-12-25\",\n  \"authorized_at\": \"2025-07-31 23:59:59\",\n  \"captured_at\": \"2025-07-31 23:59:59\",\n  \"cancelled_at\": \"2025-07-31 23:59:59\",\n  \"track_code\": \"<string>\",\n  \"track_url\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dooki.com.br/v2/{alias}/orders")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["User-Token"] = '<api-key>'
request["User-Secret-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"number\": 123,\n  \"customer_id\": 123,\n  \"value_total\": 123,\n  \"value_products\": 1,\n  \"value_discount\": 1,\n  \"value_shipment\": 1,\n  \"shipment_service\": \"<string>\",\n  \"days_delivery\": 1,\n  \"items\": [\n    {\n      \"product_id\": 123,\n      \"sku_id\": 123,\n      \"sku\": \"<string>\",\n      \"quantity\": 2,\n      \"price\": 1,\n      \"gift\": true,\n      \"gift_value\": 1,\n      \"has_recomm\": true\n    }\n  ],\n  \"address\": [\n    {\n      \"receiver\": \"<string>\",\n      \"zipcode\": \"<string>\",\n      \"street\": \"<string>\",\n      \"number\": \"<string>\",\n      \"neighborhood\": \"<string>\",\n      \"city\": \"<string>\",\n      \"uf\": \"<string>\"\n    }\n  ],\n  \"marketplace_id\": 123,\n  \"marketplace_account_id\": 123,\n  \"authorized\": true,\n  \"marketplace_sale_number\": \"<string>\",\n  \"value_tax\": 1,\n  \"ip\": \"200.179.10.10\",\n  \"transactions\": [\n    {\n      \"customer_id\": 123,\n      \"authorized_at\": \"2025-07-31 23:59:59\",\n      \"amount\": 1,\n      \"installments\": 2,\n      \"holder_name\": \"<string>\",\n      \"holder_document\": \"<string>\",\n      \"payment_id\": 123,\n      \"affiliation_id\": 123,\n      \"marketplace_id\": 123,\n      \"marketplace_account_id\": 123,\n      \"authorized\": true,\n      \"captured\": true,\n      \"captured_at\": \"2025-07-31 23:59:59\",\n      \"cancelled\": true,\n      \"billet_url\": \"<string>\",\n      \"billet_date\": \"2023-12-25\"\n    }\n  ],\n  \"sent_to_antifraud\": true,\n  \"capture_date\": \"2023-12-25\",\n  \"authorized_at\": \"2025-07-31 23:59:59\",\n  \"captured_at\": \"2025-07-31 23:59:59\",\n  \"cancelled_at\": \"2025-07-31 23:59:59\",\n  \"track_code\": \"<string>\",\n  \"track_url\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "delivered": true,
  "track_url": "<string>",
  "track_code": "<string>",
  "authorized": true,
  "customer_id": 123,
  "promocode_id": 123,
  "marketplace_id": 123,
  "marketplace_account_id": 123,
  "has_recomm": true,
  "number": 123,
  "marketplace_partner_id": 123,
  "marketplace_sale_number": 123,
  "value_total": 123,
  "value_products": 123,
  "value_discount": 123,
  "value_shipment": 123,
  "value_tax": 123,
  "shipment_service": "<string>",
  "shipment_quote_id": 123,
  "days_delivery": 123,
  "utm_source": "<string>",
  "utm_campaign": "<string>",
  "utm_term": "<string>",
  "utm_content": "<string>",
  "utm_medium": "<string>",
  "ip": "<string>",
  "items": [
    {
      "id": 123,
      "product_id": 123,
      "sku_id": 123,
      "item_sku": "<string>",
      "quantity": 123,
      "price": 123,
      "price_cost": 123,
      "shipment_cost": 123,
      "gift": true,
      "gift_value": 123,
      "has_recomm": 123,
      "is_digital": true,
      "freebie_id": 123,
      "bundle_id": 123,
      "bundle_name": "<string>"
    }
  ],
  "address": [
    {
      "id": 123,
      "order_id": 123,
      "address_name": "<string>",
      "street": "<string>",
      "number": 123,
      "complement": "<string>",
      "reference": "<string>",
      "neighborhood": "<string>",
      "receiver": "<string>",
      "zipcode": 123,
      "zip_code": 123,
      "full_address": "<string>",
      "city": "<string>",
      "uf": "<string>",
      "country": "<string>"
    }
  ],
  "transactions": {
    "data": {
      "id": 123,
      "customer_id": 123,
      "payment_id": 123,
      "affiliation_id": 123,
      "marketplace_id": 123,
      "marketplace_account_id": 123,
      "authorized": true,
      "captured": true,
      "cancelled": true,
      "can_be_captured": true,
      "can_be_cancelled": true,
      "gateway_transaction_id": 123,
      "gateway_order_id": 123,
      "gateway_authorization_code": "<string>",
      "gateway_billet_id": 123,
      "amount": 123,
      "buyer_amount": 123,
      "installment_value": 123,
      "buyer_installment_value": 123,
      "installments": 123,
      "installment_formated": "<string>",
      "buyer_installment_formated": "<string>",
      "status": "<string>",
      "error_message": "<string>",
      "bank_name": "<string>",
      "bank_alias": "<string>",
      "truncated_card": "<string>",
      "holder_name": "<string>",
      "holder_document": "<string>",
      "billet_url": "<string>",
      "billet_barcode": "<string>",
      "billet_date": "<string>",
      "billet_our_number": "<string>",
      "billet_document_number": "<string>",
      "billet_whatsapp_link": "<string>",
      "antifraud_sale_id": 123,
      "antifraud_status": "<string>",
      "antifraud_score": "<string>",
      "sent_to_antifraud": "<string>",
      "total_logs": 123,
      "error_code": 123,
      "created_at": {
        "date": "2000-08-17 10:24:24",
        "timezone_type": 3,
        "timezone": "America/Sao_Paulo"
      },
      "updated_at": {
        "date": "2000-08-17 10:24:24",
        "timezone_type": 3,
        "timezone": "America/Sao_Paulo"
      },
      "capture_date": {
        "date": "2000-08-17 10:24:24",
        "timezone_type": 3,
        "timezone": "America/Sao_Paulo"
      },
      "authorized_at": {
        "date": "2000-08-17 10:24:24",
        "timezone_type": 3,
        "timezone": "America/Sao_Paulo"
      },
      "captured_at": {
        "date": "2000-08-17 10:24:24",
        "timezone_type": 3,
        "timezone": "America/Sao_Paulo"
      },
      "cancelled_at": {
        "date": "2000-08-17 10:24:24",
        "timezone_type": 3,
        "timezone": "America/Sao_Paulo"
      },
      "payment": {
        "data": {
          "id": 123,
          "alias": "<string>",
          "name": "<string>",
          "has_config": true,
          "active_config": true,
          "is_credit_card": true,
          "is_deposit": true,
          "is_billet": true,
          "is_pix": true,
          "is_pix_in_installments": true,
          "is_wallet": true,
          "icon_url": "<string>"
        }
      },
      "metadata": [
        {
          "key": "discount_highlight",
          "value": "pix"
        }
      ]
    }
  }
}

POST

{alias}

orders

Criar pedido

curl --request POST \
  --url https://api.dooki.com.br/v2/{alias}/orders \
  --header 'Content-Type: application/json' \
  --header 'User-Secret-Key: <api-key>' \
  --header 'User-Token: <api-key>' \
  --data '
{
  "number": 123,
  "customer_id": 123,
  "value_total": 123,
  "value_products": 1,
  "value_discount": 1,
  "value_shipment": 1,
  "shipment_service": "<string>",
  "days_delivery": 1,
  "items": [
    {
      "product_id": 123,
      "sku_id": 123,
      "sku": "<string>",
      "quantity": 2,
      "price": 1,
      "gift": true,
      "gift_value": 1,
      "has_recomm": true
    }
  ],
  "address": [
    {
      "receiver": "<string>",
      "zipcode": "<string>",
      "street": "<string>",
      "number": "<string>",
      "neighborhood": "<string>",
      "city": "<string>",
      "uf": "<string>"
    }
  ],
  "marketplace_id": 123,
  "marketplace_account_id": 123,
  "authorized": true,
  "marketplace_sale_number": "<string>",
  "value_tax": 1,
  "ip": "200.179.10.10",
  "transactions": [
    {
      "customer_id": 123,
      "authorized_at": "2025-07-31 23:59:59",
      "amount": 1,
      "installments": 2,
      "holder_name": "<string>",
      "holder_document": "<string>",
      "payment_id": 123,
      "affiliation_id": 123,
      "marketplace_id": 123,
      "marketplace_account_id": 123,
      "authorized": true,
      "captured": true,
      "captured_at": "2025-07-31 23:59:59",
      "cancelled": true,
      "billet_url": "<string>",
      "billet_date": "2023-12-25"
    }
  ],
  "sent_to_antifraud": true,
  "capture_date": "2023-12-25",
  "authorized_at": "2025-07-31 23:59:59",
  "captured_at": "2025-07-31 23:59:59",
  "cancelled_at": "2025-07-31 23:59:59",
  "track_code": "<string>",
  "track_url": "<string>"
}
'

import requests

url = "https://api.dooki.com.br/v2/{alias}/orders"

payload = {
    "number": 123,
    "customer_id": 123,
    "value_total": 123,
    "value_products": 1,
    "value_discount": 1,
    "value_shipment": 1,
    "shipment_service": "<string>",
    "days_delivery": 1,
    "items": [
        {
            "product_id": 123,
            "sku_id": 123,
            "sku": "<string>",
            "quantity": 2,
            "price": 1,
            "gift": True,
            "gift_value": 1,
            "has_recomm": True
        }
    ],
    "address": [
        {
            "receiver": "<string>",
            "zipcode": "<string>",
            "street": "<string>",
            "number": "<string>",
            "neighborhood": "<string>",
            "city": "<string>",
            "uf": "<string>"
        }
    ],
    "marketplace_id": 123,
    "marketplace_account_id": 123,
    "authorized": True,
    "marketplace_sale_number": "<string>",
    "value_tax": 1,
    "ip": "200.179.10.10",
    "transactions": [
        {
            "customer_id": 123,
            "authorized_at": "2025-07-31 23:59:59",
            "amount": 1,
            "installments": 2,
            "holder_name": "<string>",
            "holder_document": "<string>",
            "payment_id": 123,
            "affiliation_id": 123,
            "marketplace_id": 123,
            "marketplace_account_id": 123,
            "authorized": True,
            "captured": True,
            "captured_at": "2025-07-31 23:59:59",
            "cancelled": True,
            "billet_url": "<string>",
            "billet_date": "2023-12-25"
        }
    ],
    "sent_to_antifraud": True,
    "capture_date": "2023-12-25",
    "authorized_at": "2025-07-31 23:59:59",
    "captured_at": "2025-07-31 23:59:59",
    "cancelled_at": "2025-07-31 23:59:59",
    "track_code": "<string>",
    "track_url": "<string>"
}
headers = {
    "User-Token": "<api-key>",
    "User-Secret-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'User-Token': '<api-key>',
    'User-Secret-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    number: 123,
    customer_id: 123,
    value_total: 123,
    value_products: 1,
    value_discount: 1,
    value_shipment: 1,
    shipment_service: '<string>',
    days_delivery: 1,
    items: [
      {
        product_id: 123,
        sku_id: 123,
        sku: '<string>',
        quantity: 2,
        price: 1,
        gift: true,
        gift_value: 1,
        has_recomm: true
      }
    ],
    address: [
      {
        receiver: '<string>',
        zipcode: '<string>',
        street: '<string>',
        number: '<string>',
        neighborhood: '<string>',
        city: '<string>',
        uf: '<string>'
      }
    ],
    marketplace_id: 123,
    marketplace_account_id: 123,
    authorized: true,
    marketplace_sale_number: '<string>',
    value_tax: 1,
    ip: '200.179.10.10',
    transactions: [
      {
        customer_id: 123,
        authorized_at: '2025-07-31 23:59:59',
        amount: 1,
        installments: 2,
        holder_name: '<string>',
        holder_document: '<string>',
        payment_id: 123,
        affiliation_id: 123,
        marketplace_id: 123,
        marketplace_account_id: 123,
        authorized: true,
        captured: true,
        captured_at: '2025-07-31 23:59:59',
        cancelled: true,
        billet_url: '<string>',
        billet_date: '2023-12-25'
      }
    ],
    sent_to_antifraud: true,
    capture_date: '2023-12-25',
    authorized_at: '2025-07-31 23:59:59',
    captured_at: '2025-07-31 23:59:59',
    cancelled_at: '2025-07-31 23:59:59',
    track_code: '<string>',
    track_url: '<string>'
  })
};

fetch('https://api.dooki.com.br/v2/{alias}/orders', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dooki.com.br/v2/{alias}/orders",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'number' => 123,
    'customer_id' => 123,
    'value_total' => 123,
    'value_products' => 1,
    'value_discount' => 1,
    'value_shipment' => 1,
    'shipment_service' => '<string>',
    'days_delivery' => 1,
    'items' => [
        [
                'product_id' => 123,
                'sku_id' => 123,
                'sku' => '<string>',
                'quantity' => 2,
                'price' => 1,
                'gift' => true,
                'gift_value' => 1,
                'has_recomm' => true
        ]
    ],
    'address' => [
        [
                'receiver' => '<string>',
                'zipcode' => '<string>',
                'street' => '<string>',
                'number' => '<string>',
                'neighborhood' => '<string>',
                'city' => '<string>',
                'uf' => '<string>'
        ]
    ],
    'marketplace_id' => 123,
    'marketplace_account_id' => 123,
    'authorized' => true,
    'marketplace_sale_number' => '<string>',
    'value_tax' => 1,
    'ip' => '200.179.10.10',
    'transactions' => [
        [
                'customer_id' => 123,
                'authorized_at' => '2025-07-31 23:59:59',
                'amount' => 1,
                'installments' => 2,
                'holder_name' => '<string>',
                'holder_document' => '<string>',
                'payment_id' => 123,
                'affiliation_id' => 123,
                'marketplace_id' => 123,
                'marketplace_account_id' => 123,
                'authorized' => true,
                'captured' => true,
                'captured_at' => '2025-07-31 23:59:59',
                'cancelled' => true,
                'billet_url' => '<string>',
                'billet_date' => '2023-12-25'
        ]
    ],
    'sent_to_antifraud' => true,
    'capture_date' => '2023-12-25',
    'authorized_at' => '2025-07-31 23:59:59',
    'captured_at' => '2025-07-31 23:59:59',
    'cancelled_at' => '2025-07-31 23:59:59',
    'track_code' => '<string>',
    'track_url' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "User-Secret-Key: <api-key>",
    "User-Token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dooki.com.br/v2/{alias}/orders"

	payload := strings.NewReader("{\n  \"number\": 123,\n  \"customer_id\": 123,\n  \"value_total\": 123,\n  \"value_products\": 1,\n  \"value_discount\": 1,\n  \"value_shipment\": 1,\n  \"shipment_service\": \"<string>\",\n  \"days_delivery\": 1,\n  \"items\": [\n    {\n      \"product_id\": 123,\n      \"sku_id\": 123,\n      \"sku\": \"<string>\",\n      \"quantity\": 2,\n      \"price\": 1,\n      \"gift\": true,\n      \"gift_value\": 1,\n      \"has_recomm\": true\n    }\n  ],\n  \"address\": [\n    {\n      \"receiver\": \"<string>\",\n      \"zipcode\": \"<string>\",\n      \"street\": \"<string>\",\n      \"number\": \"<string>\",\n      \"neighborhood\": \"<string>\",\n      \"city\": \"<string>\",\n      \"uf\": \"<string>\"\n    }\n  ],\n  \"marketplace_id\": 123,\n  \"marketplace_account_id\": 123,\n  \"authorized\": true,\n  \"marketplace_sale_number\": \"<string>\",\n  \"value_tax\": 1,\n  \"ip\": \"200.179.10.10\",\n  \"transactions\": [\n    {\n      \"customer_id\": 123,\n      \"authorized_at\": \"2025-07-31 23:59:59\",\n      \"amount\": 1,\n      \"installments\": 2,\n      \"holder_name\": \"<string>\",\n      \"holder_document\": \"<string>\",\n      \"payment_id\": 123,\n      \"affiliation_id\": 123,\n      \"marketplace_id\": 123,\n      \"marketplace_account_id\": 123,\n      \"authorized\": true,\n      \"captured\": true,\n      \"captured_at\": \"2025-07-31 23:59:59\",\n      \"cancelled\": true,\n      \"billet_url\": \"<string>\",\n      \"billet_date\": \"2023-12-25\"\n    }\n  ],\n  \"sent_to_antifraud\": true,\n  \"capture_date\": \"2023-12-25\",\n  \"authorized_at\": \"2025-07-31 23:59:59\",\n  \"captured_at\": \"2025-07-31 23:59:59\",\n  \"cancelled_at\": \"2025-07-31 23:59:59\",\n  \"track_code\": \"<string>\",\n  \"track_url\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("User-Token", "<api-key>")
	req.Header.Add("User-Secret-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dooki.com.br/v2/{alias}/orders")
  .header("User-Token", "<api-key>")
  .header("User-Secret-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"number\": 123,\n  \"customer_id\": 123,\n  \"value_total\": 123,\n  \"value_products\": 1,\n  \"value_discount\": 1,\n  \"value_shipment\": 1,\n  \"shipment_service\": \"<string>\",\n  \"days_delivery\": 1,\n  \"items\": [\n    {\n      \"product_id\": 123,\n      \"sku_id\": 123,\n      \"sku\": \"<string>\",\n      \"quantity\": 2,\n      \"price\": 1,\n      \"gift\": true,\n      \"gift_value\": 1,\n      \"has_recomm\": true\n    }\n  ],\n  \"address\": [\n    {\n      \"receiver\": \"<string>\",\n      \"zipcode\": \"<string>\",\n      \"street\": \"<string>\",\n      \"number\": \"<string>\",\n      \"neighborhood\": \"<string>\",\n      \"city\": \"<string>\",\n      \"uf\": \"<string>\"\n    }\n  ],\n  \"marketplace_id\": 123,\n  \"marketplace_account_id\": 123,\n  \"authorized\": true,\n  \"marketplace_sale_number\": \"<string>\",\n  \"value_tax\": 1,\n  \"ip\": \"200.179.10.10\",\n  \"transactions\": [\n    {\n      \"customer_id\": 123,\n      \"authorized_at\": \"2025-07-31 23:59:59\",\n      \"amount\": 1,\n      \"installments\": 2,\n      \"holder_name\": \"<string>\",\n      \"holder_document\": \"<string>\",\n      \"payment_id\": 123,\n      \"affiliation_id\": 123,\n      \"marketplace_id\": 123,\n      \"marketplace_account_id\": 123,\n      \"authorized\": true,\n      \"captured\": true,\n      \"captured_at\": \"2025-07-31 23:59:59\",\n      \"cancelled\": true,\n      \"billet_url\": \"<string>\",\n      \"billet_date\": \"2023-12-25\"\n    }\n  ],\n  \"sent_to_antifraud\": true,\n  \"capture_date\": \"2023-12-25\",\n  \"authorized_at\": \"2025-07-31 23:59:59\",\n  \"captured_at\": \"2025-07-31 23:59:59\",\n  \"cancelled_at\": \"2025-07-31 23:59:59\",\n  \"track_code\": \"<string>\",\n  \"track_url\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dooki.com.br/v2/{alias}/orders")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["User-Token"] = '<api-key>'
request["User-Secret-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"number\": 123,\n  \"customer_id\": 123,\n  \"value_total\": 123,\n  \"value_products\": 1,\n  \"value_discount\": 1,\n  \"value_shipment\": 1,\n  \"shipment_service\": \"<string>\",\n  \"days_delivery\": 1,\n  \"items\": [\n    {\n      \"product_id\": 123,\n      \"sku_id\": 123,\n      \"sku\": \"<string>\",\n      \"quantity\": 2,\n      \"price\": 1,\n      \"gift\": true,\n      \"gift_value\": 1,\n      \"has_recomm\": true\n    }\n  ],\n  \"address\": [\n    {\n      \"receiver\": \"<string>\",\n      \"zipcode\": \"<string>\",\n      \"street\": \"<string>\",\n      \"number\": \"<string>\",\n      \"neighborhood\": \"<string>\",\n      \"city\": \"<string>\",\n      \"uf\": \"<string>\"\n    }\n  ],\n  \"marketplace_id\": 123,\n  \"marketplace_account_id\": 123,\n  \"authorized\": true,\n  \"marketplace_sale_number\": \"<string>\",\n  \"value_tax\": 1,\n  \"ip\": \"200.179.10.10\",\n  \"transactions\": [\n    {\n      \"customer_id\": 123,\n      \"authorized_at\": \"2025-07-31 23:59:59\",\n      \"amount\": 1,\n      \"installments\": 2,\n      \"holder_name\": \"<string>\",\n      \"holder_document\": \"<string>\",\n      \"payment_id\": 123,\n      \"affiliation_id\": 123,\n      \"marketplace_id\": 123,\n      \"marketplace_account_id\": 123,\n      \"authorized\": true,\n      \"captured\": true,\n      \"captured_at\": \"2025-07-31 23:59:59\",\n      \"cancelled\": true,\n      \"billet_url\": \"<string>\",\n      \"billet_date\": \"2023-12-25\"\n    }\n  ],\n  \"sent_to_antifraud\": true,\n  \"capture_date\": \"2023-12-25\",\n  \"authorized_at\": \"2025-07-31 23:59:59\",\n  \"captured_at\": \"2025-07-31 23:59:59\",\n  \"cancelled_at\": \"2025-07-31 23:59:59\",\n  \"track_code\": \"<string>\",\n  \"track_url\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "delivered": true,
  "track_url": "<string>",
  "track_code": "<string>",
  "authorized": true,
  "customer_id": 123,
  "promocode_id": 123,
  "marketplace_id": 123,
  "marketplace_account_id": 123,
  "has_recomm": true,
  "number": 123,
  "marketplace_partner_id": 123,
  "marketplace_sale_number": 123,
  "value_total": 123,
  "value_products": 123,
  "value_discount": 123,
  "value_shipment": 123,
  "value_tax": 123,
  "shipment_service": "<string>",
  "shipment_quote_id": 123,
  "days_delivery": 123,
  "utm_source": "<string>",
  "utm_campaign": "<string>",
  "utm_term": "<string>",
  "utm_content": "<string>",
  "utm_medium": "<string>",
  "ip": "<string>",
  "items": [
    {
      "id": 123,
      "product_id": 123,
      "sku_id": 123,
      "item_sku": "<string>",
      "quantity": 123,
      "price": 123,
      "price_cost": 123,
      "shipment_cost": 123,
      "gift": true,
      "gift_value": 123,
      "has_recomm": 123,
      "is_digital": true,
      "freebie_id": 123,
      "bundle_id": 123,
      "bundle_name": "<string>"
    }
  ],
  "address": [
    {
      "id": 123,
      "order_id": 123,
      "address_name": "<string>",
      "street": "<string>",
      "number": 123,
      "complement": "<string>",
      "reference": "<string>",
      "neighborhood": "<string>",
      "receiver": "<string>",
      "zipcode": 123,
      "zip_code": 123,
      "full_address": "<string>",
      "city": "<string>",
      "uf": "<string>",
      "country": "<string>"
    }
  ],
  "transactions": {
    "data": {
      "id": 123,
      "customer_id": 123,
      "payment_id": 123,
      "affiliation_id": 123,
      "marketplace_id": 123,
      "marketplace_account_id": 123,
      "authorized": true,
      "captured": true,
      "cancelled": true,
      "can_be_captured": true,
      "can_be_cancelled": true,
      "gateway_transaction_id": 123,
      "gateway_order_id": 123,
      "gateway_authorization_code": "<string>",
      "gateway_billet_id": 123,
      "amount": 123,
      "buyer_amount": 123,
      "installment_value": 123,
      "buyer_installment_value": 123,
      "installments": 123,
      "installment_formated": "<string>",
      "buyer_installment_formated": "<string>",
      "status": "<string>",
      "error_message": "<string>",
      "bank_name": "<string>",
      "bank_alias": "<string>",
      "truncated_card": "<string>",
      "holder_name": "<string>",
      "holder_document": "<string>",
      "billet_url": "<string>",
      "billet_barcode": "<string>",
      "billet_date": "<string>",
      "billet_our_number": "<string>",
      "billet_document_number": "<string>",
      "billet_whatsapp_link": "<string>",
      "antifraud_sale_id": 123,
      "antifraud_status": "<string>",
      "antifraud_score": "<string>",
      "sent_to_antifraud": "<string>",
      "total_logs": 123,
      "error_code": 123,
      "created_at": {
        "date": "2000-08-17 10:24:24",
        "timezone_type": 3,
        "timezone": "America/Sao_Paulo"
      },
      "updated_at": {
        "date": "2000-08-17 10:24:24",
        "timezone_type": 3,
        "timezone": "America/Sao_Paulo"
      },
      "capture_date": {
        "date": "2000-08-17 10:24:24",
        "timezone_type": 3,
        "timezone": "America/Sao_Paulo"
      },
      "authorized_at": {
        "date": "2000-08-17 10:24:24",
        "timezone_type": 3,
        "timezone": "America/Sao_Paulo"
      },
      "captured_at": {
        "date": "2000-08-17 10:24:24",
        "timezone_type": 3,
        "timezone": "America/Sao_Paulo"
      },
      "cancelled_at": {
        "date": "2000-08-17 10:24:24",
        "timezone_type": 3,
        "timezone": "America/Sao_Paulo"
      },
      "payment": {
        "data": {
          "id": 123,
          "alias": "<string>",
          "name": "<string>",
          "has_config": true,
          "active_config": true,
          "is_credit_card": true,
          "is_deposit": true,
          "is_billet": true,
          "is_pix": true,
          "is_pix_in_installments": true,
          "is_wallet": true,
          "icon_url": "<string>"
        }
      },
      "metadata": [
        {
          "key": "discount_highlight",
          "value": "pix"
        }
      ]
    }
  }
}

Authorizations

User-Token

string

header

required

User-Secret-Key

string

header

required

Path Parameters

alias

string

required

Alias da loja

Body

application/json

Detalhes do pedido

Requisição para criação de pedidos

status

enum<string>

required

Alias do status (Veja GET {alias}/checkout/statuses para mais informações).

Available options:

waiting_payment,

cancelled,

on_carriage,

delivered,

shipment_exception,

invoiced,

paid,

refused,

authorized,

created,

handling_products,

ready_for_shipping,

ready_for_pickup

number

integer<int64>

required

Número único do pedido por loja. Obrigatório, exceto quando usar marketplace_sale_number.

customer_id

integer

required

ID do cliente pertencente à loja (e, se aplicável, ao mesmo marketplace).

value_total

number<float>

required

Valor total do pedido, resultado da soma dos produtos e do frete menos os descontos aplicados.

value_products

number<float>

required

Valor total dos produtos do pedido, sem frete nem descontos.

Required range: x >= 0

value_discount

number<float>

required

Valor total de descontos aplicados ao pedido.

Required range: x >= 0

value_shipment

number<float>

required

Valor do frete cobrado no pedido, em reais.

Required range: x >= 0

shipment_service

string

required

Alias Serviço de frete escolhido.

days_delivery

integer

required

Prazo estimado de entrega do pedido, em dias.

Required range: x >= 0

items

object[]

required

Lista de produtos incluídos no pedido.

Minimum array length: 1

Show child attributes

address

object[]

required

Endereço de entrega.

Required array length: 1 element

Show child attributes

marketplace_id

integer | null

Obrigatório se o comprador vier de um marketplace específico.

marketplace_account_id

integer | null

Conta do marketplace (precisa pertencer à loja).

authorized

boolean | null

Define se o pedido inicia autorizado; pode ser inferido pelo status da conta do marketplace.

marketplace_sale_number

string | null

Número único do pedido no marketplace (por loja/conta). Quando presente, substitui a necessidade de 'number'.

value_tax

number<float> | null

Valor de juros do gateway de pagamento cobrado no pedido, quando aplicável.

Required range: x >= 0

IP do comprador, pode ser IPv4 ou IPv6.

Example:

"200.179.10.10"

transactions

object[] | null

Transação do pedido.

Show child attributes

sent_to_antifraud

boolean | null

Indica se o pedido foi enviado para análise de antifraude, disponível apenas quando a loja tem um provedor de antifraude cadastrado.

capture_date

string<date> | null

Data em que o pagamento do pedido foi capturado.

authorized_at

string<date-time> | null

Data e hora em que o pagamento do pedido foi autorizado.

Example:

"2025-07-31 23:59:59"

captured_at

string<date-time> | null

Data e hora em que o pagamento do pedido foi capturado.

Example:

"2025-07-31 23:59:59"

cancelled_at

string<date-time> | null

Data e hora em que o pedido foi cancelado.

Example:

"2025-07-31 23:59:59"

track_code

string | null

Código de rastreio do envio. O valor é sanitizado e normalizado automaticamente.

track_url

string | null

URL de rastreio do envio. O valor é sanitizado e normalizado automaticamente.

Response

Pedido criado com sucesso

Representa um pedido

delivered

boolean

Indica se o pedido já foi entregue ao cliente.

track_url

string

URL de rastreamento da entrega gerada pela transportadora.

track_code

string

Código de rastreamento da entrega gerado pela transportadora.

authorized

boolean

Indica se o pagamento do pedido foi autorizado pela adquirente/gateway.

customer_id

integer

ID do cliente

promocode_id

integer

ID do cupom de desconto aplicado ao pedido, quando houver.

marketplace_id

integer

ID do marketplace de origem do pedido, quando a venda vem de um marketplace.

marketplace_account_id

integer

ID da conta do marketplace vinculada ao pedido.

has_recomm

boolean

Indica se o pedido teve origem no clique em um produto sugerido pelo e-mail de recomendação.

number

Número do pedido

marketplace_partner_id

integer

ID do parceiro/afiliado do marketplace associado ao pedido, quando aplicável.

marketplace_sale_number

number

Número único da venda no marketplace de origem (usado quando não há number local do pedido).

value_total

number<float>

Valor total do pedido

value_products

number<float>

Valor dos produtos

value_discount

number<float>

Valor do desconto

value_shipment

number<float>

Valor do frete

value_tax

number<float>

Valor do imposto

shipment_service

string

Método de entrega

shipment_quote_id

integer

ID da cotação de frete utilizada no pedido.

days_delivery

integer

Dias para entrega

utm_source

string

Origem da campanha de marketing (parâmetro UTM utm_source) que originou o pedido.

utm_campaign

string

Nome da campanha de marketing (parâmetro UTM utm_campaign) que originou o pedido.

utm_term

string

Termo de busca (parâmetro UTM utm_term) que originou o pedido.

utm_content

string

Conteúdo do anúncio/link (parâmetro UTM utm_content) que originou o pedido.

utm_medium

string

Meio/canal de marketing (parâmetro UTM utm_medium) que originou o pedido.

string<ip>

read-only

Endereço IP do comprador no momento da criação do pedido.

items

object[]

Itens do pedido

Show child attributes

address

Endereço do pedido · object[]

Endereço de entrega

Show child attributes

transactions

object

Transações de pagamento associadas ao pedido.

Show child attributes

⌘I