---
title: "Autorização com credential on file (Stone Online)"
url: "https://devcenter.stone.com.br/legacy-stone-online-autorizacao-com-credential-on-file-copy"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_~QXV0b3JpemHDp8OjbyBjb20gY3JlZGVudGlhbCBvbiBmaWxlIChTdG9uZSBPbmxpbmUp,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9sZWdhY3ktc3RvbmUtb25saW5lLWF1dG9yaXphY2FvLWNvbS1jcmVkZW50aWFsLW9uLWZpbGUtY29weSI,s_Y13E2UraIF30dZL_.png"
---

# Autorização com credential on file

Documentação legada · Produtos e Tipos de transação

Documentação legada do Stone Online

Esta página descreve a **API Stone Online** (versão legada). Para projetos novos, explore o **[API Catalog](https://devcenter.stone.com.br/catalog)**.

## [Como utilizar](#como-utilizar)

Basicamente, transações utilizando Card on File vão utilizar as tags **initiating\_entity** e **initiating\_reason** com os respectivos valores:

Transação avulsa com armazenamento do cartão:

-   **initiating\_entity**:\*\* "account\_holder"\*\*
-   **initiating\_reason**:\*\* "credentials\_on\_file"\*\*

Transação com uso de cartão armazenado:

-   **initiating\_entity**: **"merchant"**
-   **initiating\_reason**: **"credentials\_on\_file"**

### [Exemplo](#exemplo)

```json
{
  "initiator": {
    "initiating_entity": "account_holder",
    "initiating_reason": "credentials_on_file"
}
```

```json
{
  "initiator": {
    "initiating_entity": "merchant",
    "initiating_reason": "credentials_on_file"
}
```

### [Exemplo de um Request Completo](#exemplo-de-um-request-completo)

```json
{
  "amount": 2000,
  "initiator_id": "e4ca44a8d57c4df6",
  "reference_id": "e4ca44a8d57c4df6",
  "local_datetime": "2024-04-12T12:01:54",
  "payment_method": "card",
  "channel": "website",
  "card_transaction": {
    "type": "credit",
    "operation_type": "auth_and_capture",
    "card": {
      "entry_mode": "credentials_on_file",
      "number": "6033401111633077000",
      "expiration_date": "3111",
      "cvv": "123",
      "holder_name": "TONY STARK"
    }
  },
  "initiator": {
    "initiating_entity": "account_holder",
    "initiating_reason": "credentials_on_file"
  }
}
```

```json
{
  "amount": 2000,
  "initiator_id": "e4ca44a8d57c4df6",
  "reference_id": "e4ca44a8d57c4df6",
  "local_datetime": "2024-04-12T12:01:54",
  "payment_method": "card",
  "channel": "website",
  "card_transaction": {
    "type": "credit",
    "operation_type": "auth_and_capture",
    "card": {
      "entry_mode": "credentials_on_file",
      "number": "6033401111633077000",
      "expiration_date": "3111",
      "cvv": "123",
      "holder_name": "TONY STARK"
    }
  },
  "initiator": {
    "initiating_entity": "merchant",
    "initiating_reason": "credentials_on_file"
  }
}
```

  

### [Exemplo de Response Completo](#exemplo-de-response-completo)

```json
{
  "id": "B7843C6C57836C5ETWGFU",
  "initiator_id": "1470375860-3.19.3.3-RG0DA3-0001",
  "reference_id": "787CVBNBN794",
  "amount": 923,
  "status": "authorized",
  "payment_method": "card",
  "created_at": "2023-07-01T11:50:37Z",
  "card_transaction": {
    "type": "credit",
    "funding_source": "credit",
    "result": "success",
    "transaction_id": "cb42d188-aca6-46f2-a2c9-046cb6342f5d",
    "operation_id": "4d41314b-cb2d-4abe-b594-fd6875726e1b",
    "authorization_code": "ABC416",
    "acquirer_message": "Aprovado",
    "acquirer_return_code": "0000",
    "card": {
      "brand": "Visa",
      "emv_response": "9F0500"
    }
  }
}
```

```json
{
  "error_code": "api_400",
  "details": {
    "message": "Transação Inválida",
    "description": "Headers obrigatórios não foram informados na requisição."
  }
}
```

```Text
{
  "error_code": "unauthorized",
  "details": {
    "message": "Estabelecimento Comercial Não Cadastrado"
  }
}
```

```Text
{
  "error_code": "internal_server_error",
  "details": {
    "message": "Erro no Sistema"
  }
}
```

```Text
{
  "error_code": "acquirer_bad_gateway",
  "details": {
    "message": "Erro de Conexão"
  }
}
```

```Text
{
  "error_code": "acquirer_service_unavailable",
  "details": {
    "message": "Serviço Indisponível"
  }
}
```

```Text
{
  "error_code": "acquirer_timeout",
  "details": {
    "message": "Erro de Conexão"
  }
}
```

---

**Jornada: [Transações de ecommerce](https://devcenter.stone.com.br/legacy-stone-online-digital)**  
Etapa 6 de 15

[**Etapa anterior**Autorização com dados de sublojistas](https://devcenter.stone.com.br/legacy-stone-online-autorizacao-com-dados-de-subadquirente)[**Próxima etapa**Autorização com network token](https://devcenter.stone.com.br/legacy-stone-online-autorizacao-com-dados-de-network-token)

Siga a Stone nas redes sociais

[](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ)

© Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57

Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP

Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.