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


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.

Linguagem

Credenciais Bearer

Token de API

curl --request POST \     --url https://api.sandbox.payzu.dev/v1/customers/{customer_id}/cards \     --header 'authorization: Bearer SEU_TOKEN' \     --header 'accept: application/json' \     --header 'content-type: application/json' \     --data '{}'
Resposta

Clique em Try It! para enviar uma requisição e ver a resposta aqui. Ou escolha um exemplo:

application/json