> ## 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.

# Obter Método de Pagamento

> Recuperar uma entidade de método de pagamento por ID — no modelo de entidades gu1 para cartões, contas e carteiras, com exemplos para get.

## Visão Geral

Recupera informações detalhadas sobre uma entidade de método de pagamento específica incluindo seus dados, relacionamentos e metadados.

## Endpoint

```
GET http://api.gu1.ai/entities/{id}
```

## Autenticação

Requer uma chave API válida no cabeçalho de Autorização:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Parâmetros de Rota

<ParamField path="id" type="string" required>
  UUID da entidade de método de pagamento a recuperar
</ParamField>

## Exemplos de Requisições

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "http://api.gu1.ai/entities/payment-method-uuid-123" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'http://api.gu1.ai/entities/payment-method-uuid-123',
    {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    }
  );

  const paymentMethod = await response.json();
  console.log(paymentMethod.entityData.paymentMethod);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'http://api.gu1.ai/entities/payment-method-uuid-123',
      headers={
          'Authorization': 'Bearer YOUR_API_KEY'
      }
  )

  payment_method = response.json()
  print(payment_method['entityData']['paymentMethod'])
  ```
</CodeGroup>

## Resposta

<ResponseField name="success" type="boolean">
  Se a requisição foi bem-sucedida
</ResponseField>

<ResponseField name="id" type="string">
  UUID da entidade de método de pagamento
</ResponseField>

<ResponseField name="entityType" type="string">
  Sempre `"payment_method"`
</ResponseField>

<ResponseField name="entityData" type="object">
  Dados do método de pagamento
</ResponseField>

<ResponseField name="relationships" type="array">
  Array de relacionamentos com outras entidades
</ResponseField>

<ResponseField name="riskScore" type="number">
  Pontuação de risco calculada (se analisado)
</ResponseField>

<ResponseField name="createdAt" type="string">
  Timestamp ISO 8601 da criação
</ResponseField>

## Exemplo de Resposta

```json theme={null}
{
  "success": true,
  "id": "payment-method-uuid-123",
  "entityType": "payment_method",
  "entityData": {
    "paymentMethod": {
      "type": "credit_card",
      "last4": "4242",
      "brand": "visa",
      "expiryMonth": "12",
      "expiryYear": "2025",
      "holderName": "John Doe",
      "issuerCountry": "BR",
      "bin": "424242",
      "funding": "credit"
    }
  },
  "relationships": [
    {
      "targetEntityId": "person-uuid-123",
      "relationshipType": "owns",
      "strength": 1.0
    }
  ],
  "riskScore": 15,
  "createdAt": "2024-01-15T10:00:00.000Z"
}
```

## Veja Também

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