PayZu GatewayClientes e cartões

Salvar um cartão


Nesta páginaEnvie o token ou os dados do cartãoCobre com o cartão salvoErros desta operação

O salvamento guarda o cartão no cliente sem cobrar nada e retorna o id usado nas próximas cobranças.

Envie o token ou os dados do cartão

bash
curl -X POST https://api.sandbox.payzu.dev/v1/customers/cus_bdQT0ls1QMIXVuhngvhbwC/cards \
  -H "Authorization: Bearer SUA_CHAVE_DE_API" \
  -H "Content-Type: application/json" \
  -d '{ "card_token": "UTYi5E0smwqD8P5U8pupcDtT1aIAbpgkc5HLQFGkb3I" }'

Referência: Salvar um cartão

FormaCampos
Com tokencard_token, gerado na tokenização.
Com os dados do cartãocard, com number, expiration (MM/AAAA), cvv, holder_name e, se quiser, holder_document.

Envie uma das duas formas. A adquirente não confere o cartão no salvamento, e um cartão inválido só aparece na primeira cobrança.

O mesmo cartão do mesmo cliente não se repete. Salvar de novo responde 200, no lugar de 201, com o mesmo id, e atualiza a validade e o nome com o que veio.

Esta rota ignora a Idempotency-Key, e cada chamada roda de novo.

Com os dados do cartão, repetir retorna o mesmo cartão. Com card_token, o token serve para uma operação só, e a repetição é recusada mesmo quando a primeira chamada salvou o cartão. Confira a lista do cliente antes de gerar outro token.

Cobre com o cartão salvo

Envie o id do cartão em payment.credit_card.card_id ao criar uma fatura. Ao pagar uma fatura ou criar uma assinatura, o campo é credit_card.card_id.

Corpo de POST /v1/invoices
{
  "description": "Pedido 1234",
  "external_reference": "pedido-1234",
  "amount": 15990,
  "customer_id": "cus_bdQT0ls1QMIXVuhngvhbwC",
  "payment": {
    "method": "credit_card",
    "credit_card": {
      "card_id": "card_6WnQ2xLmVb8TzYc4KdRh3E",
      "installments": 1
    }
  }
}

Erros desta operação

CódigoHTTPMensagem
PZ201400Token de cartão inválido ou vencido. Gere o token de novo.
-404Cliente não encontrado para o id informado.
PZ202503Não foi possível processar o cartão agora. Tente de novo.

Os erros de autenticação e de validação estão no Catálogo de erros.