Skip to main content
Cria uma nova sessão de checkout com pelo menos um item (preço + quantidade). Retorna a URL da página de pagamento para redirecionar o cliente.

​
Endpoint

cURL
curl -X POST https://api.upag.io/v1/checkout-sessions \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cus_ahwDXrgYvur89iPs",
    "items": [
      {
        "priceId": "price_def456ghi",
        "quantity": 1
      }
    ],
    "paymentMethods": ["credit_card", "pix"],
    "billingAddressCollection": "auto",
    "successUrl": "https://seusite.com/sucesso",
    "cancelUrl": "https://seusite.com/cancelado"
  }'

​
Parâmetros

​
items
array
required
Lista de linhas do checkout. Cada item precisa de priceId (string) e quantity (número, mínimo 1). É obrigatório pelo menos um item.
​
customerId
string
Opcional. ID do cliente (cus_...) para associar à sessão.
​
paymentMethods
string[]
Opcional. Métodos aceitos na sessão. Valores do enum da API: credit_card, pix.
​
billingAddressCollection
string
Opcional. Um de: auto, required, none.
​
successUrl
string
Opcional. URL válida para redirecionar após pagamento bem-sucedido.
​
cancelUrl
string
Opcional. URL válida se o cliente cancelar o fluxo.

​
Resposta

Response
{
  "id": "cs_abc123xyz",
  "status": "open",
  "customerId": "cus_ahwDXrgYvur89iPs",
  "url": "https://checkout.upag.io/cs_abc123xyz",
  "billingAddressCollection": false,
  "successUrl": "https://example.com/success",
  "cancelUrl": "https://example.com/cancel",
  "latitude": null,
  "longitude": null,
  "country": null,
  "region": null,
  "city": null,
  "expiresAt": "2024-11-16T10:00:00.000Z",
  "createdAt": "2024-11-15T10:00:00.000Z",
  "updatedAt": "2024-11-15T10:00:00.000Z",
  "items": []
}