Remover cartão
curl --request DELETE \
--url https://api.upag.io/v1/cards/{cardId} \
--header 'Authorization: Bearer <token>'const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.upag.io/v1/cards/{cardId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://api.upag.io/v1/cards/{cardId}';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));Cartões
Remover cartão
Remove um cartão tokenizado da conta
DELETE
https://api.upag.io
/
v1
/
cards
/
{cardId}
Remover cartão
curl --request DELETE \
--url https://api.upag.io/v1/cards/{cardId} \
--header 'Authorization: Bearer <token>'const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.upag.io/v1/cards/{cardId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://api.upag.io/v1/cards/{cardId}';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));Remove o cartão (exclusão lógica) e, se ele era o cartão padrão do cliente, limpa esse padrão. O cartão deixa de poder ser cobrado e de aparecer em consultas e listagens.
A operação é idempotente: remover um cartão já removido também retorna sucesso.
Permissão:
card.write. Apenas chave secreta (sk_…).
Os exemplos usam o sandbox (
https://api.upag.dev/v1). Em produção use https://api.upag.io/v1 com sk_live_….Endpoint
curl -X DELETE https://api.upag.dev/v1/cards/5f0c3d1a-7b2e-4c9d-8a41-0e6f2b9d7c15 \
-H "Authorization: Bearer sk_test_your_api_key"
import { Upag } from 'upag';
const upag = new Upag('sk_test_your_api_key');
await upag.cards.remove('5f0c3d1a-7b2e-4c9d-8a41-0e6f2b9d7c15');
Parâmetros
string (uuid)
required
ID do cartão.
Resposta
204 No Content, sem corpo.
Erros
| Status | Mensagem | Causa |
|---|---|---|
404 | Card not found | Cartão inexistente ou de outra conta |
403 | — | Chave publicável (exige chave secreta) ou sem a permissão card.write |
422 | VALIDATION_FAILED | cardId não é UUID |