---
title: "Criar pedido com split"
method: POST
path: "/orders"
---

# Criar pedido com split

`POST /orders`

Para realizar pedidos com split, você deve criar um objeto order com o objeto split. 
Para formar o objeto split, você deve primeiramente cadastrar recebedores. 
O objeto order com split possui os seguintes atributos:

## Request body

- object
  - `code` string — Código identificador do pedido no sistema da loja. Max: 52 caracteres.
  - `items` object[], required — Itens do pedido. [Saiba mais sobre itens do pedido](https://docs.pagar.me/reference/item-do-pedido-1)
    - `amount` integer — Valor unitário. Obrigatoriamente maior que zero.
    - `description` string — Descrição do item.
    - `quantity` integer — Quantidade de itens.
    - `code` string, required — Código do item no sistema da loja.
  - `customer_id` string — Código do cliente.
  - `customer` object — Dados do cliente. Obrigatório caso o **customer_id** não seja informado. [Saiba mais sobre clientes](https://docs.pagar.me/reference/clientes-1)
    - `name` string, required — Nome do cliente. Max: 64 caracteres.
    - `type` string — Tipo de cliente. Valores possíveis: individual (pessoa física) ou company (pessoa jurídica). Obrigatório, caso o document seja enviado.
    - `email` string — E-mail do cliente. Max: 64 caracteres.
    - `code` string — Código de referência do cliente no sistema da loja. Max: 52 caracteres.
    - `document` string — CPF, CNPJ ou PASSAPORTE do cliente. Max: 16 caracteres para CPF e CNPJ e Max: 50 caracteres para PASSAPORTE.
    - `document_type` string — Tipo de documento. Valores possíveis: "CPF", "CNPJ" ou "PASSPORT".
    - `gender` string — Sexo do cliente . Valores possíveis: male ou female.
    - `address` object — Endereço do cliente.
      - `country` string — País (Código do país no formato ISO 3166-1 alpha-2)(2 digitos)
      - `state` string — Estado (Código do estado no formato ISO 3166-2).
      - `city` string — Cidade.
      - `zip_code` string — Código Postal (CEP) (Apenas numérico).
      - `line_1` string — Dados principais do endereço. Neste campo deve ser informado Número, Rua, Bairro, nesta ordem e separados por vírgula.
      - `line_2` string — Dados complementares do endereço. Neste campo pode ser informado complemento, referências.
    - `phones` object — Telefone residencial do cliente.
      - `home_phone` object — Telefone residencial do cliente.
        - `country_code` string — Código do País (Apenas numérico).
        - `area_code` string — Código da área (Apenas numérico).
        - `number` string — Número do telefone (Apenas numérico).
      - `mobile_phone` object — Telefone celular do cliente.
        - `country_code` string — Código do País (Apenas numérico).
        - `area_code` string — Código da área (Apenas numérico).
        - `number` string — Número do telefone (Apenas numérico).
    - `birthdate` string, date — Data de nascimento do cliente.
    - `metadata` string — Objeto chave/valor utilizado para armazenar informações adicionais sobre o cliente.
  - `shipping` object — Dados para entrega.
    - `amount` integer — Valor da entrega.
    - `description` string — Descrição da entrega.
    - `recipient_name` string — Destinatário da entrega.
    - `recipient_phone` string — Telefone do destinatário.
    - `address` object — Endereço de entrega
      - `country` string — País (Código do país no formato ISO 3166-1 alpha-2)(2 digitos)
      - `state` string — Estado (Código do estado no formato ISO 3166-2).
      - `city` string — Cidade.
      - `zip_code` string — Código Postal (CEP) (Apenas numérico).
      - `line_1` string — Dados principais do endereço. Neste campo deve ser informado Número, Rua, Bairro, nesta ordem e separados por vírgula.
      - `line_2` string — Dados complementares do endereço. Neste campo pode ser informado complemento, referências.
  - `payments` object[], required — Lista de dados de pagamento. [Saiba mais sobre pagamentos.](https://docs.pagar.me/reference/vis%C3%A3o-geral-sobre-pagamento)
    - `payment_method` string — Meio de pagamento. Valores possíveis: credit_card, boleto, Pix, Debit Card
    - `credit_card` object — Dados sobre o pagamento com cartão de crédito (obrigatório caso o payment_method seja credit_card).
      - `operation_type` string — Indica se a transação deve ser capturada "auth_and_capture", autorizada "auth_only", ou pré autorizada "pre_auth".
      - `installments` integer — Quantidade de parcelas. Se a transação for uma recorrência, o número de parcelas deverá ser 1.
      - `statement_descriptor` string — Texto exibido na fatura do cartão. Max: 22 caracteres para clientes Gateway; 13 para clientes PSP
      - `card` object — Cartão de crédito.
        - `number` string, required — Número do cartão. Entre 13 e 19 caracteres
        - `holder_name` string, required — Nome do portador como está impresso no cartão. Máximo de 64 caracteres (Caracteres especiais e números não são aceitos)
        - `holder_document` string — CPF ou CNPJ do portador do cartão. Obrigatório caso o tipo do cartão seja voucher (bandeiras VR ou Pluxee).
        - `exp_month` integer, required — Mês de validade do cartão. Valor entre 1 e 12 (inclusive)
        - `exp_year` integer, required — Ano de validade do cartão. Formatos yy ou yyyy. Ex: 23 ou 2023.
        - `cvv` string — Código de segurança do cartão. O campo aceita 4 ou 3 caracteres, variando por bandeira.
        - `brand` string — (Opcional) Bandeira do cartão. Para cartões de crédito, temos como valores possíveis: Elo, Mastercard, Visa, Amex, ou Hipercard. Para voucher, temos como valores possíveis: Alelo, Ticket, VR ou Pluxee.
        - `label` string — Indica a label do cartão
        - `billing_address_id` string — Código do endereço de cobrança. Max: 36 caracteres.<>Opcional, pode ser utilizado no lugar do billing_address.
        - `billing_address` object
          - `line_1` string — Linha 1 do endereço. (Número, Rua, e Bairro - Nesta ordem e separados por vírgula) Max: 256 caracteres.
          - `line_2` string — Linha 2 do endereço. (Complemento - Andar, Sala, Apto). Max: 128 caracteres.
          - `zip_code` string — CEP. Max: 16 caracteres.
          - `city` string — Cidade. Max: 64 caracteres.
          - `state` string — Código do estado no formato ISO 3166-2.
          - `country` string — Código do país no formato ISO 3166-1 alpha-2.
      - `network_token` object — Token de bandeira.
        - `number` string — Número do Network Token. Entre 13 e 19 caracteres. Ex: 4190000000000069
        - `holder_name` string — Nome do portador como está impresso no cartão. Máximo de 64 caracteres (Caracteres especiais e números não são aceitos)
        - `exp_month` integer — Mês de validade do Network Token. Valor entre 1 e 12 (inclusive)
        - `exp_year` integer — Ano de validade do Network Token. Formatos yy ou yyyy. Ex: 23 ou 2023.
        - `cryptograms` string — Criptograma de autenticação para Network Token. Pode enviar mais de um, caso queira em uma lista de strings. Formato em base64. Ex: ANfQt43bddROAAEnSAMhAAADFA====
      - `card_id` string — identificador do cartão de um cliente.
      - `card_token` string — token do cartão gerado pelo checkout transparente
      - `recurrence_cycle` string — Informa se o pedido é referente a uma recorrência externa. Possíveis valores: `first` ou `subsequent`.
      - `initiated_type` string — Identificador do tipo de transação avulsa. Valores possíveis: `partial_shipment` (Remessa Parcial), `related_or_delayed_charge` (Cobrança Atrasada), `no_show` (Multa) ou `retry` (Retentativa). Valores possíveis: `standing_order` (Ordem Permanente), `instalment` (Parcelamento) ou `subscription` (Assinatura convencional com valor e frequência fixa). [Mais detalhes](https://docs.pagar.me/page/mitcit-transa%C3%A7%C3%B5es-card-on-file-mastercard).
      - `recurrence_model` string — Identificador do tipo de recorrência. Valores possíveis: `standing_order` (Ordem Permanente), `instalment` (Parcelamento) ou `subscription` (Assinatura convencional com valor e frequência fixa). Valores possíveis: `standing_order` (Ordem Permanente), `instalment` (Parcelamento) ou `subscription` (Assinatura convencional com valor e frequência fixa). [Mais detalhes](https://docs.pagar.me/page/mitcit-transa%C3%A7%C3%B5es-card-on-file-mastercard).
      - `payment_origin` object — Identificador da primeira cobrança de uma recorrência. [Mais detalhes](https://docs.pagar.me/docs/api-v5-identificador-de-recorr%C3%AAncia-para-assinaturas-externas).
        - `charge_id` string — Identificador da cobrança
        - `brand_id` string — Identificador da bandeira
    - `boleto` object — Dados sobre o pagamento com boleto (obrigatório caso o payment_method seja boleto).
      - `bank` string — Código do banco. 001 (Banco do Brasil); 033 (Santander); 237 (Bradesco); 341 (Itau); 745 (Citibank) e 104 (Caixa Econômica Federal).
      - `instructions` string — Instruções do boleto. Max: 256 caracteres.
      - `due_at` string — Data de vencimento. (Opcional)
      - `nosso_numero` string — Número que identifica unicamente um boleto para uma conta.
      - `type` string — Tipo de espécie do boleto.DM (Duplicata Mercantil) e BDP (Boleto de proposta)
      - `document_number` string — Identificador do boleto. Max: 16 caracteres.
      - `interest` object — Aplicação do juros sobre o boleto.
        - `days` integer, required — Dias após a expiração do boleto quando o juros deve ser cobrado.
        - `type` string, required — Tipo de divisão. Os valores possíveis são flat ou percentage.
        - `amount` string, required — Valor em porcentagem ou em centavos da taxa de juros que será cobrada ao mês.
      - `fine` object — Aplicação da multa sobre o boleto.
        - `days` integer, required — Dias após a expiração do boleto quando a multa deve ser cobrada.
        - `type` string, required — Tipo de divisão. Os valores possíveis são flat ou percentage.
        - `amount` integer, required — Valor em porcentagem ou em centavos que será cobrada na multa.
      - `discount` object — Objeto raiz de desconto por antecipação. Exclusivo PSP.
        - `type` string — Tipo do desconto: "percentage" (% sobre o total) ou "flat" (centavos). Aplica-se a todas as regras do array.
        - `rules` object[] — Lista de regras de desconto ordenadas por limit_date crescente.
          - `limit_date` string — Data limite da regra. Formato YYYY-MM-DD. Deve ser anterior ao due_at do boleto.
          - `amount` integer — Valor do desconto. Se type: percentage: entre 0.01 e 100 (ex: 15.00 = 15%). Se type: flat: inteiro em centavos, mín. 1 (ex: 500 = R$5,00).
    - `debit_card` object — Dados sobre o pagamento com cartão de débito (obrigatório caso o payment_method seja debit_card).
      - `statement_descriptor` string — Texto exibido na fatura do cartão. Max: 22 caracteres.
      - `card` object
        - `number` string, required — Número do cartão. Entre 13 e 19 caracteres
        - `holder_name` string, required — Nome do portador como está impresso no cartão. Máximo de 64 caracteres (Caracteres especiais e números não são aceitos)
        - `holder_document` string — CPF ou CNPJ do portador do cartão. Obrigatório caso o tipo do cartão seja voucher (bandeiras VR ou Pluxee).
        - `exp_month` integer, required — Mês de validade do cartão. Valor entre 1 e 12 (inclusive)
        - `exp_year` integer, required — Ano de validade do cartão. Formatos yy ou yyyy. Ex: 23 ou 2023.
        - `cvv` string — Código de segurança do cartão. O campo aceita 4 ou 3 caracteres, variando por bandeira.
        - `brand` string — (Opcional) Bandeira do cartão. Para cartões de crédito, temos como valores possíveis: Elo, Mastercard, Visa, Amex, ou Hipercard. Para voucher, temos como valores possíveis: Alelo, Ticket, VR ou Pluxee.
        - `label` string — Indica a label do cartão
        - `billing_address_id` string — Código do endereço de cobrança. Max: 36 caracteres.<>Opcional, pode ser utilizado no lugar do billing_address.
        - `billing_address` object
          - `line_1` string — Linha 1 do endereço. (Número, Rua, e Bairro - Nesta ordem e separados por vírgula) Max: 256 caracteres.
          - `line_2` string — Linha 2 do endereço. (Complemento - Andar, Sala, Apto). Max: 128 caracteres.
          - `zip_code` string — CEP. Max: 16 caracteres.
          - `city` string — Cidade. Max: 64 caracteres.
          - `state` string — Código do estado no formato ISO 3166-2.
          - `country` string — Código do país no formato ISO 3166-1 alpha-2.
      - `card_id` string — identificador do cartão de um cliente.
      - `card_token` string — token do cartão gerado pelo checkout transparente
      - `network_token` object — Token de bandeira.
        - `number` string — Número do Network Token. Entre 13 e 19 caracteres. Ex: 4190000000000069
        - `holder_name` string — Nome do portador como está impresso no cartão. Máximo de 64 caracteres (Caracteres especiais e números não são aceitos)
        - `exp_month` integer — Mês de validade do Network Token. Valor entre 1 e 12 (inclusive)
        - `exp_year` integer — Ano de validade do Network Token. Formatos yy ou yyyy. Ex: 23 ou 2023.
        - `cryptograms` string — Criptograma de autenticação para Network Token. Pode enviar mais de um, caso queira em uma lista de strings. Formato em base64. Ex: ANfQt43bddROAAEnSAMhAAADFA====
      - `initiated_type` string — Identificador do tipo de transação avulsa. Valores possíveis: `partial_shipment` (Remessa Parcial), `related_or_delayed_charge` (Cobrança Atrasada), `no_show` (Multa) ou `retry` (Retentativa).
      - `recurrence_model` string — Identificador do tipo de recorrência. Valores possíveis: `standing_order` (Ordem Permanente), `instalment` (Parcelamento) ou `subscription` (Assinatura convencional com valor e frequência fixa).
    - `split` object[] — Dados para o split de pagamentos.
      - `amount` integer — Valor destinado ao recebedor.
      - `recipient_id` string — Código do recebedor. Formato: rp_XXXXXXXXXXXXXXXX.
      - `type` string — Tipo de divisão. Os valores possíveis são flat ou percentage.
      - `options` object — Informações da responsabilidade do recebedor na transação.
        - `charge_processing_fee` boolean — Indica se o recebedor vinculado à regra será cobrado pelas taxas da transação
        - `charge_remainder_fee` boolean — Indica se o recebedor vinculado à regra irá receber o restante dos recebíveis após uma divisão
        - `liable` boolean — Indica se o recebedor é responsável pela transação em caso de chargeback.
  - `closed` boolean — Informa se o pedido será criado **aberto** ou **fechado**
  - `metadata` string — Objeto chave/valor utilizado para armazenar informações adicionais sobre o pedido.

## Response `200`

200

- object
  - `id` string
  - `code` string
  - `gateway_id` string
  - `amount` integer
  - `paid_amount` integer
  - `status` string
  - `currency` string
  - `payment_method` string
  - `paid_at` string
  - `created_at` string
  - `updated_at` string
  - `customer` object
    - `id` string
    - `name` string
    - `email` string
    - `delinquent` boolean
    - `created_at` string
    - `updated_at` string
    - `phones` object
  - `last_transaction` object
    - `id` string
    - `transaction_type` string
    - `gateway_id` string
    - `amount` integer
    - `status` string
    - `success` boolean
    - `installments` integer
    - `statement_descriptor` string
    - `acquirer_name` string
    - `acquirer_tid` string
    - `acquirer_nsu` string
    - `acquirer_return_code` string
    - `operation_type` string
    - `card` object
      - `id` string
      - `first_six_digits` string
      - `last_four_digits` string
      - `brand` string
      - `holder_name` string
      - `exp_month` integer
      - `exp_year` integer
      - `status` string
      - `created_at` string
      - `updated_at` string
      - `type` string
    - `created_at` string
    - `updated_at` string
    - `gateway_response` object
      - `code` string
    - `split` object[]
      - `id` string
      - `type` string
      - `gateway_id` string
      - `amount` integer
      - `recipient` object
        - `id` string
        - `name` string
        - `email` string
        - `document` string
        - `description` string
        - `type` string
        - `status` string
        - `created_at` string
        - `updated_at` string
      - `options` object
        - `liable` boolean
        - `charge_processing_fee` boolean
        - `charge_remainder_fee` boolean
  - `metadata` object
    - `code` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/pagar/apis/pagarme-api.md) · [All operations](https://skmtc.net/pagar/apis/pagarme-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pagar/pagarme-api/versions/dababf062743/schema)