Webhooks

Installation

You need provide webhook URI for Test and Production environment to integration team to start receive webhooks.

Retry policy

If a webhook delivery fails, all subsequent events in the queue are halted. The system will attempt to resend the failed (stuck) event every 15 minutes until successful delivery is achieved. Once the initially failed event is successfully delivered, the system will resume processing the remaining events in the queue in the order they were received.

This policy ensures each event is delivered sequentially and reliably.

Available webhooks events

CardNewWebhook

{
  "company_id": "string",
  "card_id": "string",
  "user_id": "string",
  "user_email": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "card_accounts_balance": 0,
  "card_reference_currency": "string",
  "linked_card_accounts": [
    {
      "card_id": "string",
      "account_id": "string",
      "currency": "string",
      "status": "string",
      "balance": {
        "amount": 0,
        "available_amount": 0
      },
      "priority": 0
    }
  ],
  "status": "Requested",
  "reason": "string",
  "previous_status": "Requested",
  "pan_last": "string",
  "pan_first": "string",
  "expiry_date": "2019-08-24T14:15:22Z",
  "card_format": "Plastic",
  "design": "string",
  "payment_system": "Visa",
  "card_holder_name": "string",
  "billing_currency_name": "string",
  "correlation_id": "string",
  "residence_country": "string",
  "order_info": "string",
  "billing_account_id": "string"
}

CardChangesWebhook

{
  "company_id": "string",
  "card_id": "string",
  "user_id": "string",
  "user_email": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "card_accounts_balance": 0,
  "card_reference_currency": "string",
  "linked_card_accounts": [
    {
      "card_id": "string",
      "account_id": "string",
      "currency": "string",
      "status": "string",
      "balance": {
        "amount": 0,
        "available_amount": 0
      },
      "priority": 0
    }
  ],
  "status": "Requested",
  "reason": "string",
  "previous_status": "Requested",
  "pan_last": "string",
  "pan_first": "string",
  "expiry_date": "2019-08-24T14:15:22Z",
  "card_format": "Plastic",
  "design": "string",
  "payment_system": "Visa",
  "card_holder_name": "string",
  "billing_currency_name": "string",
  "correlation_id": "string",
  "residence_country": "string",
  "order_info": "string",
  "billing_account_id": "string"
}

CardTransactionUpdateWebhook

{
  "user_id": "string",
  "id": "string",
  "amount": 0,
  "fee": 0,
  "currency": "string",
  "type": "Sepa",
  "direction": "Undirected",
  "transaction_status": "Pending",
  "transaction_failed_reason": "string",
  "source": {
    "type": "WirexAccount",
    "user_id": "string",
    "id": "string"
  },
  "destination": {
    "type": "WirexAccount",
    "user_id": "string",
    "id": "string"
  },
  "comment": "string",
  "transaction_details": {
    "card_id": "string",
    "related_transaction_id": "string",
    "extra_hold": {
      "amount": 0,
      "currency": "string"
    },
    "local_amount": {
      "amount": 0,
      "currency": "string"
    },
    "transaction_operations": [
      {
        "amount": 0,
        "account_id": "string",
        "currency": "string",
        "reason": "Authorization",
        "type": "Debit",
        "processed_at": "2019-08-24T14:15:22Z"
      }
    ]
  },
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}

CardTransactionNewWebhook

{
  "user_id": "string",
  "id": "string",
  "amount": 0,
  "fee": 0,
  "currency": "string",
  "type": "Sepa",
  "direction": "Undirected",
  "transaction_status": "Pending",
  "transaction_failed_reason": "string",
  "source": {
    "type": "WirexAccount",
    "user_id": "string",
    "id": "string"
  },
  "destination": {
    "type": "WirexAccount",
    "user_id": "string",
    "id": "string"
  },
  "comment": "string",
  "transaction_details": {
    "card_id": "string",
    "related_transaction_id": "string",
    "extra_hold": {
      "amount": 0,
      "currency": "string"
    },
    "local_amount": {
      "amount": 0,
      "currency": "string"
    },
    "transaction_operations": [
      {
        "amount": 0,
        "account_id": "string",
        "currency": "string",
        "reason": "Authorization",
        "type": "Debit",
        "processed_at": "2019-08-24T14:15:22Z"
      }
    ]
  },
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}

UserChangesWebhook

{
  "id": "string",
  "personal_details": {
    "residence_address": {
      "line1": "string",
      "line2": "string",
      "city": "string",
      "state": "string",
      "country": "string",
      "postal_code": "string"
    },
    "email": "string",
    "phone_number": "string",
    "first_name": "string",
    "last_name": "string",
    "date_of_birth": "2019-08-24",
    "email_data": {
      "email": "string",
      "is_confirmed": true
    },
    "phone_number_data": {
      "phone_number": "string",
      "is_confirmed": true
    }
  },
  "external_id": "string",
  "status": "Pending",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "verification_status": "None"
}