Revelar dados do VCN (Em breve)

🚧 Em breve — este endpoint ainda não está disponível em Sandbox nem Produção. A documentação está publicada para você preparar a integração; avisaremos no changelog quando entrar no ar.

Retorna os dados do cartão (PAN, CVV e validade) de um VCN já emitido, identificado pelo vcnId retornado em Criar VCN. A emissão entrega esses dados uma única vez — use esta rota para reobtê-los.

Segurança: a resposta traz PAN e CVV em claro — trate apenas em memória, não logue, não cacheie (a resposta vem com Cache-Control: no-store) e prefira exibição única na sua interface. O vcnId precisa pertencer ao cliente autenticado; caso contrário, 404.

curl -X GET "https://api-sandbox.contasimples.com/credit-cards/v1/vcns/01JQ8ZK7X4M8N2P5R6T7V8W9XY/reveal" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

import requests
import json

url = "https://api-sandbox.contasimples.com/credit-cards/v1/vcns/01JQ8ZK7X4M8N2P5R6T7V8W9XY/reveal"
headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch("https://api-sandbox.contasimples.com/credit-cards/v1/vcns/01JQ8ZK7X4M8N2P5R6T7V8W9XY/reveal", {
  method: "GET",
  headers: {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
}
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
)

func main() {

    req, err := http.NewRequest("GET", "https://api-sandbox.contasimples.com/credit-cards/v1/vcns/01JQ8ZK7X4M8N2P5R6T7V8W9XY/reveal", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    fmt.Println("Response Status:", resp.Status)
}

require 'net/http'
require 'json'

uri = URI('https://api-sandbox.contasimples.com/credit-cards/v1/vcns/01JQ8ZK7X4M8N2P5R6T7V8W9XY/reveal')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'

response = http.request(request)
puts response.body

{
  "pan": "4111111111111111",
  "cvv": "123",
  "expirationDate": "06/2031"
}

GET

/credit-cards/v1/vcns/{vcnId}/reveal

GET

Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token

Bearer Tokenstring

Required

Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer TOKEN

path

vcnIdstring

Required

Identificador do VCN retornado na emissão (campo vcnId).

Request Preview

Response

Response will appear here after sending the request

Authentication

header

Authorizationstring

Required

Bearer token. Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer TOKEN

Path Parameters

vcnIdstring

Required

Identificador do VCN retornado na emissão (campo vcnId).

Example:

01JQ8ZK7X4M8N2P5R6T7V8W9XY

Responses

panstring

Required

Número do cartão (PAN). Não deve ser logado.

cvvstring

Required

Código de segurança (CVV).

expirationDatestring

Required

Validade física do cartão, no formato MM/YYYY — mês com dois dígitos e ano com quatro (ex.: 06/2031 = junho de 2031).

Was this page helpful?