dynamic deploy environments

.env.example

@@ -0,0 +1,16 @@
+PRIVATE_KEY=0x....
+CLIENT_ID=
+CLIENT_SECRET=
+DEV_APP_KEY=
+DEBUG=false
+ITP_TOKEN_URL = https://oauth.hm.bb.com.br/oauth/token
+# Url de produção com autenticação mTLS.
+#ITP_API_URL="https://api-bbpay.bb.com.br/checkout/v2"
+# Url de homologação com autenticação mTLS.
+ITP_API_URL =  "https://api-bbpay.hm.bb.com.br/checkout/v2"
+# Url de homologação sem autenticação mTLS.
+#ITP_API_URL = "https://api.extranet.hm.bb.com.br/checkout/v2"
+
+# 05/08/2025
+#ITP_API_URL=https://checkout.mtls.api.bb.com.br
+#ITP_API_URL=https://checkout.mtls.api.hm.bb.com.br

.gitignore

@@ -0,0 +1,3 @@
+.env
+*.pem
+venv

README.md

@@ -15,23 +15,25 @@
 Chamado pelo vendedor antes de fazer `deposit` no smart contract.
 
 #### Parametros requeridos:
- - `nomeParticipante`
+ - `chainID`
  - `tipoDocumento`
  - `numeroDocumento`
  - `numeroConta`
  - `tipoConta`
+ - `codigoIspb`
  
 ``` exemplo
 curl --request POST \
   --url http://localhost:5000/register \
   --header 'content-type: application/json' \
   --data '{
-  "nomeParticipante": "João Silva",
+  "chainID": "1337",
   "tipoDocumento": 1,
   "numeroDocumento": 12345678900,
   "numeroConta": 1234567890123456,
   "numeroAgencia": 123,
-  "tipoConta": 1
+  "tipoConta": 1,
+  "codigoIspb": 0
 }'
 ```
 #### Retorna em formato JSON:
@@ -64,13 +66,34 @@ Chamado pelo comprador após pagar o Pix
 curl http://localhost:5000/release/123
 ```
 #### Retorna em formato JSON:
-- `pixTarget`
+- `chainid`-`pixTarget`
 - `amount`: valor em wei
 -  `pixTimestamp`
 -   `signature`: assinatura ethereum compatível
 
+# mTLS
+
+##### `key.pem`: chave privada e certificado da empresa
+Descriptografar o e-CNPJ em formato PKCS#12 e converter em formato PEM (☢️ contém chave privada):
+```
+umask 077; # tirar permissão de leitura global
+openssl pkcs12 -in <arquivo>.p12 -legacy -clcerts -noenc -out key.pem
+```
+
+##### `bb.pem`: certificado do BB
+Descarregar o certificado de https://apoio.developers.bb.com.br/referency/post/646799afa2e2b90012c5ede8 e converter em formato PEM: 
+```
+openssl x509 -in raiz_v3.der -inform DER -outform PEM -out bb.pem
+```
+
+### Envio de certificado 
+Para criar a cadeia de certificados pra enviar pro BB usar:
+```
+openssl pkcs12 -in <arquivo>.p12 -nokeys -legacy -out cert.pem
+```
+enviar o `cert.pem` no formulário do portal developers como "cadeia completa".
+
 # Observações
-- O ambiente de produção requer autenticação mTLS
 - Para ambiente de desenvolvimento use `DEBUG=true`
 - Em produção, o servidor usa Waitress como servidor WSGI
 - Para mais informações, consulte a documentação oficial: https://developers.bb.com.br/

bbpay.py

@@ -4,6 +4,7 @@ from os import getenv
 from oauthlib.oauth2 import BackendApplicationClient
 from requests_oauthlib import OAuth2Session
 from flask import Flask, request
+from flask_cors import CORS
 from flask_restful import Resource, Api
 from eth_abi.packed import encode_packed
 import eth_account
@@ -16,64 +17,59 @@ from eth_utils import to_wei
 load_dotenv()
 
 app = Flask(__name__)
+CORS(app)
 api = Api(app)
 
 class BBPay(Resource):
-    def __init__(self):
-        super().__init__()
-        self.setup_oauth()
-        
     def setup_oauth(self):
         client = BackendApplicationClient(client_id=getenv("CLIENT_ID"))
         self.oauth = OAuth2Session(client=client)
 
-        scope = ['checkout.solicitacoes-requisicao', 
+        self.cert = 'key.pem'
-            'checkout.participantes-requisicao', 
+        self.verify_ssl = 'bb.pem'
-            'checkout.solicitacoes-info', 
+        self.baseUrl = getenv("ITP_API_URL")
-            'checkout.participantes-info']
+        self.token_url = getenv("ITP_TOKEN_URL")
-
-        self.oauth.fetch_token(
-            token_url='https://oauth.hm.bb.com.br/oauth/token',
-            client_id=getenv("CLIENT_ID"),
-            client_secret=getenv("CLIENT_SECRET"), scope=scope,
-            cert='cert.pem')
-
-        # Url de homologação com autenticação mTLS.
-        self.baseUrl = "https://api-bbpay.hm.bb.com.br/checkout/v2"
-
-        # Url de homologação sem autenticação mTLS.
-        #self.baseUrl = "https://api.extranet.hm.bb.com.br/checkout/v2"
-
-        # Url de produção com autenticação mTLS.
-        #self.baseUrl = "https://api-bbpay.bb.com.br/checkout/v2"
-
-        self.verify_ssl = False
 
         self.params = {
             'numeroConvenio': 701,
             'gw-dev-app-key': getenv("DEV_APP_KEY")
         }
 
+        self.scope = ['checkout.solicitacoes-requisicao',
+            'checkout.participantes-requisicao',
+            'checkout.solicitacoes-info',
+            'checkout.participantes-info']
+
+        self.oauth.fetch_token(
+            token_url=self.token_url,
+            client_id=getenv("CLIENT_ID"),
+            client_secret=getenv("CLIENT_SECRET"), scope=self.scope)
+
+    def __init__(self):
+        super().__init__()
+        self.setup_oauth()
+
 class Register(BBPay):
     def post(self):
         data = request.get_json()
-        body = { 
+        body = {
             'numeroConvenio': 701,
-            'nomeParticipante': data['nomeParticipante'],
+            'nomeParticipante': data['chainID'],
             'tipoDocumento': data['tipoDocumento'],
             'numeroDocumento': data['numeroDocumento'],
             'numeroConta': data['numeroConta'],
             'numeroAgencia': data['numeroAgencia'],
             'tipoConta': data['tipoConta'],
             'codigoIspb': data['codigoIspb'] # Código identificador do Sistema de Pagamentos Brasileiro. Atualmente aceitamos apenas Banco do Brasil, codigoIspb igual a 0
-            '
         }
         response = self.oauth.post(
-            self.baseUrl+"/participantes", 
+            self.baseUrl+"/participantes",
-            params=self.params, 
+            params=self.params,
             json=body,
             verify=self.verify_ssl,
-            cert='cert.pem')
+            cert=self.cert)
+        if response.status_code != 201:
+            return 'Upstream error', response.status_code
         return response.json()
 
 class Request(BBPay):
@@ -84,7 +80,8 @@ class Request(BBPay):
                 "numeroConvenio": 701,
                 "pagamentoUnico": True,
                 "descricaoSolicitacao": "P2Pix",
-                "valorSolicitacao": data['amount']
+                "valorSolicitacao": data['amount'],
+                "codigoConciliacaoSolicitacao": data['lockid']
             },
             # "devedor": {
             #     "tipoDocumento": 1,
@@ -93,7 +90,7 @@ class Request(BBPay):
             "formasPagamento": [{ "codigoTipoPagamento": "PIX", "quantidadeParcelas": 1}],
             "repasse": {
                 "tipoValorRepasse": "Percentual",
-                "recebedores": [{ 
+                "recebedores": [{
                     "identificadorRecebedor": data['pixTarget'],
                     "tipoRecebedor": "Participante",
                     "valorRepasse": 100 }]
@@ -103,7 +100,10 @@ class Request(BBPay):
             self.baseUrl+"/solicitacoes",
             params=self.params,
             json=body,
-            verify=self.verify_ssl)
+            verify=self.verify_ssl,
+            cert=self.cert)
+        if response.status_code != 201:
+            return 'Upstream error', response.status_code
         return response.json()
 
 class Release(BBPay):
@@ -111,25 +111,35 @@ class Release(BBPay):
         response = self.oauth.get(
             self.baseUrl+f"/solicitacoes/{numeroSolicitacao}",
             params=self.params,
-            verify=self.verify_ssl)
+            verify=self.verify_ssl,
+            cert=self.cert)
+        if response.status_code != 200:
+            return 'Upstream error', response.status_code
         data = response.json()
         numeroParticipante = data['repasse']['recebedores'][0]['identificadorRecebedor']
-        pixTimestamp = b85decode(data['informacoesPix']['txId'])
+        pixTimestamp = encode_packed(['bytes32'],[b85decode(data['informacoesPix']['txId'])])
         valorSolicitacao = to_wei(data['valorSolicitacao'], 'ether')
         codigoEstadoSolicitacao = data['codigoEstadoSolicitacao']
-        if codigoEstadoSolicitacao != 0:
+        if codigoEstadoSolicitacao != 1:
             return 'Pix not paid', 204
-        packed = encode_packed(['bytes32','uint80','bytes32'], 
+        response = self.oauth.get(
-            (str(numeroParticipante).encode(), int(valorSolicitacao), pixTimestamp) )
+            self.baseUrl+f"/participantes/{numeroParticipante}",
-        
+            params=self.params,
+            verify=self.verify_ssl,
+            cert=self.cert)
+        if response.status_code != 200:
+            return 'Upstream error', response.status_code
+        chainID = response.json()['nomeParticipante']
+        packed = encode_packed(['bytes32','uint80','bytes32'],
+            (f"{chainID}-{numeroParticipante}".encode(), int(valorSolicitacao), pixTimestamp) )
         signable = eth_account.messages.encode_defunct(keccak(packed))
         signature = eth_account.account.Account.sign_message(signable, private_key=getenv('PRIVATE_KEY')).signature.hex()
         return {
-            'pixTarget': str(numeroParticipante),
+            'pixTarget': f"{chainID}-{numeroParticipante}",
             'amount': str(valorSolicitacao),
-            'pixTimestamp': pixTimestamp.hex(),
+            'pixTimestamp': f"0x{pixTimestamp.hex()}",
-            'signature': signature }
+            'signature': f"0x{signature}"
-
+        }
 
 # (CPF, nome, conta) -> participantID
 # should be called before deposit
@@ -137,19 +147,16 @@ api.add_resource(Register, '/register')
 
 # (amount,pixtarget) -> requestID, QRcodeText
 # should be called after lock
-api.add_resource(Request, '/request') 
+api.add_resource(Request, '/request')
 
 # (requestID) -> sig(pixTarget, amount, pixTimestamp)
 # should be called before release
 api.add_resource(Release, '/release/<int:numeroSolicitacao>')
 
-
 if __name__ == '__main__':
     if getenv("DEBUG"):
         disable_warnings()
         app.run(debug=True)
     else:
         from waitress import serve
-        serve(app, host=getenv("HOST","0.0.0.0"), port=getenv("PORT",5000))
+        serve(app, host=getenv("HOST","0.0.0.0"), port=getenv("PORT",5000))
-
-

requirements.txt

@@ -3,6 +3,7 @@ oauthlib
 requests-oauthlib
 flask
 flask-restful
+flask-cors
 eth-abi
 eth-account
 eth-hash[pycryptodome]