PayZu GatewayCartõesCartões salvos
Salvar um cartão
POST/v1/customers/{customer_id}/cards
Confira o passo a passo → https://docs.payzu.com.br/docs/gateway/save-a-card
Requisições recentes
Path Params
customer_idstringobrigatório
ID do cliente.
Body Params
card_tokenstring
Token do cartão, gerado com a chave de checkout ou pelo script de tokenização.
cardobject
Dados do cartão, no lugar de card_token.
Headers
Authorizationstringobrigatório
Bearer seguido do token de API.
acceptstring
Formato da resposta.
Responses
200Cartão já salvo
idstringID do cartão salvo.
brandstring | nullBandeira.
last_digitsstringÚltimos 4 dígitos.
expirationstring | nullValidade, MM/AAAA.
holder_namestring | nullNome impresso no cartão.
last_used_atstring | nullÚltima tentativa de pagamento com o cartão salvo, aprovada ou não; a renovação automática da assinatura no cartão não muda o campo. Nulo enquanto não houve tentativa.
created_atstringData e hora da criação.
updated_atstringData e hora da última alteração.
201Cartão salvo
idstringID do cartão salvo.
brandstring | nullBandeira.
last_digitsstringÚltimos 4 dígitos.
expirationstring | nullValidade, MM/AAAA.
holder_namestring | nullNome impresso no cartão.
last_used_atstring | nullÚltima tentativa de pagamento com o cartão salvo, aprovada ou não; a renovação automática da assinatura no cartão não muda o campo. Nulo enquanto não houve tentativa.
created_atstringData e hora da criação.
updated_atstringData e hora da última alteração.
400Requisição inválida
status_codeintegerStatus HTTP.
errorstringNome do status HTTP.
messagestringMotivo em texto.
codestringCódigo do erro, quando existe.
request_idstringID da chamada, para o suporte.
fieldsarray of objectsCampos recusados na validação.
Campos de cada item 2
namestringCaminho do campo recusado.
messagestringMotivo da recusa.
401Chave ausente ou inválida
status_codeintegerStatus HTTP.
errorstringNome do status HTTP.
messagestringMotivo em texto.
codestringCódigo do erro, quando existe.
request_idstringID da chamada, para o suporte.
403Acesso negado
status_codeintegerStatus HTTP.
errorstringNome do status HTTP.
messagestringMotivo em texto.
codestringCódigo do erro, quando existe.
request_idstringID da chamada, para o suporte.
404Não encontrado
status_codeintegerStatus HTTP.
errorstringNome do status HTTP.
messagestringMotivo em texto.
request_idstringID da chamada, para o suporte.
500Erro interno
status_codeintegerStatus HTTP.
errorstringNome do status HTTP.
messagestringMotivo em texto.
request_idstringID da chamada, para o suporte.
503Serviço indisponível
status_codeintegerStatus HTTP.
errorstringNome do status HTTP.
messagestringMotivo em texto.
codestringCódigo do erro, quando existe.
request_idstringID da chamada, para o suporte.
Esta página ajudou?