Skip to main content

​
Introdução

A API envia webhooks para payin (entrada via PIX) notificando o ciclo completo: criação do PIX, atualizações e conclusão com transferência on-chain. Eventos:
  • crypto.payin.new
  • crypto.payin.updated
  • crypto.payin.completed

​
Estrutura e Campos

  • event: tipo do evento.
  • timestamp: ISO 8601 do envio.
  • payin: { external_id, transaction_id, status }
  • quote: { quote_id, amount_brl, amount_usd, rate, expires_at }
  • pix: { pix_code, txid, status }
  • transfer: { tx_hash, network, status } (a partir de updated; completo em completed)

​
Exemplos de Eventos

​
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": "COMPLETED"
  },
  "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"
  }
}

​
Configuração no Dashboard

  1. Acesse o Dashboard
  2. Vá em “Configurações” > “Webhooks”
  3. Adicione a URL do seu endpoint
  4. Salve as configurações