Criar checkout público do evento

​

Pré-requisitos

• O evento deve existir e ser acessível pelo contexto público.
• Cada id de ingresso enviado deve pertencer ao mesmo evento da URL.
• Para cada id de ingresso solicitado, quantity_available deve cobrir a quantidade pedida, caso contrário um 400 é retornado.
• Todas as questions configuradas no ingresso devem ser respondidas, com valores compatíveis com o tipo declarado (LIST, RADIO, STRING, INTEGER, DATE, EMAIL, PHONE, CPF).
• Se coupon_code for informado, deve corresponder a um cupom do evento (case-insensitive — códigos são convertidos para maiúsculas no servidor).

​

Parâmetros de caminho

​

Corpo da requisição

​

Resposta

{
  "id": "7b8c9d0e-1f2a-3b4c-5d6e-7f8a9b0c1d2e",
  "status": "PENDING",
  "total": 11400,
  "original_total": 12000,
  "discount_amount": 600,
  "customer": {
    "name": "Maria Silva",
    "email": "maria@example.com",
    "phone_number": "11987654321",
    "country_code": "+55"
  },
  "tickets": [
    {
      "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "ticket": "9b1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5e",
      "question_answers": []
    }
  ]
}

​

Ações relacionadas no mesmo recurso

• GET /event/event/{event_id}/checkout/{checkout_id}/ — retorna dados de pagamento: status, totais, resumo dos ingressos e payment_plan (allowPix, allowCreditCard, maxInstallments, maxInstallmentsWithoutInterest). Expira o checkout automaticamente se a janela de 20 minutos já tiver passado.
• POST /event/event/{event_id}/checkout/{checkout_id}/pay/ — envia os dados de pagamento (cartão ou PIX) e cria a transação subjacente. O corpo reutiliza o comprador capturado na criação. Retorna o payment_info do gateway (por exemplo, QR Code PIX, desafio 3DS). Retorna 400 se o checkout não estiver pagável.
• POST /event/event/{event_id}/checkout/validate-coupon/ — corpo {"code": "..."}. Retorna {valid, coupon:{id,name,code,type,value}} ou {valid: false, error}.
• GET /event/event/{event_id}/checkout/{checkout_id}/tickets/ — quando o checkout está pago, faz streaming de um PDF com os ingressos adquiridos. Caso contrário, renderiza uma página HTML de “não pago”.

​

Erros

​

Exemplos

curl -X POST https://api.dlpay.cloud/event/event/1a4e3d12-5b3f-4f0b-9c2c-89d2e1c1d111/checkout/ \
  -H "Content-Type: application/json" \
  -d '{
    "customer": {
      "name": "Maria Silva",
      "email": "maria@example.com",
      "phone_number": "11987654321",
      "country_code": "+55"
    },
    "tickets": [
      {"ticket": "9b1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5e", "question_answers": []}
    ],
    "coupon_code": "SUNSET10"
  }'

import requests

response = requests.post(
    "https://api.dlpay.cloud/event/event/1a4e3d12-5b3f-4f0b-9c2c-89d2e1c1d111/checkout/",
    json={
        "customer": {
            "name": "Maria Silva",
            "email": "maria@example.com",
            "phone_number": "11987654321",
            "country_code": "+55",
        },
        "tickets": [
            {"ticket": "9b1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5e", "question_answers": []}
        ],
        "coupon_code": "SUNSET10",
    },
)
checkout = response.json()

const response = await fetch(
  "https://api.dlpay.cloud/event/event/1a4e3d12-5b3f-4f0b-9c2c-89d2e1c1d111/checkout/",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      customer: {
        name: "Maria Silva",
        email: "maria@example.com",
        phone_number: "11987654321",
        country_code: "+55",
      },
      tickets: [
        { ticket: "9b1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5e", question_answers: [] },
      ],
      coupon_code: "SUNSET10",
    }),
  },
);
const checkout = await response.json();