---
title: CyberSource
slug: cybersource
docTags: 
createdAt: 2025-05-28T05:13:11.921Z
---

## Objetivo

O conector **CyberSource** permite a integração com o gateway de pagamentos da CyberSource, facilitando operações de consulta de transações e gerenciamento de riscos (como marcação de fraudes). É indicado para fluxos de e-commerce que exigem alto controle e automação em processos financeiros.

## Configurando o conector CyberSource

### 1. Escolher o recurso

Ao configurar o conector, selecione um dos recursos disponíveis:

- **Pesquisa transação** (`transaction-search`)
- **Gerenciamento de riscos** (`risk-management`)

### 2. Escolher a operação

Cada recurso possui operações específicas:

### Recurso: Pesquisa transação

- **Cria solicitação de pesquisa** (`create`): Permite enviar uma consulta para recuperar transações com base em parâmetros informados.

### Recurso: Gerenciamento de riscos

- **Marcação de fraude** (`fraud-marking`): Permite identificar uma transação como fraudulenta (ou removê-la da lista de suspeitas) informando seu ID.

### Parâmetros de entrada

### Pesquisa transação

| Campo | Tipo   | Obrigatório | Descrição                                                 |
| ----- | ------ | ----------- | --------------------------------------------------------- |
| body  | objeto | Sim         | Corpo da requisição, que pode ser `De/Para` ou `Template` |

### Gerenciamento de riscos

| Campo | Tipo   | Obrigatório | Descrição                                                            |
| ----- | ------ | ----------- | -------------------------------------------------------------------- |
| id    | string | Sim         | Identificador da transação a ser marcada ou desmarcada como suspeita |
| body  | objeto | Sim         | Corpo da requisição, que pode ser `De/Para` ou `Template`            |

### Corpo da requisição

| Campo | Tipo   | Obrigatório | Descrição                                              |
| ----- | ------ | ----------- | ------------------------------------------------------ |
| type  | string | Sim         | Tipo do corpo, aceita `template` ou `De/Para`          |
| value | string | Sim         | Conteúdo da requisição no formato definido pelo `type` |

## Comportamento interno

- **Versão da base:** `cybersource@v1`
- **O corpo da requisição** é construído com base na escolha entre `template` ou `depara`
- **A operação e recurso** são passados diretamente na configuração do conector
- Quando aplicável, é necessário informar o `id` da transação

## Testando o fluxo

1. Configure um passo anterior com os dados da transação ou parâmetros de pesquisa.
2. Adicione o conector **CyberSource** e selecione:
   - Recurso: `transaction-search` ou `risk-management`
   - Operação: de acordo com o recurso selecionado
   - Corpo: escolha entre `template` ou `depara`
3. Execute o fluxo.
4. Verifique o retorno do conector conforme a operação executada.

### Exemplo de uso

### Marcação de fraude com corpo em template

```json
{
  "resource": {
    "value": "risk-management",
    "operation": {
      "value": "fraud-marking",
      "id": "cbf9a85d-d4d3-11ee-9f92-9f10e53f5ad7",
      "body": {
        "type": "template",
        "value": "{ \"markingAction\": \"addToList\" }"
      }
    }
  }
}
```