---
agentTools:
  projectIndex: https://docs.mundipagg.com/llms.txt
---

# Criar pedido (com Antifraude)

<br>

[block:callout]
{
  "type": "danger",
  "title": "NÃO ENVIE DADOS ABERTOS DO CARTÃO DO COMPRADOR",
  "body": "Para poder trafegar dados de cartão abertos em seu servidor, você deve ser [PCI Compliance](https://www.mundipagg.com/o-que-e-pci/). Por isso, **recomendamos fortemente** que as requisições sejam enviadas sempre usando o `card_id` ou `card_token`, de forma que você não precise trafegar os dados de cartão no seu servidor."
}
[/block]

[block:callout]
{
  "type": "danger",
  "title": "DADOS DO COMPRADOR SÃO OBRIGATÓRIOS",
  "body": "Caso seja informado o `customer_id`, não é necessário incluir o objeto `customer`. Entretanto, é **obrigatório** que um desses parâmetros seja informado."
}
[/block]

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Mundipagg API",
    "version": "1"
  },
  "servers": [
    {
      "url": "https://api.mundipagg.com/core/v1"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/orders                                                                     .": {
      "post": {
        "summary": "Criar pedido (com Antifraude)",
        "description": "",
        "operationId": "criar-pedido-antifraude",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "customer_id",
                  "customer",
                  "items",
                  "payments"
                ],
                "properties": {
                  "code": {
                    "type": "string",
                    "description": "Código identificador do pedido no sistema da loja. Max: 52 caracteres."
                  },
                  "customer_id": {
                    "type": "string",
                    "description": "Código do cliente. Obrigatório, caso não seja informado o objeto `customer`"
                  },
                  "customer": {
                    "type": "object",
                    "description": "Dados do cliente. Obrigatório caso o **customer_id** não seja informado. [Saiba mais sobre clientes](https://docs.mundipagg.com/v1/reference#clientes)",
                    "required": [
                      "name",
                      "email",
                      "document",
                      "type",
                      "address"
                    ],
                    "properties": {
                      "name": {
                        "type": "string",
                        "description": "Nome do cliente. Max: 64 caracteres."
                      },
                      "email": {
                        "type": "string",
                        "description": "E-mail do cliente. Max: 64 caracteres"
                      },
                      "document": {
                        "type": "string",
                        "description": "CPF ou CNPJ do cliente. Max: 16 caracteres"
                      },
                      "type": {
                        "type": "string",
                        "description": "Tipo de cliente. Valores possíveis: individual (pessoa física) ou company (pessoa jurídica)."
                      },
                      "phones": {
                        "type": "object",
                        "description": "Telefones do cliente. [Saiba mais sobre o telefones](https://docs.mundipagg.com/v1/reference#telefones)",
                        "properties": {}
                      },
                      "address": {
                        "type": "string",
                        "description": "Endereço do cliente. [Saiba mais sobre endereços](https://docs.mundipagg.com/v1/reference#enderecos)"
                      }
                    }
                  },
                  "items": {
                    "type": "array",
                    "description": "Itens do pedido. [Saiba mais sobre itens do pedido](https://docs.mundipagg.com/v1/reference#item-do-pedido)"
                  },
                  "shipping": {
                    "type": "object",
                    "description": "Dados para entrega. [Saiba mais sobre entregas](https://docs.mundipagg.com/v1/reference#entregas)",
                    "properties": {}
                  },
                  "payments": {
                    "type": "object",
                    "description": "Dados de pagamento. [Saiba mais sobre pagamentos](https://docs.mundipagg.com/v1/reference#pagamento-overview)",
                    "required": [
                      "boleto.billing_address"
                    ],
                    "properties": {
                      "boleto.billing_address": {
                        "type": "object",
                        "description": "Endereço do cliente. [Saiba mais sobre endereços](https://docs.mundipagg.com/v1/reference#enderecos)",
                        "properties": {}
                      }
                    }
                  },
                  "closed": {
                    "type": "boolean",
                    "description": "Informa se o pedido será criado **aberto** ou **fechado**.",
                    "default": true
                  },
                  "metadata": {
                    "type": "string",
                    "description": "Objeto chave/valor utilizado para armazenar informações adicionais sobre o pedido. [Saiba mais sobre metadata](https://docs.mundipagg.com/v1/reference#metadata)."
                  },
                  "device": {
                    "type": "object",
                    "description": "Dados do dispositivo",
                    "properties": {}
                  },
                  "location": {
                    "type": "object",
                    "description": "Dados de geolocalização",
                    "properties": {}
                  },
                  "ip": {
                    "type": "string",
                    "description": "Endereço IP do dispositivo que solicitou a compra"
                  },
                  "session_id": {
                    "type": "string",
                    "description": "Código da sessão do usuário"
                  },
                  "antifraud_enabled": {
                    "type": "boolean",
                    "description": "Indica se o pedido passará ou não pelo antifraude. Se não for enviado, será considerada a configuração da conta"
                  }
                }
              },
              "examples": {
                "JSON": {
                  "value": {
                    "items": [
                      {
                        "amount": 2990,
                        "description": "Chaveiro do Tesseract",
                        "quantity": 1
                      }
                    ],
                    "customer": {
                      "name": "Tony Stark",
                      "email": "avengerstark@ligadajustica.com.br",
                      "document": "12345678900",
                      "type": "individual",
                      "address": {
                        "line_1": "10880, Malibu Point, Malibu Central",
                        "zip_code": "90265",
                        "city": "Malibu",
                        "state": "CA",
                        "country": "US"
                      }
                    },
                    "session_id": "322b821a",
                    "device": {
                      "platform": "ANDROID OS"
                    },
                    "payments": [
                      {
                        "payment_method": "credit_card",
                        "credit_card": {
                          "recurrence": false,
                          "installments": 1,
                          "statement_descriptor": "AVENGERS",
                          "card": {
                            "number": "342793631858229",
                            "holder_name": "Tony Stark",
                            "exp_month": 1,
                            "exp_year": 20,
                            "cvv": "3531",
                            "billing_address": {
                              "line_1": "10880, Malibu Point, Malibu Central",
                              "zip_code": "90265",
                              "city": "Malibu",
                              "state": "CA",
                              "country": "US"
                            }
                          }
                        }
                      }
                    ]
                  }
                },
                "JSON (with Card Token)": {
                  "value": {
                    "items": [
                      {
                        "amount": 2990,
                        "description": "Chaveiro do Tesseract",
                        "quantity": 1
                      }
                    ],
                    "customer": {
                      "name": "Tony Stark",
                      "email": "avengerstark@ligadajustica.com.br"
                    },
                    "payments": [
                      {
                        "payment_method": "credit_card",
                        "credit_card": {
                          "installments": 1,
                          "statement_descriptor": "AVENGERS",
                          "card_token": "token_zVw7rqvHEPH8XlbE"
                        }
                      }
                    ]
                  }
                },
                "JSON (with Card Id + CVV)": {
                  "value": {
                    "items": [
                      {
                        "amount": 2990,
                        "description": "Chaveiro do Tesseract",
                        "quantity": 1
                      }
                    ],
                    "customer": {
                      "name": "Tony Stark",
                      "email": "avengerstark@ligadajustica.com.br"
                    },
                    "payments": [
                      {
                        "payment_method": "credit_card",
                        "credit_card": {
                          "installments": 1,
                          "statement_descriptor": "AVENGERS",
                          "card_id": "card_oqyg5aZuP2zK1dja",
                          "card": {
                            "cvv": "123"
                          }
                        }
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"id\": \"or_28dN9w7CLU79kDjL\",\n    \"code\": \"62LVFN7I4R\",\n    \"amount\": 2990,\n    \"currency\": \"BRL\",\n    \"closed\": true,\n    \"items\": [\n        {\n            \"id\": \"oi_d478RMAS3bC74PrL\",\n            \"description\": \"Chaveiro do Tesseract\",\n            \"amount\": 2990,\n            \"quantity\": 1,\n            \"status\": \"active\",\n            \"created_at\": \"2017-04-19T16:01:09Z\",\n            \"updated_at\": \"2017-04-19T16:01:09Z\"\n        }\n    ],\n    \"customer\": {\n        \"id\": \"cus_eaEXlZvhBfeGlDOm\",\n        \"name\": \"Tony Stark\",\n        \"email\": \"f1492621-4f39-45f7-adfb-82a373a0a85c@avengers.com\",\n        \"delinquent\": false,\n        \"created_at\": \"2017-04-19T16:01:09Z\",\n        \"updated_at\": \"2017-04-19T16:01:09Z\"\n    },\n    \"shipping\": {\n        \"amount\": 100,\n        \"description\": \"Stark\",\n        \"recipient_name\": \"Tony Stark\",\n        \"recipient_phone\": \"24586787867\",\n        \"address\": {\n            \"line_1\": \"10880, Malibu Point, Malibu Central\",\n            \"zip_code\": \"90265\",\n            \"city\": \"Malibu\",\n            \"state\": \"CA\",\n            \"country\": \"US\"    \n        }\n    },\n    \"status\": \"paid\",\n    \"created_at\": \"2017-04-19T16:01:09Z\",\n    \"updated_at\": \"2017-04-19T16:01:11Z\",\n    \"closed_at\": \"2017-04-19T16:01:11Z\",\n    \"charges\": [\n        {\n            \"id\": \"ch_gmnW101c9YTvQVLB\",\n            \"code\": \"62LVFN7I4R\",\n            \"gateway_id\": \"ef5e977b-93d2-485a-b15d-36e5eb3d8cf5\",\n            \"amount\": 2990,\n            \"status\": \"paid\",\n            \"currency\": \"BRL\",\n            \"payment_method\": \"credit_card\",\n            \"paid_at\": \"2017-04-19T16:01:11Z\",\n            \"created_at\": \"2017-04-19T16:01:09Z\",\n            \"updated_at\": \"2017-04-19T16:01:09Z\",\n            \"customer\": {\n                \"id\": \"cus_eaEXlZvhBfeGlDOm\",\n                \"name\": \"Tony Stark\",\n                \"email\": \"f1492621-4f39-45f7-adfb-82a373a0a85c@avengers.com\",\n                \"delinquent\": false,\n                \"created_at\": \"2017-04-19T16:01:09Z\",\n                \"updated_at\": \"2017-04-19T16:01:09Z\"\n            },\n            \"last_transaction\": {\n                \"id\": \"tran_3RYbBQjcnEcwrGp0\",\n                \"transaction_type\": \"credit_card\",\n                \"gateway_id\": \"ddab707d-72ba-49f9-b356-f0b9ebfa3039\",\n                \"amount\": 2990,\n                \"status\": \"captured\",\n                \"success\": true,\n                \"installments\": 1,\n                \"statement_descriptor\": \"AVENGERS\",\n                \"acquirer_name\": \"simulator\",\n                \"acquirer_affiliation_code\": \"MUNDI\",\n                \"acquirer_tid\": \"342793\",\n                \"acquirer_nsu\": \"512784\",\n                \"acquirer_auth_code\": \"233215\",\n                \"acquirer_message\": \"Stone|Transação autorizada com sucesso\",\n                \"acquirer_return_code\": \"0\",\n                \"operation_type\": \"auth_and_capture\",\n                \"card\": {\n                    \"id\": \"card_6xk9deAu2I2MdPzJ\",\n                    \"first_six_digits\": \"542501\",\n                    \"last_four_digits\": \"8229\",\n                    \"brand\": \"Amex\",\n                    \"holder_name\": \"Tony Stark\",\n                    \"exp_month\": 1,\n                    \"exp_year\": 2020,\n                    \"status\": \"active\",\n                    \"created_at\": \"2017-04-19T16:01:09Z\",\n                    \"updated_at\": \"2017-04-19T16:01:09Z\",\n                    \"billing_address\": {\n                        \"line_1\": \"10880, Malibu Point, Malibu Central\",\n                        \"zip_code\": \"90265\",\n                        \"city\": \"Malibu\",\n                        \"state\": \"CA\",\n                        \"country\": \"US\"                \n                    },\n                    \"type\": \"credit\"\n                },\n                \"created_at\": \"2017-04-19T16:01:09Z\",\n                \"updated_at\": \"2017-04-19T16:01:09Z\",\n                \"gateway_response\": {\n                    \"code\": \"201\"\n                }\n             \t\t\"antifraud_response\": {\n                    \"provider_name\":\"clearsale\",\n                    \"status\":\"pending\",\n                    \"return_code\":\"\",\n                    \"return_message\":\"\",\n                    \"score\":\"1\"\n                }\n            }\n        }\n    ]\n}"
                  }
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"message\": \"Authorization has been denied for this request.\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "Authorization has been denied for this request."
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false,
        "x-readme": {
          "code-samples": [
            {
              "language": "csharp",
              "code": "     // Neste exemplo estamos utilizando A sdk C# MundiAPI.PCL\n     // Secret key fornecida pela Mundipagg\n     string basicAuthUserName = \"SUA_CHAVE_SECRETA\";\n     // Senha em branco. Passando apenas a secret key\n     string basicAuthPassword = \"\";\n     var client = new MundiAPIClient (basicAuthUserName, basicAuthPassword);\n\n     var items = new List<CreateOrderItemRequest> {\n         new CreateOrderItemRequest {\n         Amount = 2990,\n         Description = \"Chaveiro do Tesseract\",\n         Quantity = 1\n         }\n     };\n     var customer = new CreateCustomerRequest {\n         Name = \"Tony Stark\",\n         Email = \"tonystark@avengers.com\",\n     };\n\n     var payments = new List<CreatePaymentRequest> {\n         new CreatePaymentRequest {\n         PaymentMethod = \"credit_card\",\n         CreditCard = new CreateCreditCardPaymentRequest {\n         Card = new CreateCardRequest {\n         HolderName = \"Tony Stark\",\n         Number = \"342793631858229\",\n         ExpMonth = 1,\n         ExpYear = 18,\n         Cvv = \"3531\",\n         }\n         }\n         }\n     };\n     var request = new CreateOrderRequest {\n         Items = items,\n         Customer = customer,\n         Payments = payments\n     };\n\n     var response = client.Orders.CreateOrder (request);",
              "name": "SDK C#"
            }
          ],
          "samples-languages": [
            "csharp"
          ]
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": false
  },
  "x-readme-fauxas": true,
  "_id": "5aba89f6b169810058a71e9a:5ec67867dbe9f60011dc218d"
}
```