Webhooks

Configure a webhook URL in your tenant settings to receive real-time notifications for banking events.

Webhook Endpoint

Your application must expose an HTTP endpoint to receive POST requests from Axia.

Event Types

Event	Description
pix-payment-in	Incoming PIX payment received
pix-payment-out	Outgoing PIX payment confirmed
pix-reversal-in	Incoming PIX reversal received
pix-reversal-out	Outgoing PIX reversal confirmed
onboarding-create	Account onboarding status change
crypto-cash-in	Onchain crypto deposit received

Webhook Payload Format

{
  "accountId": "30054029183",
  "eventType": "pix-payment-in",
  "eventData": {
    "transactionId": "E384040820262603101234567890",
    "endToEndId": "E384040820262603101234567890",
    "amount": 150.00,
    "creditParty": {
      "name": "João da Silva",
      "taxId": "48059890093"
    },
    "debitParty": {
      "name": "Maria Souza",
      "taxId": "12345678901"
    }
  }
}

Onboarding Webhook

{
  "accountId": "",
  "eventType": "onboarding-create",
  "eventData": {
    "status": "CONFIRMED",
    "documentNumber": "48059890093",
    "accountId": "30054029183"
  }
}

Onboarding Status	Description
PROCESSING	KYC verification in progress
CONFIRMED	Account created successfully
ERROR	Account creation failed

Crypto Webhook (crypto-cash-in)

Sent when a tenant wallet receives an onchain deposit. accountId is the receiving wallet address; txId is the onchain transaction hash — use it for idempotency. The amount is a decimal string (full onchain precision).

{
  "accountId": "0x1122334455667788990011223344556677889900",
  "eventType": "crypto-cash-in",
  "eventData": {
    "address": "0x1122334455667788990011223344556677889900",
    "amount": "1000.00",
    "asset": "USDT",
    "txId": "0xdeadbeef...",
    "chain": "polygon-mainnet",
    "network": "EVM",
    "walletId": "a1b2c3d4-0000-0000-0000-000000000000",
    "type": "token"
  }
}

Field	Description
address	Receiving wallet address
amount	Deposited amount (decimal string, full precision)
asset	Asset symbol (e.g. USDT, MATIC)
txId	Onchain transaction hash — use for idempotency
chain	Provider chain id (e.g. polygon-mainnet)
network	Chain family (EVM | BTC | TRON | SOLANA | XRPL)
walletId	Wallet identifier in the registry
type	native | token

Security

• Webhooks are sent with Basic Authentication headers
• Your endpoint should validate the credentials
• Respond with HTTP 200 to acknowledge receipt
• Failed deliveries will be retried

---