Introdução

Início rápido (API v1)

Comece a usar a API da ZoryCash para automatizar PIX In, PIX Out e consultar saldos em tempo real.

Aviso de Ambiente: Estes endpoints são da API v1. Para trocar de ambiente (Sandbox/Produção), basta trocar a sua API Key (ak_test_ ou ak_live_).

A API v1 da ZoryCash é REST sobre HTTPS, usa JSON e trabalha com valores monetários estritamente em centavos inteiros. Exemplo: 5000 representa R$ 50,00.

1. Autenticação SeguraAcesse o painel para obter sua chave privada. Use ak_test_... para testes e ak_live_... para produção. Nunca exponha a chave em frontends.

2. Crie uma cobrança PIX com IdempotênciaFaça um POST /pix/charge. Sempre envie um external_ref único (o ID do pedido no seu banco) para evitar duplicação de cobranças em retentativas.

3. Exiba o PagamentoGuarde o id gerado. Mostre ao seu cliente o QR Code ou a string pix.copy_paste retornada.

4. Fluxo de WebhooksCadastre uma URL no painel. Assim que a transação for paga, disparamos um payment.confirmed. Use o data.external_ref para identificar o pedido.

5. Cuidados em ProduçãoAntes de liberar serviços ou produtos de alto valor, faça um GET /transactions/:id consultando nossa API para validar se o pagamento realmente ocorreu.

Primeira chamada

bash

curl -X POST https://api.zorycash.com.br/api/v1/pix/charge \  -H "x-api-key: SUA_CHAVE" \  -H "Content-Type: application/json" \  -d '{"amount_cents": 5000, "external_ref": "pedido_123", "description": "Pedido 123"}'