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,versionereferenceId. - 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ódigo | HTTP | Mensagem |
|---|---|---|
PZ010 | 403 | Produto não habilitado |
Os erros de autenticação e de validação e os demais códigos estão no Catálogo de erros.