genial-cli

GenialBankHTTPService – Documentação de Endpoints

---

1. Autenticação – getCredentials

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

Request

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

Response

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

---

2. Consultar Saldo – getBalance

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

Headers

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

Response

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

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

Response

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

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

Response

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

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

Response

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

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

Response

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

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

Response

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

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

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

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

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

Response

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

{
  "emv": "34191750090001088600609301000001151670000016300"
}

Response

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

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

Response

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

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