Skip to main content
GET
Listar cartões guardados
O pm_ é a única referência ao cartão que sai da nossa casa, e é com ele que você cobra de novo — num upsell, numa recorrência. Filtrar por customer_document poupa você de guardar mais um identificador nosso ao lado do cadastro do comprador. Ver Cofre de cartões.
Um cartão entra no cofre de duas formas. Como efeito de uma venda aprovada com save_card — e aí ele traz junto a prova de que passou por um emissor de verdade — ou por POST /v1/cards, que o guarda sem cobrar e traz apenas uma verificação sem valor. Prefira a primeira sempre que houver uma primeira venda. Como pedir a guarda na venda está em Cobrança no cartão.

Authorizations

Authorization
string
header
required

Chave secreta do vendedor, criada no painel em Desenvolvedores.

O valor em claro existe uma única vez, na criação. Guardamos só o hash SHA-256 - nem o suporte consegue recuperá-lo, o que é o ponto: um dump do nosso banco não permite cobrar em nome de ninguém.

A chave vai no servidor. Colocá-la no navegador do comprador a entrega a qualquer pessoa que abra a página.

Scopes

cards:manage

Query Parameters

customer_document
string

CPF ou CNPJ do comprador, com ou sem pontuação. É o que você tem em mãos na hora de oferecer um upsell - e poupa você de guardar mais um identificador nosso.

include_expired
boolean
default:false
per_page
integer
default:25
Required range: 1 <= x <= 100
page
integer
default:1
Required range: x >= 1

Response

Página de cartões.

object
string
required
Allowed value: "list"
data
object[]
required
pagination
object
required