Skip to main content

​
Visão Geral

Os métodos de pagamento no Güeno 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