Comece aquiSegurança da API
Repetir uma chamada
Reenvie a chamada que ficou sem resposta com a mesma chave da primeira tentativa, e a API retorna a operação que já existe.
Com Idempotency-Key
No PayZu Conta Hub, a chave vai no header Idempotency-Key.
bash
# Uma chave nova para cada operação; na retentativa, reaproveite a mesma.
IDEMPOTENCY_KEY=$(uuidgen)
curl --request POST \
--url 'https://api.sandbox.payzu.dev/api/v1/transactions/withdraw' \
--header "Authorization: Bearer $PAYZU_TOKEN" \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--header 'Content-Type: application/json' \
--data '{
"amount": 10000,
"pixKey": "fulano@exemplo.com",
"pixKeyType": "EMAIL",
"comment": "Repasse semanal"
}'Referência: Enviar um Pix para uma chave
Com clientReference
No PayZu Pix, a chave vai no corpo, em clientReference.
bash
curl --request POST \
--url 'https://pix.sandbox.payzu.dev/v1/pix' \
--header "Authorization: Bearer $PAYZU_TOKEN" \
--header 'Content-Type: application/json' \
--data '{
"amount": 10,
"expiresIn": 600,
"clientReference": "order_12345"
}'Referência: Criar uma cobrança Pix com QR Code
A cobrança também pode ser localizada pela referência.
Consulte GET /pix?clientReference=... quando não souber se a primeira tentativa chegou.
O que cada produto responde na repetição está em Idempotência.