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.