PayZu PaymentsTutoriais

Cobrar no cartão de crédito

  1. O POST /token exige o certificado de cliente, a cadeia da autoridade certificadora e o client_id e client_secret em Basic.

  2. No cartão os valores vão em centavos: 10000 é R$ 100,00.

  3. 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