Orders (Pedidos)

Métodos para criar e consultar pedidos.

`create`

Cria um novo pedido para um evento.


const { order, clientSecret } = await sdk.orders.create({
  eventId: 'event-id',
  buyer: {
    name: 'João Silva',
    email: 'joao@example.com',
    phone: '+5511999999999',
    document: '12345678900',
  },
  tickets: [
    {
      id: 'ticket-id',
      amount: 2,
      seatIds: ['A1', 'A2'],
    },
  ],
  couponId: 'coupon-id',
  utmSource: 'google',
  utmCampaign: 'campaign-123',
  middlewareData: {
    customField: 'value',
  },
});

Parâmetros (CreateOrderProps):
- eventId: string – obrigatório, ID do evento.
- buyer: BuyerProps – dados do comprador (nome, email, documento, etc.).
- tickets: Array<{ id: string; amount: number; seatIds?: string[] }> – ingressos.
- couponId?: string – opcional, ID do cupom.
- utmSource?: string – opcional, origem da campanha.
- utmCampaign?: string – opcional, nome da campanha.
- middlewareData?: Record<string, unknown> – dados adicionais para integrações.

Retorno (CreatedOrderProps):

type: 'success' – indica sucesso.
order: resumo do pedido criado (id, totais, event, items, utmSource, utmCampaign, buyer, info).
clientSecret: string – token para concluir o pagamento no front.

Exemplo de resposta

Ver resposta


{
  "type": "success",
  "order": {
    "id": "cml5d0rwd000dju0v1sam6u2o",
    "utmSource": null,
    "utmCampaign": null,
    "buyer": null,
    "totalDiscount": 0,
    "totalFee": 20,
    "totalPrice": 220,
    "rawPrice": 200,
    "event": {
      "id": "cml0vazf400000vo1rfy5g3pt",
      "name": "Teste 02",
      "startsAt": "2026-01-30T15:36:00.000Z"
    },
    "items": [
      {
        "id": "cml5cjzjz00010vjue3n8eiwb",
        "amount": 2,
        "ticket": {
          "id": "cml5cjzjz00010vjue3n8eiwb",
          "name": "Ingresso 01",
          "type": "TICKET",
          "price": 100,
          "group": {
            "id": "cml1c5qww000v0v0kvnhatus2",
            "name": "Grupo 01",
            "gauge": {
              "id": "cml1c6mw5000w0v0klk2p1f35",
              "totalAmount": 1000,
              "usedAmount": 3
            }
          }
        }
      }
    ],
    "info": {}
  },
  "clientSecret": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NzAwNDgyNDEsImV4cCI6MTc3MDA0ODg0MSwic3ViIjoiY21sNWQwcndkMDAwZGp1MHYxc2FtNnUybyJ9.rfI4L7zsEOy21EzmsYTdQl2rWUE8Vtjbzr1FvFJQdq4"
}

`get`

Busca um pedido específico.


const { order, paidTickets, paymentIntent } = await sdk.orders.get(
  orderId,
  headers
);

Parâmetros:
- orderId: string – obrigatório, ID do pedido.
- headers?: Record<string, string> – cabeçalhos adicionais (opcional).

Retorno (GetOrderProps):

order: OrderProps & detalhes (itens, ingressos, etc.).
paidTickets: UserTicketProps[] – ingressos pagos.
paymentIntent?: PaymentIntentProps – status do pagamento.

Exemplo de resposta

Ver resposta


{
  "order": {
    "id": "cml5cl3b8000bju0v7egha3ys",
    "status": "PAID",
    "eventId": "cml0vazf400000vo1rfy5g3pt",
    "payment": {
      "installments": 1,
      "type": "CREDIT_CARD"
    },
    "stoneTransactions": [],
    "event": {
      "id": "cml0vazf400000vo1rfy5g3pt",
      "name": "Teste 02",
      "slug": "teste-02",
      "legalAgeRequired": true,
      "hasTicketInsurance": true,
      "startsAt": "2026-01-30T15:36:00.000Z",
      "opensAt": null,
      "timezone": "America/Sao_Paulo",
      "image": {
        "id": "cml1blca900060v0k3bhfchsa",
        "url": "http://localhost:3333/8c2d30d1-2ce7-43e0-b2d3-4bef4839eddf.png",
        "base64": "iVBORw0KGgoAAAANSUhEUgAAAAMAAAAKCAIAAAD+RXMgAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAWklEQVR4nB3KMQ6FERBF4btdC7KVWYKoVSSKIUHsQHGNl/+d9jsgWWslib13zvneC1Vda5kZ5pyqes5B77219mkpJcY4xoCIOOdEBCEE731KCWZG8vvee/bvB5RjTu5miUY/AAAAAElFTkSuQmCC"
      },
      "address": {
        "formatted": "R. Mauá, 1100 - Alto da Glória, Curitiba - PR, 80030-200, Brasil"
      },
      "channel": {
        "id": "cmkzj64nx00030vbfd6yeoqk5",
        "slug": "atletica-18-de-setembro"
      },
      "externalAnalytics": []
    },
    "buyer": {
      "name": "John Doe",
      "email": "johndoe@meaple.com.br",
      "document": "01233592955",
      "phoneNumber": "+5545999052841",
      "birthdate": "2000-09-18T03:00:00.000Z"
    },
    "items": [
      {
        "id": "cml5cl3b70009ju0v4jzsbvhe",
        "amount": 1,
        "nominations": [],
        "seatIds": [],
        "ticket": {
          "id": "cml5cjzjz00010vjue3n8eiwb",
          "type": "TICKET",
          "name": "Ingresso 01",
          "group": {
            "id": "cml1c5qww000v0v0kvnhatus2",
            "name": "Grupo 01"
          },
          "image": null,
          "price": 100,
          "nominable": false,
          "beginsAt": null,
          "customFields": []
        }
      },
      {
        "id": "cml5cl3b8000aju0v2m4u2jnd",
        "amount": 1,
        "nominations": [],
        "seatIds": [],
        "ticket": {
          "id": "cml1bykae000l0v0kow8x49c6",
          "type": "PRODUCT",
          "name": "Produto 02",
          "group": null,
          "image": {
            "id": "cml1byfhx000j0v0kbo4edemb",
            "url": "http://localhost:3333/56a6b3fb-ce1b-4b1c-b078-ff7053e1df86.png"
          },
          "price": 100,
          "nominable": false,
          "beginsAt": null,
          "customFields": []
        }
      }
    ],
    "userTickets": [
      {
        "id": "cml5cmniz000f0vk7fhe9sn05",
        "slug": "MP-ECA4BFB024",
        "qrCodeDataUrl": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFQAAABUCAYAAAAcaxDBAAAAAklEQVR4AewaftIAAAJFSURBVO3BS2pkSRAAQfek7n9ln14GWjxRKPQZSDOB+EEVT1SeVEwqU8Wk8pMO16rDtepwrXrxQcUmlScqU8V3qtikMh2uVYdr1eFa9eITKu+oeEfFE5XvpPKOiieHa9XhWnW4Vr34Y1SeVEwqf8nhWnW4Vh2uVS9+mcpU8UTlLztcqw7XqsO16sUnKr5TxROVJxVfUbHpcK06XKsO16oXH6j8JJWp4knFpDJVPFH5Todr1eFadbhW2T/8ISpTxf/J4Vp1uFYdrlUvlaliUpkqJpWpYlKZKjapTBXvUJkqnqhMFdPhWnW4Vh2uVQIxVHyFylQxqWyqmFSmikllqniiMlVMKtPhWnW4Vh2uVS8+oTJVTCpTxaTyjopJ5R0Vk8pUMalMFVPFpPLkcK06XKsO1yqBeFDxRGWqeIfKk4pJ5UnFE5WvqJhUpsO16nCtOlyrBGJRxaQyVXyFylTxROVJxROVJxXT4Vp1uFYdrlX2D79IZaqYVKaKJypTxaTypOIdKtPhWnW4Vh2uVQLxgyqeqEwVT1Smit90uFYdrlWHa9WLDyo2qXyFylQxVUwqU8Wk8p0O16rDtepwrXrxCZV3VLxD5UnFE5WpYlKZKt6h8o7DtepwrTpcq178sopJ5YnKVDGpTBVPVL6iYjpcqw7XqsO16sUvU5kqJpV3VEwqTyomlScVk8p0uFYdrlWHa9WLT1R8p4qvUHlSsUnlyeFadbhWHa5VLz5Q+UkqTyomlaniico7KiaVqWJSmQ7XqsO16nCt+g8j9fq30tgOoQAAAABJRU5ErkJggg==",
        "nomination": null,
        "seatId": null,
        "ticket": {
          "id": "cml5cjzjz00010vjue3n8eiwb",
          "type": "TICKET",
          "name": "Ingresso 01",
          "transferable": true,
          "privateToken": null,
          "image": null,
          "group": {
            "id": "cml1c5qww000v0v0kvnhatus2",
            "name": "Grupo 01"
          },
          "event": {
            "id": "cml0vazf400000vo1rfy5g3pt",
            "name": "Teste 02",
            "slug": "teste-02",
            "image": {
              "id": "cml1blca900060v0k3bhfchsa",
              "url": "http://localhost:3333/8c2d30d1-2ce7-43e0-b2d3-4bef4839eddf.png",
              "base64": "iVBORw0KGgoAAAANSUhEUgAAAAMAAAAKCAIAAAD+RXMgAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAWklEQVR4nB3KMQ6FERBF4btdC7KVWYKoVSSKIUHsQHGNl/+d9jsgWWslib13zvneC1Vda5kZ5pyqes5B77219mkpJcY4xoCIOOdEBCEE731KCWZG8vvee/bvB5RjTu5miUY/AAAAAElFTkSuQmCC"
            },
            "channel": {
              "id": "cmkzj64nx00030vbfd6yeoqk5",
              "slug": "atletica-18-de-setembro"
            },
            "startsAt": "2026-01-30T15:36:00.000Z",
            "opensAt": null,
            "timezone": "America/Sao_Paulo",
            "address": {
              "formatted": "R. Mauá, 1100 - Alto da Glória, Curitiba - PR, 80030-200, Brasil"
            }
          }
        }
      },
      {
        "id": "cml5cmnj1000h0vk7cf4q47tg",
        "slug": "MP-E28450AAD1",
        "qrCodeDataUrl": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFQAAABUCAYAAAAcaxDBAAAAAklEQVR4AewaftIAAAIfSURBVO3BQW5rSQwEwSyi73/lnFkSWrTwYFoyPhgRQD5IpUtCp3KThBuVLgmfVKxRxRpVrFGHFyqTkvCXqExKQlesUcUaVaxRhzeS8ITKTyShU+lUJiXhCZWbYo0q1qhijTp8mcpNEjqVv6xYo4o1qlijDl+WhJ9IQqfyTcUaVaxRxRp1eEPlN6l0SbhJwiSVScUaVaxRxRp1eJGET0pCp9IloVPpkvBEEn5TsUYVa1SxRsX/8YckoVPpknCj8k3FGlWsUcUaFUAalZskfJNKl4QblZskdCpdEp4o1qhijSrWqMOLJExS6ZJwo9Il4QmVmyR0Kl0SOpUuCZ1KV6xRxRpVrFGHN1SeSEKXhE5lkkqXhE9KQlesUcUaVaxRhzeS8ITKTyShU+mS0Kk8ofKbijWqWKOKNerwQmVSEiapPKHSJaFTuUlCp3JTrFHFGlWsUUflN6ncJOGJJDyRhE7lNxVrVLFGFWvUScInqdyodEnoVLok3Kh0SbhRuUnCTbFGFWtUsUYdXqhMSsITSehUuiTcqNyodEm4SUKnclOsUcUaVaxRhzeS8ITKpCT8RBImJeGmWKOKNapYow5/jEqXhJ9QuUlCl4RO5YlijSrWqGKNOnyZyhMqN0m4UelUuiR0SXiiWKOKNapYow5vqPxLktCpdCo3SehUumKNKtaoYo06vEjCJyXhRqVLQqdyo3KThE6lS8ITxRpVrFHFGvUfE9TYxCJoVhoAAAAASUVORK5CYII=",
        "nomination": null,
        "seatId": null,
        "ticket": {
          "id": "cml1bykae000l0v0kow8x49c6",
          "type": "PRODUCT",
          "name": "Produto 02",
          "transferable": false,
          "privateToken": null,
          "image": {
            "id": "cml1byfhx000j0v0kbo4edemb",
            "url": "http://localhost:3333/56a6b3fb-ce1b-4b1c-b078-ff7053e1df86.png",
            "base64": "iVBORw0KGgoAAAANSUhEUgAAAAMAAAAKCAIAAAD+RXMgAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAWklEQVR4nB3KMQ6FERBF4btdC7KVWYKoVSSKIUHsQHGNl/+d9jsgWWslib13zvneC1Vda5kZ5pyqes5B77219mkpJcY4xoCIOOdEBCEE731KCWZG8vvee/bvB5RjTu5miUY/AAAAAElFTkSuQmCC"
          },
          "group": null,
          "event": {
            "id": "cml0vazf400000vo1rfy5g3pt",
            "name": "Teste 02",
            "slug": "teste-02",
            "image": {
              "id": "cml1blca900060v0k3bhfchsa",
              "url": "http://localhost:3333/8c2d30d1-2ce7-43e0-b2d3-4bef4839eddf.png",
              "base64": "iVBORw0KGgoAAAANSUhEUgAAAAMAAAAKCAIAAAD+RXMgAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAWklEQVR4nB3KMQ6FERBF4btdC7KVWYKoVSSKIUHsQHGNl/+d9jsgWWslib13zvneC1Vda5kZ5pyqes5B77219mkpJcY4xoCIOOdEBCEE731KCWZG8vvee/bvB5RjTu5miUY/AAAAAElFTkSuQmCC"
            },
            "channel": {
              "id": "cmkzj64nx00030vbfd6yeoqk5",
              "slug": "atletica-18-de-setembro"
            },
            "startsAt": "2026-01-30T15:36:00.000Z",
            "opensAt": null,
            "timezone": "America/Sao_Paulo",
            "address": {
              "formatted": "R. Mauá, 1100 - Alto da Glória, Curitiba - PR, 80030-200, Brasil"
            }
          }
        }
      }
    ],
    "totalPrice": 228,
    "totalDiscount": 0,
    "totalFee": 20,
    "totalInsurance": 8,
    "rawPrice": 200,
    "processingFee": 0,
    "totalCreditCardFee": 0,
    "expiresAt": "2026-02-02T16:01:49.507Z",
    "createdAt": "2026-02-02T15:51:49.510Z"
  },
  "paidTickets": [
    {
      "id": "cml5cmniz000f0vk7fhe9sn05",
      "slug": "MP-ECA4BFB024",
      "qrCodeDataUrl": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFQAAABUCAYAAAAcaxDBAAAAAklEQVR4AewaftIAAAJFSURBVO3BS2pkSRAAQfek7n9ln14GWjxRKPQZSDOB+EEVT1SeVEwqU8Wk8pMO16rDtepwrXrxQcUmlScqU8V3qtikMh2uVYdr1eFa9eITKu+oeEfFE5XvpPKOiieHa9XhWnW4Vr34Y1SeVEwqf8nhWnW4Vh2uVS9+mcpU8UTlLztcqw7XqsO16sUnKr5TxROVJxVfUbHpcK06XKsO16oXH6j8JJWp4knFpDJVPFH5Todr1eFadbhW2T/8ISpTxf/J4Vp1uFYdrlUvlaliUpkqJpWpYlKZKjapTBXvUJkqnqhMFdPhWnW4Vh2uVQIxVHyFylQxqWyqmFSmikllqniiMlVMKtPhWnW4Vh2uVS8+oTJVTCpTxaTyjopJ5R0Vk8pUMalMFVPFpPLkcK06XKsO1yqBeFDxRGWqeIfKk4pJ5UnFE5WvqJhUpsO16nCtOlyrBGJRxaQyVXyFylTxROVJxROVJxXT4Vp1uFYdrlX2D79IZaqYVKaKJypTxaTypOIdKtPhWnW4Vh2uVQLxgyqeqEwVT1Smit90uFYdrlWHa9WLDyo2qXyFylQxVUwqU8Wk8p0O16rDtepwrXrxCZV3VLxD5UnFE5WpYlKZKt6h8o7DtepwrTpcq178sopJ5YnKVDGpTBVPVL6iYjpcqw7XqsO16sUvU5kqJpV3VEwqTyomlScVk8p0uFYdrlWHa9WLT1R8p4qvUHlSsUnlyeFadbhWHa5VLz5Q+UkqTyomlaniico7KiaVqWJSmQ7XqsO16nCt+g8j9fq30tgOoQAAAABJRU5ErkJggg==",
      "nomination": null,
      "seatId": null,
      "ticket": {
        "id": "cml5cjzjz00010vjue3n8eiwb",
        "type": "TICKET",
        "name": "Ingresso 01",
        "transferable": true,
        "privateToken": null,
        "image": null,
        "group": {
          "id": "cml1c5qww000v0v0kvnhatus2",
          "name": "Grupo 01"
        },
        "event": {
          "id": "cml0vazf400000vo1rfy5g3pt",
          "name": "Teste 02",
          "slug": "teste-02",
          "image": {
            "id": "cml1blca900060v0k3bhfchsa",
            "url": "http://localhost:3333/8c2d30d1-2ce7-43e0-b2d3-4bef4839eddf.png",
            "base64": "iVBORw0KGgoAAAANSUhEUgAAAAMAAAAKCAIAAAD+RXMgAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAWklEQVR4nB3KMQ6FERBF4btdC7KVWYKoVSSKIUHsQHGNl/+d9jsgWWslib13zvneC1Vda5kZ5pyqes5B77219mkpJcY4xoCIOOdEBCEE731KCWZG8vvee/bvB5RjTu5miUY/AAAAAElFTkSuQmCC"
          },
          "channel": {
            "id": "cmkzj64nx00030vbfd6yeoqk5",
            "slug": "atletica-18-de-setembro"
          },
          "startsAt": "2026-01-30T15:36:00.000Z",
          "opensAt": null,
          "timezone": "America/Sao_Paulo",
          "address": {
            "formatted": "R. Mauá, 1100 - Alto da Glória, Curitiba - PR, 80030-200, Brasil"
          }
        }
      }
    },
    {
      "id": "cml5cmnj1000h0vk7cf4q47tg",
      "slug": "MP-E28450AAD1",
      "qrCodeDataUrl": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAFQAAABUCAYAAAAcaxDBAAAAAklEQVR4AewaftIAAAIfSURBVO3BQW5rSQwEwSyi73/lnFkSWrTwYFoyPhgRQD5IpUtCp3KThBuVLgmfVKxRxRpVrFGHFyqTkvCXqExKQlesUcUaVaxRhzeS8ITKTyShU+lUJiXhCZWbYo0q1qhijTp8mcpNEjqVv6xYo4o1qlijDl+WhJ9IQqfyTcUaVaxRxRp1eEPlN6l0SbhJwiSVScUaVaxRxRp1eJGET0pCp9IloVPpkvBEEn5TsUYVa1SxRsX/8YckoVPpknCj8k3FGlWsUcUaFUAalZskfJNKl4QblZskdCpdEp4o1qhijSrWqMOLJExS6ZJwo9Il4QmVmyR0Kl0SOpUuCZ1KV6xRxRpVrFGHN1SeSEKXhE5lkkqXhE9KQlesUcUaVaxRhzeS8ITKTyShU+mS0Kk8ofKbijWqWKOKNerwQmVSEiapPKHSJaFTuUlCp3JTrFHFGlWsUUflN6ncJOGJJDyRhE7lNxVrVLFGFWvUScInqdyodEnoVLok3Kh0SbhRuUnCTbFGFWtUsUYdXqhMSsITSehUuiTcqNyodEm4SUKnclOsUcUaVaxRhzeS8ITKpCT8RBImJeGmWKOKNapYow5/jEqXhJ9QuUlCl4RO5YlijSrWqGKNOnyZyhMqN0m4UelUuiR0SXiiWKOKNapYow5vqPxLktCpdCo3SehUumKNKtaoYo06vEjCJyXhRqVLQqdyo3KThE6lS8ITxRpVrFHFGvUfE9TYxCJoVhoAAAAASUVORK5CYII=",
      "nomination": null,
      "seatId": null,
      "ticket": {
        "id": "cml1bykae000l0v0kow8x49c6",
        "type": "PRODUCT",
        "name": "Produto 02",
        "transferable": false,
        "privateToken": null,
        "image": {
          "id": "cml1byfhx000j0v0kbo4edemb",
          "url": "http://localhost:3333/56a6b3fb-ce1b-4b1c-b078-ff7053e1df86.png",
          "base64": "iVBORw0KGgoAAAANSUhEUgAAAAMAAAAKCAIAAAD+RXMgAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAWklEQVR4nB3KMQ6FERBF4btdC7KVWYKoVSSKIUHsQHGNl/+d9jsgWWslib13zvneC1Vda5kZ5pyqes5B77219mkpJcY4xoCIOOdEBCEE731KCWZG8vvee/bvB5RjTu5miUY/AAAAAElFTkSuQmCC"
        },
        "group": null,
        "event": {
          "id": "cml0vazf400000vo1rfy5g3pt",
          "name": "Teste 02",
          "slug": "teste-02",
          "image": {
            "id": "cml1blca900060v0k3bhfchsa",
            "url": "http://localhost:3333/8c2d30d1-2ce7-43e0-b2d3-4bef4839eddf.png",
            "base64": "iVBORw0KGgoAAAANSUhEUgAAAAMAAAAKCAIAAAD+RXMgAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAWklEQVR4nB3KMQ6FERBF4btdC7KVWYKoVSSKIUHsQHGNl/+d9jsgWWslib13zvneC1Vda5kZ5pyqes5B77219mkpJcY4xoCIOOdEBCEE731KCWZG8vvee/bvB5RjTu5miUY/AAAAAElFTkSuQmCC"
          },
          "channel": {
            "id": "cmkzj64nx00030vbfd6yeoqk5",
            "slug": "atletica-18-de-setembro"
          },
          "startsAt": "2026-01-30T15:36:00.000Z",
          "opensAt": null,
          "timezone": "America/Sao_Paulo",
          "address": {
            "formatted": "R. Mauá, 1100 - Alto da Glória, Curitiba - PR, 80030-200, Brasil"
          }
        }
      }
    }
  ],
  "paymentIntent": {
    "id": "1326105492",
    "externalId": "cml5cl3b8000bju0v7egha3ys",
    "paymentMethod": "CREDIT_CARD",
    "creditCard": {
      "firstSixDigits": "503143"
    },
    "status": "SUCCEEDED"
  }
}