Ecossistema

REST

Receitas HTTP prontas para Postman, Insomnia, curl e qualquer client. Prefixo: /api/v1.

Referência completa em Referência → PIX.

Autenticação

export HYZEPAY_API_KEY=hzp_live_XXXXXXXX
export HYZEPAY_BASE_URL=https://hyzepay.pro

# Authorization: Bearer  OU  X-API-Key

Criar pagamento

curl -X POST "$HYZEPAY_BASE_URL/api/v1/payments" \
  -H "Authorization: Bearer $HYZEPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount_cents": 1500,
    "description": "Pedido #1001",
    "external_id": "pedido-1001",
    "customer": {
      "name": "Maria Silva",
      "email": "maria@email.com",
      "document": "12345678909"
    }
  }'

Consultar

curl "$HYZEPAY_BASE_URL/api/v1/payments/pedido-1001" \
  -H "Authorization: Bearer $HYZEPAY_API_KEY"

Listar

curl "$HYZEPAY_BASE_URL/api/v1/payments?status=paid&limit=20" \
  -H "Authorization: Bearer $HYZEPAY_API_KEY"

Cancelar

curl -X DELETE "$HYZEPAY_BASE_URL/api/v1/payments/pedido-1001" \
  -H "Authorization: Bearer $HYZEPAY_API_KEY"