PayZu PaymentsCobranças

Cobrança com antifraude


Nesta páginaMonte os dados de antifraudeCampos MDDErros desta operação

Envie na cobrança o bloco creditCardPayment.fraudAnalysis, com o fingerprint do aparelho, os dados do navegador e os campos MDD.

Monte os dados de antifraude

CampoRegra
fingerPrintIdGerado no checkout, sem se repetir por 48 horas. Pode ser o número do pedido.
browserIP do comprador e se o navegador aceita cookies. Os outros campos são opcionais.
customer em BRLname, identity, identityType, email, phone e address.
customer em outra moedaname.

phone segue o formato de Crie a cobrança. Formatos e tamanhos estão na referência da rota.

Campos MDD

definedFields é uma lista de { id, value }, com cada id uma única vez e value com até 255 caracteres. Quatro ids são obrigatórios:

idValor aceito
1Login do comprador na sua loja ou Guest.
4Canal da venda: Call Center, Web, Portal, Quiosque ou Móvel.
9SIM ou NAO: o comprador retira o produto na loja.
83Segmento de negócio, como Varejo.

A API aceita outros ids opcionais, os da Tabela de MDDs; um id fora dela é recusado com Id <id> desconhecido.

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",
      "address": {
        "street": "Avenida Paulista",
        "number": "1000",
        "complement": "Conjunto 101",
        "zipCode": "01310100",
        "city": "Sao Paulo",
        "state": "SP",
        "country": "BR",
        "district": "Bela Vista"
      }
    },
    "cart": [
      { "name": "Plano Pro", "quantity": 1, "sku": "PRO", "unitPrice": 10000 }
    ],
    "creditCardPayment": {
      "installments": 1,
      "authenticate": false,
      "card": {
        "number": "4111111111111111",
        "holder": "MARIA SOUZA",
        "expiration": "12/2030",
        "cvv": "123"
      },
      "fraudAnalysis": {
        "fingerPrintId": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
        "browser": {
          "cookiesAccepted": true,
          "email": "maria.souza@example.com",
          "hostName": "www.sualoja.com.br",
          "ipAddress": "200.201.202.203",
          "type": "Chrome"
        },
        "definedFields": [
          { "id": 1, "value": "maria.souza" },
          { "id": 4, "value": "Web" },
          { "id": 9, "value": "NAO" },
          { "id": 83, "value": "Varejo" }
        ]
      }
    }
  }'

Referência: Criar uma cobrança

A resposta tem o formato de Criar uma cobrança.

Cobrar com e sem antifraude 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
PZ201422Apenas cartões estrangeiros são aceitos quando currency é diferente de BRL

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