Listar cartões guardados
curl --request GET \
--url https://api.usevext.com/v1/cards \
--header 'Authorization: Bearer <token>'<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.usevext.com/v1/cards",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.usevext.com/v1/cards', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.usevext.com/v1/cards"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"object": "list",
"data": [
{
"object": "card",
"id": "<string>",
"brand": "visa",
"last_four": "<string>",
"exp_month": 6,
"exp_year": 123,
"holder_name": "<string>",
"expired": true,
"created_at": "2023-11-07T05:31:56Z",
"last_used_at": "2023-11-07T05:31:56Z"
}
],
"pagination": {
"page": 123,
"per_page": 123,
"total": 123,
"total_pages": 123,
"has_more": true
}
}Cartões
Listar cartões guardados
Os cartões que os seus compradores deixaram no cofre, com bandeira, final e validade.
GET
/
v1
/
cards
Listar cartões guardados
curl --request GET \
--url https://api.usevext.com/v1/cards \
--header 'Authorization: Bearer <token>'<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.usevext.com/v1/cards",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.usevext.com/v1/cards', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.usevext.com/v1/cards"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"object": "list",
"data": [
{
"object": "card",
"id": "<string>",
"brand": "visa",
"last_four": "<string>",
"exp_month": 6,
"exp_year": 123,
"holder_name": "<string>",
"expired": true,
"created_at": "2023-11-07T05:31:56Z",
"last_used_at": "2023-11-07T05:31:56Z"
}
],
"pagination": {
"page": 123,
"per_page": 123,
"total": 123,
"total_pages": 123,
"has_more": true
}
}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
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
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.
Required range:
1 <= x <= 100Required range:
x >= 1