Visão Geral de Métodos de Pagamento

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.

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

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:

{
  "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

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

Conta Bancária

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

Carteira Digital

{
  "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:

Veja Também

Resumo de Execução de Regras Criar Método de Pagamento

⌘I

Começando

SDK

Casos de Uso

Webhooks

Workflows

Monitoramento (entidades)

Pessoa

Mensagens

Empresa

Dispositivos

Eventos

Conheça Seu Cliente (KYC)

Transações

Métodos de Pagamento

Regras

Listas de dados

Matriz de Risco

Alertas

Investigações

Ingestão de Dados

Importações em lote

Enriquecimento

Serviços

Integrações

Tutoriais Interativos

Visão Geral de Métodos de Pagamento

Visão Geral

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

Características Principais

Relacionamentos de Entidades

Análise de Risco

Estrutura de Dados

Tipos de Métodos de Pagamento

Cartão de Crédito

Conta Bancária

Carteira Digital

Endpoints da API

Veja Também

​Visão Geral

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

​Características Principais

​Relacionamentos de Entidades

​Análise de Risco

​Estrutura de Dados

​Tipos de Métodos de Pagamento

​Cartão de Crédito

​Conta Bancária

​Carteira Digital

​Endpoints da API

​Veja Também

Visão Geral

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

Características Principais

Relacionamentos de Entidades

Análise de Risco

Estrutura de Dados

Tipos de Métodos de Pagamento

Cartão de Crédito

Conta Bancária

Carteira Digital

Endpoints da API

Veja Também