curl --request POST \
  --url https://api.sandbox.z2pay.com/v1/checkout/sessions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "linkId": "<string>",
  "customer": {
    "name": "<string>",
    "email": "jsmith@example.com",
    "document": "<string>",
    "phone": "<string>",
    "address": {
      "zipCode": "<string>",
      "street": "<string>",
      "number": "<string>",
      "complement": "<string>",
      "neighborhood": "<string>",
      "city": "<string>",
      "state": "<string>",
      "country": "BR"
    }
  },
  "metadata": {}
}
'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    linkId: '<string>',
    customer: {
      name: '<string>',
      email: 'jsmith@example.com',
      document: '<string>',
      phone: '<string>',
      address: {
        zipCode: '<string>',
        street: '<string>',
        number: '<string>',
        complement: '<string>',
        neighborhood: '<string>',
        city: '<string>',
        state: '<string>',
        country: 'BR'
      }
    },
    metadata: {}
  })
};

fetch('https://api.sandbox.z2pay.com/v1/checkout/sessions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.sandbox.z2pay.com/v1/checkout/sessions"

payload = {
    "linkId": "<string>",
    "customer": {
        "name": "<string>",
        "email": "jsmith@example.com",
        "document": "<string>",
        "phone": "<string>",
        "address": {
            "zipCode": "<string>",
            "street": "<string>",
            "number": "<string>",
            "complement": "<string>",
            "neighborhood": "<string>",
            "city": "<string>",
            "state": "<string>",
            "country": "BR"
        }
    },
    "metadata": {}
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": "cs_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
  "linkId": "chk_byd8p3p79re859jpkmr0j65n3",
  "status": "created",
  "mode": "payment",
  "currency": "BRL",
  "locale": "pt-BR",
  "config": {
    "paymentMethods": {
      "card": {
        "enabled": true
      },
      "pix": {
        "enabled": true
      }
    },
    "successUrl": "https://academia.com/obrigado"
  },
  "customer": {
    "name": "João Silva",
    "email": "joao@example.com"
  },
  "customFieldValues": null,
  "paymentMethodSelected": null,
  "subtotal": 49700,
  "discountTotal": 0,
  "amount": 49700,
  "discounts": null,
  "paymentAttempts": 0,
  "transactionId": null,
  "subscriptionId": null,
  "invoiceId": null,
  "metadata": {
    "source": "api"
  },
  "createdAt": "2025-06-29T13:45:30.000Z",
  "updatedAt": "2025-06-29T13:45:30.000Z",
  "openedAt": null,
  "paidAt": null,
  "canceledAt": null,
  "expiresAt": "2025-06-30T13:45:30.000Z",
  "url": "https://pay.z2pay.com/c/cs_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Validation failed",
    "issues": [
      {
        "path": "status",
        "message": "Status inválido. Valores aceitos: pending, waiting_payment, paid, refused, canceled, refunded"
      },
      {
        "path": "startDate",
        "message": "Data deve ser ISO 8601 com timezone (ex.: 2026-06-24T00:00:00Z)"
      }
    ]
  }
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  }
}

{
  "error": {
    "code": "FORBIDDEN",
    "message": "Forbidden — insufficient permissions"
  }
}

{
  "error": "A request with this idempotency key is already being processed"
}

{
  "error": "Idempotency key already used with a different request body"
}