PayZu PaymentsTutoriais
Cobrar no cartão de crédito
O POST /token exige o certificado de cliente, a cadeia da autoridade certificadora e o client_id e client_secret em Basic.
No cartão os valores vão em centavos: 10000 é R$ 100,00.
O resultado também chega no postbackUrl que você enviou na cobrança.
charge-credit-card.sh
# 1. Token: certificado mTLS + client_id e client_secretcurl --request POST \ --url https://api.sandbox.payzu.dev/v1/token \ --cert cliente.crt --key cliente.key --cacert ca.pem \ --user 'CLIENT_ID:CLIENT_SECRET' \ --header 'content-type: application/json' \ --data '{"grant_type": "client_credentials"}' # 2. Cobrança de R$ 100,00 (valores em centavos)curl --request POST \ --url https://api.sandbox.payzu.dev/v1/charges \ --cert cliente.crt --key cliente.key --cacert ca.pem \ --header 'authorization: Bearer SEU_TOKEN' \ --header 'content-type: application/json' \ --data @cobranca.json # 3. Consulte o resultadocurl --request GET \ --url https://api.sandbox.payzu.dev/v1/charges/CHARGE_ID \ --cert cliente.crt --key cliente.key --cacert ca.pem \ --header 'authorization: Bearer SEU_TOKEN'
Resposta · 201 Cobrança criada
{ "id": "e3b7a1f2-8c4d-4a09-9f1e-2b6c8d5a7e90", "externalId": "pedido-1234", "postbackUrl": "https://seusite.com.br/webhooks/payzu", "amount": 10000, "paymentType": "creditcard", "createdAt": "2026-06-12T14:35:22.000Z", "updatedAt": "2026-06-12T14:35:24.000Z", "customer": { "name": "Maria Souza", "identity": "11144477735", "identityType": "CPF", "email": "maria.souza@example.com", "birthdate": "1990-04-15", "phone": "5511999998888", "address": { "street": "Avenida Paulista", "number": "1000", "zipCode": "01310100", "city": "São Paulo", "state": "SP", "country": "BR", "district": "Bela Vista", "complement": "Conjunto 101" } }, "cart": [ { "name": "Plano Pro", "quantity": 1, "sku": "PRO", "unitPrice": 10000 } ], "creditCardPayment": { "installments": 1, "authenticate": false, "currency": "BRL", "acquirerTransactionId": "1049329871283a5d2b8e", "authorizationCode": "128734", "reasonCode": 0, "retryAllowed": null, "retryAfter": null, "reasonMessage": "Successful", "status": 2, "returnCode": "6", "returnMessage": "Operação realizada com sucesso", "externalAuthentication": {}, "reversedAmount": null, "reversedDate": null, "card": { "number": "411111******1111", "holder": "MARIA SOUZA", "expiration": "12/2030", "brand": "Visa" }, "chargebacks": [] }, "pixPayment": null}
Referência: Criar uma cobrança com cartão