🔗
A criação do Pix-cob, é realizada na rota POST /v1/charges/

Pix-cob

Pix cobrança imediata.

Esse tipo de Pix permite gerar um Código/Qr Code com rápida expiração. Frequentemente utilizado em situações em que há a necessidade de pagamento imediato.

Através do parâmetro expires é possível configurar um tempo de expiração em segundos, permitindo assim um vencimento estendido desde minutos até horas.

Criar Pix-cob

Abaixo um exemplo de requisição e resposta

{
  "amount": 100,
  "order_id": "BR0000-76915789",
  "order_info": "charge description",
  "currency": "BRL",
  "type": "PAYMENT",
  "payments": [
    {
      "payment_method": "pix-cob",
      "amount": 100,
      "pix": {
        "expires": 60
      }
    }
  ],
  "customer": {
    "name": "Kristi Denesik",
    "email": "[email protected]",
    "phone": "5511985270748",
    "birth_date": "2000-01-01",
    "document_type": "CPF",
    "document_number": "62286843023"
  }
}

{
  "uuid": "be6af256-5ead-440b-8b88-f35ddd73cf75",
  "type": "PAYMENT",
  "expiry_date": "2025-03-24T02:59:59Z",
  "status": "DUE",
  "order_id": "BR0000-23321794",
  "order_info": "charge description",
  "currency": "BRL",
  "original_amount": 100,
  "amount": 100,
  "paid": 0,
  "due": 100,
  "refunded": 0,
  "attempts": 1,
  "max_attempts": 5,
  "drop_reason": "",
  "surcharge": false,
  "client_ip": null,
  "soft_descriptor": null,
  "customer": {
    "uuid": "2e7e8f84-d04a-44be-8d03-080381b3c5f9",
    "name": "Betty Kutch",
    "email": "[email protected]",
    "birth_date": "2000-01-01",
    "phone": "5511985270748",
    "mobile_phone": null,
    "document_type": "CPF",
    "document_number": "622******23",
    "created_at": "2025-03-21T12:36:00Z",
    "updated_at": "2025-03-21T12:36:00Z"
  },
  "transactions": [
    {
      "uuid": "d8630166-79c0-41e6-8098-f0b0dd557362",
      "charge_uuid": "be6af256-5ead-440b-8b88-f35ddd73cf75",
      "gateway_id": "df309129-fdea-4b9e-b752-3b160a4e3b97",
      "amount": 100,
      "paid_amount": 0,
      "status": "WAITING_PAYMENT",
      "payment_option": "PIX",
      "payment_option_detail": "pix-cob",
      "scheme": "PIX",
      "external_id": null,
      "transaction_id_reference": null,
      "expected_capture_date": "2025-03-21T13:06:02Z",
      "payment_at": null,
      "captured_at": null,
      "auth_num": null,
      "auth_response_code": null,
      "operation_type": "DEBIT",
      "extra": "iVBORw0KGgoAAAANSUhEUgAAAM8AAADPAQAAAAB6+rjyAAAEAElEQVR4nO2YQa6rSAxFjWrALNkAUm2jZrUlsoEkbIBsqWZsA6k2ADMGCPdxkvd/q6WWus30R1GUcBAFLvteO6L/9jrkD/qvaBG5y96noKWTrK+prlsnEt1o1b0XaUp9Td1Fgk5ySd1DT6DS9UmHKRxcP0HrIV3fnkJ3keu09zk82/ja5ut0GqVw5J0TeN2m8CQ4Z5DuD9VnDq8trqUO29xM+69AOdBi1+/+8f61lQ70fu2XHLXElYNJXyX+Ldn+Nzpkvie5pzioNFrXoiPnlxMo1aclgI58aXUlRcmx1o/WMl+5fpabEgdL1D7tjfrRIjpod8lkJo+wPza5sGI5gZJV0KAW1Zd2j20mwjr50dHGoYSR2snxyHW0/VLd4gnUNSp2z6yb65NnmerPWh60JIrRcnKUmTgs2R6hT9GN1vc2PXMdJrmV/TFFwrJ8EsCHtnC0HEcxELQwmqwhm9GPdL/xXevS7vc8P/i57dcTaEl1sSNy4RP5Tbu08+2Toi50ZKKKL3TNhARxppWAJYMbJd52z0jHOuEOpNMuyY8W9l3CIt21UODkEoW5N5+M8iHTjTi2uMMuEl4a+LlO0Y9ayrC7FWIizdThO5Itr9zokLpIHTOphTUQE3QS1z6BWraeg/UjbiIERK7qR0uKi4Rhwx0oovoqVTdqyo+OLGz3a0KLpNnYLJwRrVM3UqWo5+uGccd3/lNErB7dyHRj626K/CIg820izl2fTyC78vxupcxhm42TWdSPiGpj20QuiZCoVlaERd3I0skKk4OExQpz2IIWP1oLXRl+zc8w6DedluRHiORr4yA5wO6bAl+38LEbL0Ibd3xBUj3aMLZUECtGN1pLQMruFgd56HyhjRSU049o4x8TG7ST8E/WSpwW1k/P5kNW4MiFdaSjbR/5WY9PRrnQancu1oFT4IWACGv9OKwHWSSxG9wfQ0zWLV9S/TisDy0Zj2YU6h7F+uSLSfr+qUofMsm17nHuM6MHQeZ793FYH1pa9quOEql3Ps1hcZzsR4RUrRdFN7AbgoP22sa50bqJZOJJg8c9U6EzjvMtWBciow6KyOYgLBuHZejo7m10o3dbguQSDdp4+sa6WD/vR7TueJb1jcpm0ejqk7Fr8yO0l86WkBIQRcwJr35nIh9CbxceP+20yk9B2QgOLnYCWYbr2M59MncQa275Et2IF9t0vI11tYnyHeqv9noQk+9ji89sq9jYqwj7z+zgQu//N2hRArPGqtZXrJYM6kf2dwRTBvpjky/ZPlrfcgrRVDD9Xd6SS3bRjg5fu/EiPHGaJWM09pcOXW5T1I9shNGhWBtwtY7lbQ2tH9l+TdiBMBD1baBFEWtUohv5/oL7g36jvwDuBgBCOecw+QAAAABJRU5ErkJggg==",
      "payment_number": "00020101021226770014BR.GOV.BCB.PIX2555api.itau/pix/qr/v2/ba724425-9617-4fbf-83a8-675919f4f6f25204000053039865802BR5912LYRA COLLECT6009SAO PAULO62070503***63048147",
      "payer_info": null,
      "expiry_month": null,
      "expiry_year": null,
      "acquirer_network": null,
      "nsu": null,
      "tid": "df309129fdea4b9eb7523b160a4e3b97",
      "token": null,
      "create_token": false,
      "detailed_status": null,
      "currency": "BRL",
      "document_type": "CPF",
      "document_number": "622******23",
      "installments": 0,
      "sub_acquirer": 1001,
      "auth_3ds": null,
      "created_at": "2025-03-21T12:36:03Z",
      "updated_at": "2025-03-21T12:36:03Z"
    }
  ],
  "created_at": "2025-03-21T12:36:00Z",
  "updated_at": "2025-03-21T12:36:00Z"
}

📘
Para mais detalhes, verifique na seção a seguir exemplos de requisição para criar Pix-cob e Pix-cobv: Criar Venda

QRCode e código Copia/Cola

Os QRCode e o código copia/cola são retornados via api através do campo transactions.extra e transactions.payment_number

🚧
O QRCode é codificado em base64
Em nossa API, retornamos o QRCode codificado em Base64, portanto é necessário que o converta para imagem caso o intuito seja exibi-lo para leitura em seu e-commerce.