{
  "id": "abc123-def456-ghi789",
  "object": "charge",
  "billing_type": "PIX",
  "status": "PENDING",
  "value": 99.90,
  "net_value": 93.91,
  "platform_fee": 5.99,
  "pix": {
    "txid": "zp1234567890abcdef...",
    "qr_code": "data:image/png;base64,iVBORw0KGgo...",
    "copy_paste": "00020126580014br.gov.bcb.pix...",
    "expires_at": "2026-01-20T14:00:00Z"
  },
  "created_at": "2026-01-20T13:00:00Z"
}

zp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

curl -X GET https://api.appzucropay.com/api/v1/charges \
  -H "X-API-Key: zp_sua_api_key_aqui"

curl -X GET https://api.appzucropay.com/api/v1/charges \
  -H "Authorization: Bearer zp_sua_api_key_aqui"

{
  "error": "API Key não fornecida",
  "code": "API_KEY_MISSING"
}

{
  "error": "API Key inválida ou inativa",
  "code": "API_KEY_INVALID"
}

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1705761300

{
  "billing_type": "PIX",
  "value": 99.90
}

{
  "billing_type": "CREDIT_CARD",
  "value": 99.90
}

{
  "billing_type": "UNDEFINED",
  "value": 99.90
}

{
  "value": 100.00,
  "net_value": 86.93,
  "platform_fee": 8.49,
  "reserve_amount": 4.58
}

const response = await fetch('https://api.appzucropay.com/api/v1/charges', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'zp_sua_api_key'
  },
  body: JSON.stringify({
    billing_type: 'PIX',
    value: 99.90,
    description: 'Meu Produto',
    customer: {
      name: 'Cliente',
      cpf_cnpj: '12345678900'
    }
  })
});

const data = await response.json();

// Exibir QR Code
document.getElementById('qrcode').src = data.pix.qr_code;

// Código para copiar
document.getElementById('pixCode').textContent = data.pix.copy_paste;

const response = await fetch('https://api.appzucropay.com/api/v1/charges', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'zp_sua_api_key'
  },
  body: JSON.stringify({
    billing_type: 'CREDIT_CARD',
    value: 149.90,
    description: 'Assinatura Premium',
    customer: {
      name: 'Maria Santos',
      email: 'maria@email.com',
      cpf_cnpj: '98765432100'
    },
    postback_url: 'https://meusite.com/webhooks/zucropay'
  })
});

const data = await response.json();

// Redirecionar o cliente para o link de pagamento:
window.location.href = data.payment_url;

{
  "id": "def456-ghi789-jkl012",
  "object": "charge",
  "billing_type": "CREDIT_CARD",
  "status": "PENDING",
  "value": 149.90,
  "net_value": 140.93,
  "platform_fee": 8.97,
  "payment_url": "https://pay.zucropay.com/charge/abc123def456",
  "charge_id": 12345678,
  "created_at": "2026-01-20T13:00:00.000Z"
}

{
  "event": "payment.received",
  "data": {
    "payment_id": "abc123-def456",
    "value": 99.90,
    "net_value": 93.91,
    "status": "RECEIVED",
    "billing_type": "PIX",
    "customer": {
      "name": "João Silva",
      "email": "joao@email.com"
    }
  },
  "timestamp": "2026-01-20T13:05:00.000Z"
}

https://api.appzucropay.com

X-API-Key: zp_sua_api_key_aqui

{
  "error": "Mensagem de erro",
  "code": "ERROR_CODE",
  "details": {}
}

curl -X GET https://api.appzucropay.com/api/v1/account \
  -H "X-API-Key: zp_sua_api_key_aqui"

{
  "object": "account",
  "id": "abc123-def456-ghi789",
  "name": "Empresa XYZ Ltda",
  "email": "contato@empresa.com",
  "document": "12345678000199",
  "person_type": "PJ",
  "phone": "11999998888",
  "account_status": "active",
  "identity_verified": true,
  "payment_provider": "efibank",
  "created_at": "2026-01-15T10:00:00.000Z"
}

{
  "id": "abc123-def456-ghi789",
  "object": "charge",
  "billing_type": "PIX",
  "status": "PENDING",
  "value": 99.90,
  "net_value": 93.91,
  "platform_fee": 5.99,
  "pix": {
    "txid": "zp1234567890abcdefghijklmnop",
    "qr_code": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
    "copy_paste": "00020126580014br.gov.bcb.pix0136...",
    "expires_at": "2026-01-20T14:00:00.000Z"
  },
  "created_at": "2026-01-20T13:00:00.000Z"
}

{
  "id": "def456-ghi789-jkl012",
  "object": "charge",
  "billing_type": "CREDIT_CARD",
  "status": "PENDING",
  "value": 149.90,
  "net_value": 140.93,
  "platform_fee": 8.97,
  "payment_url": "https://pay.zucropay.com/charge/abc123def456",
  "charge_id": 12345678,
  "created_at": "2026-01-20T13:00:00.000Z"
}

curl -X GET https://api.appzucropay.com/api/v1/charges/abc123-def456 \
  -H "X-API-Key: zp_sua_api_key_aqui"

{
  "id": "abc123-def456-ghi789",
  "object": "charge",
  "billing_type": "PIX",
  "status": "RECEIVED",
  "value": 99.90,
  "net_value": 93.91,
  "description": "Produto Premium",
  "pix": {
    "txid": "zp1234567890abcdefghijklmnop",
    "qr_code": "...",
    "copy_paste": "..."
  },
  "payment_date": "2026-01-20T13:05:00.000Z",
  "created_at": "2026-01-20T13:00:00.000Z"
}

curl -X GET "https://api.appzucropay.com/api/v1/charges?status=RECEIVED&limit=10" \
  -H "X-API-Key: zp_sua_api_key_aqui"

{
  "object": "list",
  "data": [
    {
      "id": "abc123-def456",
      "billing_type": "PIX",
      "status": "RECEIVED",
      "value": 99.90,
      "description": "Produto A",
      "created_at": "2026-01-20T13:00:00.000Z"
    },
    {
      "id": "xyz789-uvw123",
      "billing_type": "CREDIT_CARD",
      "status": "RECEIVED",
      "value": 149.90,
      "description": "Produto B",
      "created_at": "2026-01-19T10:30:00.000Z"
    }
  ],
  "total": 156,
  "has_more": true
}

curl -X GET https://api.appzucropay.com/api/v1/balance \
  -H "X-API-Key: zp_sua_api_key_aqui"

{
  "object": "balance",
  "available": 1500.00,
  "reserved": 75.00,
  "total": 1575.00
}

curl -X POST https://api.appzucropay.com/api/webhooks \
  -H "Authorization: Bearer seu_token" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://seusite.com/webhooks/zucropay",
    "events": ["payment.received", "payment.failed"]
  }'

{
  "success": true,
  "webhook": {
    "id": "wh_abc123",
    "url": "https://seusite.com/webhooks/zucropay",
    "events": ["payment.received", "payment.failed"],
    "secret": "whsec_xyz789",
    "active": true
  }
}

npm install axios

const ZUCROPAY_API_KEY = 'sua_api_key';
const ZUCROPAY_BASE_URL = 'https://api.appzucropay.com';

const api = axios.create({
  baseURL: ZUCROPAY_BASE_URL,
  headers: {
    'X-API-Key': ZUCROPAY_API_KEY,
    'Content-Type': 'application/json'
  }
});

async function criarCobrancaPix(valor, descricao, cliente) {
  try {
    const response = await api.post('/api/v1/charges', {
      value: valor,
      description: descricao,
      billing_type: 'PIX',
      customer: {
        name: cliente.nome,
        cpf_cnpj: cliente.cpf,
        email: cliente.email
      }
    });

    console.log('QR Code:', response.data.pix.qr_code);
    console.log('Copia e Cola:', response.data.pix.copy_paste);
    return response.data;
  } catch (error) {
    console.error('Erro ao criar cobrança:', error.response?.data);
    throw error;
  }
}

// Uso
const cobranca = await criarCobrancaPix(
  99.90, 
  'Produto XYZ',
  { nome: 'João Silva', cpf: '12345678900', email: 'joao@email.com' }
);

class ZucroPay {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.baseUrl = 'https://api.appzucropay.com';
  }

  async request(method, endpoint, data = null) {
    const options = {
      method,
      headers: {
        'X-API-Key': this.apiKey,
        'Content-Type': 'application/json'
      }
    };

    if (data) {
      options.body = JSON.stringify(data);
    }

    const response = await fetch(`${this.baseUrl}${endpoint}`, options);
    return response.json();
  }

  // Cobranças
  async criarCobranca(data) {
    return this.request('POST', '/api/v1/charges', data);
  }

  async buscarCobranca(id) {
    return this.request('GET', `/api/v1/charges/${id}`);
  }

  async listarCobrancas() {
    return this.request('GET', '/api/v1/charges');
  }

  async estornarCobranca(id, amount) {
    return this.request('POST', `/api/v1/charges/${id}/refund`, { amount });
  }

  // Produtos
  async criarProduto(data) {
    return this.request('POST', '/api/v1/products', data);
  }

  async listarProdutos() {
    return this.request('GET', '/api/v1/products');
  }

  // Links de Pagamento
  async criarLink(data) {
    return this.request('POST', '/api/v1/payment-links', data);
  }

  async listarLinks() {
    return this.request('GET', '/api/v1/payment-links');
  }

  // Saldo e Saques
  async saldo() {
    return this.request('GET', '/api/v1/balance');
  }

  async solicitarSaque(amount, pix_key) {
    return this.request('POST', '/api/v1/withdrawals', { amount, pix_key });
  }
}

// Uso
const zucropay = new ZucroPay('zp_sua_api_key');
const cobranca = await zucropay.criarCobranca({
  value: 100,
  description: 'Teste',
  billing_type: 'PIX',
  customer: { name: 'Cliente', cpf_cnpj: '12345678900' }
});

curl -X POST https://api.appzucropay.com/api/v1/charges/abc123/refund \
  -H "Content-Type: application/json" \
  -H "X-API-Key: zp_sua_api_key_aqui" \
  -d '{
    "amount": 50.00,
    "reason": "Cliente solicitou devolução"
  }'

{
  "object": "refund",
  "id": "ref_a1b2c3d4e5f6",
  "charge_id": "abc123",
  "amount": 50.00,
  "reason": "Cliente solicitou devolução",
  "status": "succeeded",
  "created_at": "2026-01-20T14:00:00.000Z"
}

{
  "object": "customer",
  "id": "cus_abc123def456",
  "name": "João Silva",
  "email": "joao@email.com",
  "cpf_cnpj": "12345678900",
  "phone": "11999999999",
  "created_at": "2026-01-20T13:00:00.000Z"
}

{
  "object": "list",
  "data": [],
  "total": 0,
  "has_more": false
}

{
  "object": "payment_link",
  "id": "abc123-def456",
  "name": "Produto Premium",
  "description": "Acesso vitalício",
  "value": 299.90,
  "billing_type": "UNDEFINED",
  "checkout_url": "https://dashboard.appzucropay.com/checkout/abc123-def456",
  "active": true,
  "created_at": "2026-01-20T13:00:00.000Z"
}

{
  "object": "list",
  "data": [
    {
      "id": "abc123-def456",
      "name": "Produto Premium",
      "value": 299.90,
      "billing_type": "UNDEFINED",
      "checkout_url": "https://dashboard.appzucropay.com/checkout/abc123-def456",
      "active": true,
      "total_received": 1500.00,
      "created_at": "2026-01-20T13:00:00.000Z"
    }
  ],
  "total": 1
}

{
  "success": true,
  "message": "Link desativado"
}

{
  "object": "product",
  "id": "prod_abc123",
  "name": "Curso Premium",
  "description": "Acesso vitalício ao curso",
  "price": 497.00,
  "image_url": "https://exemplo.com/imagem.jpg",
  "stock": null,
  "active": true,
  "created_at": "2026-01-20T13:00:00.000Z"
}

{
  "object": "list",
  "data": [
    {
      "id": "prod_abc123",
      "name": "Curso Premium",
      "description": "Acesso vitalício",
      "price": 497.00,
      "image_url": "https://exemplo.com/imagem.jpg",
      "stock": null,
      "active": true,
      "created_at": "2026-01-20T13:00:00.000Z"
    }
  ],
  "total": 1
}

{
  "object": "product",
  "id": "prod_abc123",
  "name": "Curso Premium Atualizado",
  "price": 597.00,
  "active": true
}

{
  "success": true,
  "message": "Produto excluído"
}

{
  "object": "list",
  "data": [
    {
      "id": "txn_abc123",
      "type": "credit",
      "amount": 99.90,
      "status": "completed",
      "description": "Pagamento recebido",
      "created_at": "2026-01-20T13:05:00.000Z"
    }
  ],
  "total": 1
}

{
  "object": "withdrawal",
  "id": "wd_abc123",
  "amount": 500.00,
  "status": "pending",
  "created_at": "2026-01-20T14:00:00.000Z"
}

{
  "object": "list",
  "data": [
    {
      "id": "wd_abc123",
      "amount": 500.00,
      "status": "approved",
      "pix_key": "email@exemplo.com",
      "created_at": "2026-01-20T14:00:00.000Z"
    }
  ],
  "total": 1
}

{
  "object": "list",
  "data": [
    {
      "id": "wh_abc123",
      "url": "https://seusite.com/webhook",
      "events": ["payment.received", "payment.refunded"],
      "status": "active",
      "created_at": "2026-01-20T10:00:00.000Z"
    }
  ],
  "total": 1
}

{
  "success": true,
  "message": "Webhook removido"
}

{
  "success": true,
  "id": "key_abc123",
  "name": "Minha API Key",
  "api_key": "zp_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0",
  "created_at": "2026-01-20T10:00:00.000Z",
  "warning": "Guarde esta chave em local seguro. Ela não será exibida novamente."
}

{
  "keys": [
    {
      "id": "key_abc123",
      "name": "Minha API Key",
      "api_key": "zp_a1b2...t0",
      "status": "active",
      "last_used_at": "2026-01-20T15:30:00.000Z",
      "created_at": "2026-01-20T10:00:00.000Z"
    }
  ]
}

{
  "success": true,
  "message": "API Key revogada"
}