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 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
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
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