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 como efeito de uma venda aprovada com save_card — e é por isso que não existe POST /v1/cards. Cartão guardado é cartão que já passou por um emissor, e essa regra é o que sustenta o pagamento de um clique. Como pedir a guarda 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.

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