> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão Geral de Métodos de Pagamento

> Gerencie métodos de pagamento como entidades de primeiro nível no gu1: cartões, contas, uso e regras de fraude e compliance associadas.

## Visão Geral

Os métodos de pagamento no Gu1 são representados como **entidades** do tipo `payment_method`. Isso permite rastrear cartões de crédito, contas bancárias, carteiras e outros instrumentos de pagamento associados a pessoas ou empresas.

<Info>
  Os métodos de pagamento são criados usando o endpoint universal `/entities` com `entityType: "payment_method"`.
</Info>

## O que é uma Entidade de Método de Pagamento?

Uma entidade de método de pagamento representa qualquer instrumento financeiro usado para transações:

* **Cartões de Crédito** - Visa, Mastercard, Amex, etc.
* **Cartões de Débito** - Cartões de débito emitidos por bancos
* **Contas Bancárias** - Contas correntes, contas poupança
* **Carteiras Digitais** - PayPal, Apple Pay, Google Pay, etc.
* **Carteiras de Criptomoedas** - Endereços Bitcoin, Ethereum

## Características Principais

### Relacionamentos de Entidades

Os métodos de pagamento podem ser vinculados a outras entidades:

* **Propriedade de** - Link para o proprietário pessoa ou empresa
* **Usado em** - Link para transações onde este método de pagamento foi usado
* **Associado com** - Link para dispositivos usados para transações

### Análise de Risco

Os métodos de pagamento podem ser analisados para detecção de fraude:

* Monitoramento de velocidade de transações
* Detecção de anomalias geográficas
* Correlação de impressão digital de dispositivo
* Padrões históricos de uso

## Estrutura de Dados

As entidades de métodos de pagamento contêm:

```json theme={null}
{
  "entityType": "payment_method",
  "entityData": {
    "paymentMethod": {
      "type": "credit_card",
      "last4": "4242",
      "brand": "visa",
      "expiryMonth": "12",
      "expiryYear": "2025",
      "holderName": "John Doe",
      "issuerCountry": "BR",
      "bin": "424242",
      "fingerprint": "abc123xyz",
      "funding": "credit",
      "network": "visa"
    }
  },
  "relationships": [
    {
      "targetEntityId": "person-uuid-123",
      "relationshipType": "owns",
      "strength": 1.0
    }
  ]
}
```

## Tipos de Métodos de Pagamento

### Cartão de Crédito

```json theme={null}
{
  "type": "credit_card",
  "brand": "visa",
  "last4": "4242",
  "expiryMonth": "12",
  "expiryYear": "2025",
  "holderName": "John Doe",
  "issuerCountry": "BR",
  "bin": "424242",
  "funding": "credit"
}
```

### Conta Bancária

```json theme={null}
{
  "type": "bank_account",
  "accountNumber": "12345-6",
  "accountType": "checking",
  "bank": "Banco do Brasil",
  "currency": "BRL",
  "routingNumber": "001"
}
```

### Carteira Digital

```json theme={null}
{
  "type": "digital_wallet",
  "provider": "paypal",
  "email": "user@example.com",
  "accountId": "paypal-12345"
}
```

## Endpoints da API

As entidades de métodos de pagamento usam os endpoints padrão de entidades:

* [Criar Método de Pagamento](/pt/api-reference/payment-methods/create)
* [Obter Método de Pagamento](/pt/api-reference/payment-methods/get)
* [Atualizar Método de Pagamento](/pt/api-reference/payment-methods/update)
* [Listar Métodos de Pagamento](/pt/api-reference/payment-methods/list)
* [Analisar Método de Pagamento](/en/api-reference/entities/analyze)

## Veja Também

* [Referência de Tipos de Entidades](/en/api-reference/entities/entity-types)
* [Relacionamentos de Entidades](/pt/api-reference/entities/materialize-relationships)
* [Monitoramento de Transações](/pt/use-cases/transaction-monitoring/overview)