Skip to main content

​
Visão Geral

Receba notificações do fluxo de payin (PIX) com três eventos: crypto.payin.new, crypto.payin.updated e crypto.payin.completed.

​
Exemplos

​
crypto.payin.new

{
  "event": "crypto.payin.new",
  "timestamp": "2025-12-12T12:59:30.737Z",
  "payin": {
    "external_id": "pi_nGM1ETJIVXKF",
    "transaction_id": 84,
    "status": "processing"
  },
  "quote": {
    "quote_id": 278,
    "amount_brl": 63.64,
    "amount_usd": 11.09,
    "rate": 5.4101,
    "expires_at": "2025-12-12T13:04:14.658Z"
  },
  "pix": {
    "pix_code": "00020101021226790014br.gov.bcb.pix2557brcode.starkinfra.com/v2/7b2f40d6166a4f339613bb568d00992d5204000053039865802BR5915Blind Pay, Inc.6010Vila Velha62070503***63044C6B",
    "txid": "7b2f40d6166a4f339613bb568d00992d",
    "status": "processing"
  }
}

​
crypto.payin.updated

{
  "event": "crypto.payin.updated",
  "timestamp": "2025-12-12T13:00:54.440Z",
  "payin": {
    "external_id": "pi_nGM1ETJIVXKF",
    "transaction_id": 84,
    "status": "processing"
  },
  "quote": {
    "quote_id": 278,
    "amount_brl": 63.64,
    "amount_usd": 11.09,
    "rate": 5.4101,
    "expires_at": "2025-12-12T13:04:14.658Z"
  },
  "pix": {
    "pix_code": "00020101021226790014br.gov.bcb.pix2557brcode.starkinfra.com/v2/7b2f40d6166a4f339613bb568d00992d5204000053039865802BR5915Blind Pay, Inc.6010Vila Velha62070503***63044C6B",
    "txid": "7b2f40d6166a4f339613bb568d00992d",
    "status": "processing"
  },
  "transfer": {
    "tx_hash": null,
    "network": null,
    "status": "processing"
  }
}

​
crypto.payin.completed

{
  "event": "crypto.payin.completed",
  "timestamp": "2025-12-12T13:01:00.289Z",
  "payin": {
    "external_id": "pi_nGM1ETJIVXKF",
    "transaction_id": 84,
    "status": "COMPLETED"
  },
  "quote": {
    "quote_id": 278,
    "amount_brl": 63.64,
    "amount_usd": 11.09,
    "rate": 5.4101,
    "expires_at": "2025-12-12T13:04:14.658Z"
  },
  "pix": {
    "pix_code": "00020101021226790014br.gov.bcb.pix2557brcode.starkinfra.com/v2/7b2f40d6166a4f339613bb568d00992d5204000053039865802BR5915Blind Pay, Inc.6010Vila Velha62070503***63044C6B",
    "txid": "7b2f40d6166a4f339613bb568d00992d",
    "status": "COMPLETED"
  },
  "transfer": {
    "tx_hash": "0xba66b09814eddc93f037e09177be6b551d63dbc052ecce6bf161d09e07841388",
    "network": null,
    "status": "completed"
  }
}

​
Resposta Esperada

Sua aplicação deve responder com status 200 OK para indicar que o webhook foi processado com sucesso. Se não recebermos uma resposta 200 dentro de 30 segundos, tentaremos reenviar o webhook.

​
Tentativas de Reenvio

  • Primeira tentativa: Imediatamente após o evento
  • Segunda tentativa: 5 segundos depois
  • Terceira tentativa: 15 segundos depois
  • Quarta tentativa: 25 segundos depois
Após 4 tentativas sem sucesso, o webhook será descartado.