PayZu PaymentsCobranças
Cobrança com antifraude
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
| Campo | Regra |
|---|---|
fingerPrintId | Gerado no checkout, sem se repetir por 48 horas. Pode ser o número do pedido. |
browser | IP do comprador e se o navegador aceita cookies. Os outros campos são opcionais. |
customer em BRL | name, identity, identityType, email, phone e address. |
customer em outra moeda | name. |
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:
id | Valor aceito |
|---|---|
1 | Login do comprador na sua loja ou Guest. |
4 | Canal da venda: Call Center, Web, Portal, Quiosque ou Móvel. |
9 | SIM ou NAO: o comprador retira o produto na loja. |
83 | Segmento 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ódigo | HTTP | Mensagem |
|---|---|---|
PZ010 | 403 | Produto não habilitado |
PZ201 | 422 | Apenas 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.