# GenialBankHTTPService – Documentação de Endpoints

---

## 1. Autenticação – `getCredentials`

**POST**
`https://genial-arquitetura-authentication.homolog.api.genial.systems/v1/authentication`

**Request**

```json
{
  "headers": {
    "Authorization": "Bearer <TOKEN>",
    "X-ORIGEM": "APP"
  }
}
```

**Response**

```json
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
```

---

## 2. Consultar Saldo – `getBalance`

**GET**
`https://genial-arquitetura-corebank.homolog.api.genial.systems/v1/core-banking/balance/1/{accountNumber}`

**Headers**

```json
{
  "Authorization": "Bearer <TOKEN>",
  "X-ORIGEM": "APP"
}
```

**Response**

```json
{
  "data": "2025-10-31T15:45:00Z",
  "saldoDisponivel": 12500.75,
  "saldoDisponivelParaMovimentacao": 12400.75,
  "saldoVinculado": 50.00,
  "saldoBloqueado": 0.00,
  "saldoContabil": 12550.75,
  "saldoInvestimento": 2000.00,
  "saldoAuxilioEmergencial": 0.00,
  "limiteCreditoDisponivel": 5000.00,
  "limiteCreditoContratado": 10000.00
}
```

---

## 3. Consultar Chave Pix – `getDictKey`

**POST**
`https://gerador-arquitetura-baas.homolog.api.genial.systems/v2/pix/key-account-partner/1/{accountNumber}/{pixKey}`

**Headers**

```json
{
  "Authorization": "Bearer <TOKEN>",
  "X-ORIGEM": "APP"
}
```

**Response**

```json
{
  "key": "gustavo.silva@empresa.com",
  "keyType": "EMAIL",
  "idPixKey": "5f9a8d27-1c3b-4b8f-bcc1-7d231f0a1234",
  "pspIdentification": "GENIALBANKBRSPXXX",
  "accountHolder": {
    "taxId": "12345678909",
    "name": "Gustavo Silva"
  },
  "status": "ACTIVE",
  "creationDate": "2025-10-31T14:25:32Z",
  "updateDate": "2025-10-31T14:25:32Z",
  "keyLocallyActive": "true",
  "endToEndId": "E1234567820231031142532000000001"
}
```

---

## 4. Status de Envio Pix (PAC008) – `getPixPaymentStatusOutByInstantPaymentId`

**GET**
`https://genial-baas-operations.homolog.api.genial.systems/v1/cashout/pix-send/instant-payment-id/{instantPaymentId}?date={yyyy-mm-dd}`

**Headers**

```json
{
  "Authorization": "Bearer <TOKEN>",
  "X-ORIGEM": "APP"
}
```

**Response**

```json
{
  "pixSendRequest": {
    "debit": {
      "name": "Gustavo Silva",
      "agency": 1,
      "account": "123456",
      "accountType": "CHECKING",
      "document": "12345678909"
    },
    "credit": {
      "name": "Maria Oliveira",
      "agency": 1,
      "account": "654321",
      "accountType": "CHECKING",
      "document": "98765432100",
      "ispb": "12345678",
      "key": "maria.oliveira@banco.com",
      "endToEndId": "E1234567820251031143000000009876"
    },
    "idempotencyId": "IDE123456789",
    "value": 150.75,
    "transactionApproved": true
  },
  "statusResponse": {
    "value": 150.75,
    "eventStatus": {
      "code": "200",
      "description": "Pagamento confirmado"
    },
    "endToEndId": "E1234567820251031143000000009876"
  },
  "id": "STAT-PIXOUT-00012345",
  "createDate": "2025-10-31T15:00:00Z",
  "updateDate": "2025-10-31T15:00:02Z"
}
```

---

## 5. Pagamento via QR Code (PAC008) – `pac008Qr`

**POST**
`https://gerador-arquitetura-baas.homolog.api.genial.systems/v1/pix/copy-paste`

**Body**

```json
{
  "qrCodeCopyPaste": "0002012658...",
  "Value": 150.75,
  "debit": {
    "name": "Gustavo Silva",
    "agency": 1,
    "account": "123456",
    "accountType": "CHECKING"
  }
}
```

**Response**

```json
{
  "data": {
    "value": 150.75,
    "instantPaymentId": "PIX-OUT-XYZ123456",
    "eventStatus": {
      "code": "200",
      "description": "Pagamento efetuado com sucesso"
    }
  },
  "error": ""
}
```

---

## 6. Iniciar Pagamento via Chave (PAC008 Start)

**POST**
`https://gerador-arquitetura-baas.homolog.api.genial.systems/v1/pix/send/initialization`

**Body**

```json
{
  "debit": {
    "name": "Gustavo Silva",
    "agency": 1,
    "account": "123456"
  },
  "credit": {
    "key": "maria.oliveira@banco.com"
  },
  "value": "200.50"
}
```

**Response**

```json
{
  "data": {
    "key": "maria.oliveira@banco.com",
    "keyType": "EMAIL",
    "pspIdentification": "GENIALBANKBRSPXXX",
    "accountHolder": {
      "taxId": "98765432100",
      "name": "Maria Oliveira"
    },
    "status": "ACTIVE",
    "endToEndId": "E1234567820251031142532000000001",
    "idempotencyId": "IDEMP-PIX-0001"
  },
  "error": ""
}
```

---

## 7. Efetivar Pagamento via Chave (PAC008)

**POST**
`https://gerador-arquitetura-baas.homolog.api.genial.systems/v1/pix/send/payment`

**Body**

```json
{
  "idempotencyId": "IDEMP-PIX-0001",
  "ignorePaymentDuplication": false,
  "additionalInformation": "Pagamento de serviço",
  "historicComplement": "Ref#1234"
}
```

**Response**

```json
{
  "data": {
    "instantPaymentId": "PIX-OUT-XYZ123456",
    "eventStatus": {
      "code": "200",
      "description": "Pagamento concluído"
    },
    "transactionPurpose": "PAYMENT"
  },
  "error": ""
}
```

---

## 8. Status de Recebimento Pix (PAC002) – `getPixPaymentStatusInByTransactionId`

**GET**
`https://genial-baas-operations.homolog.api.genial.systems/v1/cashin/receiver-reconciliation/{transactionId}`

**Response**

```json
{
  "instantPaymentId": "a4f3c2d1-5678-4bcd-8901-123456789abc",
  "endToEndId": "E1234567820251031143000000001234",
  "value": 1250.75,
  "receiver": {
    "taxId": "12345678909",
    "addressKey": "gustavo.silva@empresa.com"
  },
  "payer": {
    "taxId": "09876543210",
    "name": "Maria Oliveira"
  },
  "eventStatus": {
    "code": 200,
    "description": "Liquidado com sucesso"
  }
}
```

---

## 9. Criar QR Code Dinâmico (PAC002) – `postCreateDynamicQrcode`

**POST**
`https://gerador-arquitetura-baas.homolog.api.genial.systems/v2/qrcode/dynamic?agency=1&account={accountNumber}`

**Body**

```json
{
  "items": [
    {
      "addressingKey": {
        "key": "gustavo.evp.1234567890",
        "type": "EVP"
      },
      "accountHolderName": "Gustavo Silva",
      "accountHolderCity": "São Paulo",
      "dynamicQRCodeType": "IMMEDIATE",
      "immediate": {
        "expiration": 3600,
        "paymentValue": {
          "documentValue": 99.9,
          "showPaymentValueInQrCode": true
        },
        "payerInformation": {
          "cpfCnpj": "09876543210",
          "name": "Maria Oliveira",
          "validatePayerInformation": true
        },
        "receiverInformation": {
          "taxId": "12345678909",
          "name": "Gustavo Silva",
          "tradeName": "GSoluções LTDA"
        }
      },
      "payerRequestInformation": "Serviço prestado em 31/10/2025"
    }
  ]
}
```

**Response**

```json
{
  "data": {
    "items": [
      {
        "itemId": "QR-ITEM-001",
        "data": {
          "textContent": "0002012658...",
          "reference": "PIX202510311530",
          "qrcodeURL": "https://gerador-arquitetura-baas.homolog.api.genial.systems/pix/qrcode/PIX202510311530.png"
        },
        "error": ""
      }
    ]
  }
}
```

---

## 10. Devolução de Pagamento (PAC004) – `postPac004`

**POST**
`https://gerador-arquitetura-baas.homolog.api.genial.systems/v1/pix/return`

**Body**

```json
{
  "value": 50.0,
  "returnReasonCode": "MD06",
  "eventId": "E1234567820251031143000000009876",
  "additionalInformation": "Cliente solicitou estorno",
  "historicComplement": "Devolução parcial"
}
```

**Response**

```json
{
  "data": {
    "returnId": "RET-PIX-0001",
    "creationDateTime": "2025-10-31T15:40:00Z",
    "originalInstantPaymentId": "PIX-OUT-XYZ123456",
    "returnedAmount": 50.0
  },
  "error": ""
}
```

---

## 11. Preview de Pagamento (BOLETO) – `getPaymentPreview`

**POST**
`https://gerador-arquitetura-baas.homolog.api.genial.systems/v1/payments/preview`

**Body**

```json
{
  "emv": "34191750090001088600609301000001151670000016300"
}
```

**Response**

```json
[
  {
    "amount": 163.0,
    "type": "boleto-payment",
    "due": "2025-11-05",
    "taxId": "12345678909"
  }
]
```

---

## 12. Pagamento de Boleto – `postPaymentsBoleto`

**POST**
`https://gerador-arquitetura-baas.homolog.api.genial.systems/v1/payments/boleto`

**Body**

```json
{
  "taxId": "12345678909",
  "description": "Pagamento de boleto",
  "line": "34191750090001088600609301000001151670000016300",
  "uuid": "BOLETO123"
}
```

**Response**

```json
[
  {
    "status": "success",
    "paymentId": "BOL-20251031-0001"
  }
]
```

---

## 13. Consultar Pagamento de Boleto – `getPaymentsBoletoByid`

**GET**
`https://gerador-arquitetura-baas.homolog.api.genial.systems/v1/payments/boleto/{id}`

**Response**

```json
{
  "id": "BOL-20251031-0001",
  "amount": 163.0,
  "status": "PAID",
  "paidDate": "2025-10-31T17:10:00Z"
}
```

---

Deseja que eu agora gere essa mesma documentação em formato `.md` (pronto para salvar como `README.md`)?