Cria uma sessão de checkout no Stripe

POST /create-checkout-session

Gera uma sessão de checkout para múltiplos produtos e calcula os impostos com base no país do cliente.

application/json

Body Required

  • amount number(float) Required

    Valor total da compra (incluindo impostos).

  • cartItems array[object] Required

    Lista de itens no carrinho.

    Hide cartItems attributes Show cartItems attributes object
    • name string Required

      Nome do produto.

    • price number(float) Required

      Preço unitário do produto.

    • quantity integer Required

      Quantidade do produto.

  • customerCountry string Required

    Código do país do cliente (ISO 3166-1 alfa-2).

Responses

  • 200 application/json

    Sessão de checkout criada com sucesso

    Hide response attribute Show response attribute object
    • id string

      ID da sessão de checkout criada.
  • 500 application/json

    Erro ao criar a sessão de checkout

    Hide response attribute Show response attribute object
    • error string

      Mensagem de erro detalhada.
POST /create-checkout-session 
curl \
 --request POST 'http://localhost:8000/create-checkout-session' \
 --header "Content-Type: application/json" \
 --data '{"amount":120,"cartItems":[{"name":"Produto Exemplo","price":10,"quantity":2}],"customerCountry":"PT"}'
Request examples 
{
  "amount": 120,
  "cartItems": [
    {
      "name": "Produto Exemplo",
      "price": 10,
      "quantity": 2
    }
  ],
  "customerCountry": "PT"
}
Response examples (200) 
{
  "id": "cs_test_a1b2c3d4e5f6g7h8"
}
Response examples (500) 
{
  "error": "Invalid amount."
}