PayZu PaymentsCobranças

Cobrança com 3D Secure


Envie na cobrança o resultado da autenticação 3D Secure, com authenticate igual a true e os valores do evento success em creditCardPayment.externalAuthentication.

Envie a autenticação na cobrança

Copie para externalAuthentication, sem alterar, os valores retornados no evento success do script de 3DS:

  • Sempre: cavv, eci, version e referenceId.
  • Só quando existir: xid.
cURL
curl --request POST \
  --url 'https://api.sandbox.payzu.dev/v1/charges' \
  --header "Authorization: Bearer $PAYZU_TOKEN" \
  --cert "$PAYZU_CLIENT_CERT" --key "$PAYZU_CLIENT_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": 10000,
    "paymentType": "creditcard",
    "externalId": "pedido-1234",
    "postbackUrl": "https://seusite.com.br/webhooks/payzu",
    "customer": {
      "name": "Maria Souza",
      "identity": "11144477735",
      "identityType": "CPF",
      "email": "maria.souza@example.com",
      "phone": "5511999998888"
    },
    "cart": [
      { "name": "Plano Pro", "quantity": 1, "sku": "PRO", "unitPrice": 10000 }
    ],
    "creditCardPayment": {
      "installments": 1,
      "authenticate": true,
      "card": {
        "number": "4111111111111111",
        "holder": "MARIA SOUZA",
        "expiration": "12/2030",
        "cvv": "123"
      },
      "externalAuthentication": {
        "cavv": "AAABCZIhcQAAAABZlyFxAAAAAAA=",
        "xid": "MDAwMDAwMDAwMDAwMDAwMTIzNDU=",
        "eci": "05",
        "version": "2.2.0",
        "referenceId": "8c1b3e2a-1234-4a56-9b78-abcdef012345"
      }
    }
  }'

Referência: Criar uma cobrança

Formatos e tamanhos estão na referência da rota. O restante do corpo e a resposta são os de Criar uma cobrança.

Só a resposta da criação traz externalAuthentication.

O campo volta com os valores enviados. A consulta e o aviso não o trazem.

Cobrar com e sem 3D Secure são habilitações separadas.

Peça as duas se você vai usar os dois modos.

Erros desta operação

CódigoHTTPMensagem
PZ010403Produto não habilitado

Os erros de autenticação e de validação e os demais códigos estão no Catálogo de erros.