Contact Manager
Where to start?
Pay2.House Log In

Webhook Events

WALLET_DEPOSIT

The event is sent when funds are credited to the customer’s internal account.

Parameter Type Description
type string Event type. The value is always WALLET_DEPOSIT.
sender_wallet string Identifier or address of the sender account.
recipient_wallet string Identifier or address of the recipient account.
transaction_number string Unique transaction number in the system.
transaction_amount number Deposit amount.
transaction_currency string Transaction currency, for example USDT.
transaction_hash string Transaction hash for blockchain operations.
time_created number Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "WALLET_DEPOSIT",
    "sender_wallet": "TX9abc123...",
    "recipient_wallet": "P2U49984694",
    "transaction_number": "TN4395601712",
    "transaction_amount": 100,
    "transaction_currency": "USDT",
    "transaction_hash": "0xabc123def456...",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_ISSUED

The event is sent when a virtual card is successfully issued.

Parameter Type Description
type string Event type. The value is always CARD_ISSUED.
card_id string Unique identifier of the issued card in the system.
{
    "type": "CARD_ISSUED",
    "card_id": "VC7914059264"
}

CARD_CLOSED

The event is sent when a virtual card is closed.

Parameter Type Description
type string Event type. The value is always CARD_CLOSED.
card_id string Unique identifier of the card in the system.
time_created number Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "CARD_CLOSED",
    "card_id": "VC7914059264",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_BLOCKED

The event is sent when a virtual card is blocked.

Parameter Type Description
type string Event type. The value is always CARD_BLOCKED.
card_id string Unique identifier of the card in the system.
time_created number Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "CARD_BLOCKED",
    "card_id": "VC7914059264",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_RENEWED

The event is sent when a virtual card is successfully renewed.

Parameter Type Description
type string Event type. The value is always CARD_RENEWED.
card_id string Unique identifier of the card in the system.
time_created number Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "CARD_RENEWED",
    "card_id": "VC7914059264",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_3DS_CODE_RECEIVED

The event is sent when a one-time verification code for a card operation is received.

Parameter Type Description
type string Event type. The value is always CARD_3DS_CODE_RECEIVED.
card_id string Unique identifier of the card in the system.
otp_code string 3DS verification code used to confirm the transaction.
transaction_amount number Transaction amount requiring confirmation.
transaction_currency string Transaction currency, for example USD, EUR.
time_created number Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "CARD_3DS_CODE_RECEIVED",
    "card_id": "VC7914059264",
    "otp_code": "123456",
    "transaction_amount": 100,
    "transaction_currency": "USD",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_TOKENIZATION_CODE_RECEIVED

The event is sent when a one-time verification code for card tokenization is received.

Parameter Type Description
type string Event type. The value is always CARD_TOKENIZATION_CODE_RECEIVED.
card_id string Unique identifier of the card in the system.
otp_code string Verification code used for card tokenization.
time_created number Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "CARD_TOKENIZATION_CODE_RECEIVED",
    "card_id": "VC7914059264",
    "otp_code": "123456",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_AUTHORIZATION_APPROVED

The event is sent when a transaction is successfully authorized using a virtual card.

Parameter Type Description
type string Event type. The value is always CARD_AUTHORIZATION_APPROVED.
card_id string Unique identifier of the card in the system.
transaction_number string Unique transaction number in the system.
transaction_amount number Transaction amount in the operation currency.
transaction_currency string Transaction currency, for example USD, EUR.
account_amount number Transaction amount in the card currency.
account_currency string Card currency, for example USD, EUR.
merchant_name string Merchant name.
authorization_id string Unique authorization identifier.
time_created string Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "CARD_AUTHORIZATION_APPROVED",
    "card_id": "VC7914059264",
    "transaction_number": "TN4395601712",
    "transaction_amount": 50,
    "transaction_currency": "USD",
    "account_amount": 50,
    "account_currency": "USD",
    "merchant_name": "Amazon",
    "authorization_id": "AUTH123456",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_AUTHORIZATION_FEE_DEDUCTED

The event is sent when an authorization fee is charged for a transaction using a virtual card.

Parameter Type Description
type string Event type. The value is always CARD_AUTHORIZATION_FEE_DEDUCTED.
card_id string Unique identifier of the card in the system.
transaction_number string Unique transaction number in the system.
transaction_amount number Transaction amount in the operation currency.
transaction_currency string Transaction currency, for example USD, EUR.
account_amount number Transaction amount in the card currency.
account_currency string Card currency, for example USD, EUR.
merchant_name string Merchant name.
authorization_id string Unique authorization identifier.
time_created number Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "CARD_AUTHORIZATION_FEE_DEDUCTED",
    "card_id": "VC7914059264",
    "transaction_number": "TN4395601712",
    "transaction_amount": 1.5,
    "transaction_currency": "USD",
    "account_amount": 1.5,
    "account_currency": "USD",
    "merchant_name": "PAY2.HOUSE",
    "authorization_id": "AUTH123456",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_AUTHORIZATION_FEE_DEDUCTED_FROM_ACCOUNT

The event is sent when an authorization fee is charged from the customer’s internal account if the card balance is insufficient.

Parameter Type Description
type string Event type. The value is always CARD_AUTHORIZATION_FEE_DEDUCTED_FROM_ACCOUNT.
card_id string Unique identifier of the card in the system.
transaction_number string Unique transaction number in the system.
transaction_amount number Transaction amount in the operation currency.
transaction_currency string Transaction currency, for example USD, EUR.
account_amount number Fee amount charged from the internal account.
account_currency string Currency of the internal account from which the fee was charged.
merchant_name string Merchant name.
authorization_id string Unique authorization identifier.
time_created number Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "CARD_AUTHORIZATION_FEE_DEDUCTED_FROM_ACCOUNT",
    "card_id": "VC7914059264",
    "transaction_number": "TN4395601712",
    "transaction_amount": 1.5,
    "transaction_currency": "USD",
    "account_amount": 1.5,
    "account_currency": "USD",
    "merchant_name": "PAY2.HOUSE",
    "authorization_id": "AUTH123456",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_AUTHORIZATION_DECLINED

The event is sent when a transaction authorization using a virtual card is declined.

Parameter Type Description
type string Event type. The value is always CARD_AUTHORIZATION_DECLINED.
card_id string Unique identifier of the card in the system.
transaction_number string Unique transaction number in the system.
transaction_amount number Transaction amount in the operation currency.
transaction_currency string Transaction currency, for example USD, EUR.
account_amount number Transaction amount in the card currency.
account_currency string Card currency, for example USD, EUR.
merchant_name string Merchant name.
authorization_id string Unique authorization identifier.
time_created number Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "CARD_AUTHORIZATION_DECLINED",
    "card_id": "VC7914059264",
    "transaction_number": "TN4395601712",
    "transaction_amount": 50,
    "transaction_currency": "USD",
    "account_amount": 50,
    "account_currency": "USD",
    "merchant_name": "Amazon",
    "authorization_id": "AUTH123456",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_AUTHORIZATION_DECLINED_FEE_DEDUCTED

The event is sent when a fee is charged for a declined authorization attempt.

Parameter Type Description
type string Event type. The value is always CARD_AUTHORIZATION_DECLINED_FEE_DEDUCTED.
card_id string Unique identifier of the card in the system.
transaction_number string Unique transaction number in the system.
transaction_amount number Transaction amount in the operation currency.
transaction_currency string Transaction currency, for example USD, EUR.
account_amount number Fee amount in the card currency.
account_currency string Card currency, for example USD, EUR.
merchant_name string Merchant name.
authorization_id string Unique authorization identifier.
time_created number Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "CARD_AUTHORIZATION_DECLINED_FEE_DEDUCTED",
    "card_id": "VC7914059264",
    "transaction_number": "TN4395601712",
    "transaction_amount": 0.5,
    "transaction_currency": "USD",
    "account_amount": 0.5,
    "account_currency": "USD",
    "merchant_name": "PAY2.HOUSE",
    "authorization_id": "AUTH123456",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_AUTHORIZATION_DECLINED_FEE_DEDUCTED_FROM_ACCOUNT

The event is sent when a fee for a declined authorization is charged from the internal account if the card balance is insufficient.

Parameter Type Description
type string Event type. The value is always CARD_AUTHORIZATION_DECLINED_FEE_DEDUCTED_FROM_ACCOUNT.
card_id string Unique identifier of the card in the system.
transaction_number string Unique transaction number in the system.
transaction_amount number Transaction amount in the operation currency.
transaction_currency string Transaction currency, for example USD, EUR.
account_amount number Fee amount charged from the internal account.
account_currency string Currency of the internal account from which the fee was charged.
merchant_name string Merchant name.
authorization_id string Unique authorization identifier.
time_created number Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "CARD_AUTHORIZATION_DECLINED_FEE_DEDUCTED",
    "card_id": "VC7914059264",
    "transaction_number": "TN4395601712",
    "transaction_amount": 0.5,
    "transaction_currency": "USD",
    "account_amount": 0.5,
    "account_currency": "USD",
    "merchant_name": "PAY2.HOUSE",
    "authorization_id": "AUTH123456",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_REVERSAL_PROCESSED

The event is sent when funds are reversed for a previously authorized transaction.

Parameter Type Description
type string Event type. The value is always CARD_REVERSAL_PROCESSED.
card_id string Unique identifier of the card in the system.
transaction_number string Unique transaction number in the system.
transaction_amount number Reversal amount in the operation currency.
transaction_currency string Transaction currency, for example USD, EUR.
account_amount number Reversal amount in the card currency.
account_currency string Card currency, for example USD, EUR.
merchant_name string Merchant name.
authorization_id string Unique authorization identifier.
reversal_id string Unique identifier of the reversal operation.
time_created number Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "CARD_REVERSAL_PROCESSED",
    "card_id": "VC7914059264",
    "transaction_number": "TN4395601712",
    "transaction_amount": 50,
    "transaction_currency": "USD",
    "account_amount": 50,
    "account_currency": "USD",
    "merchant_name": "Amazon",
    "authorization_id": "AUTH123456",
    "reversal_id": "REV987654",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_AUTHORIZATION_CAPTURED

The event is sent when the capture of funds based on a previously authorized transaction is confirmed.

Parameter Type Description
type string Event type. The value is always CARD_AUTHORIZATION_CAPTURED.
card_id string Unique identifier of the card in the system.
transaction_number string Unique transaction number in the system.
transaction_amount number Transaction amount in the operation currency.
transaction_currency string Transaction currency, for example USD, EUR.
account_amount number Captured amount in the card currency.
account_currency string Card currency, for example USD, EUR.
merchant_name string Merchant name.
authorization_id string Unique authorization identifier.
transaction_id string Unique identifier of the capture operation linked to the authorization.
time_created number Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "CARD_AUTHORIZATION_CAPTURED",
    "card_id": "VC7914059264",
    "transaction_number": "TN4395601712",
    "transaction_amount": 50,
    "transaction_currency": "USD",
    "account_amount": 50,
    "account_currency": "USD",
    "merchant_name": "Amazon",
    "authorization_id": "AUTH123456",
    "transaction_id": "TRX987654",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_CONVERSION_FEE_DEDUCTED

The event is sent when a currency conversion fee is charged for a transaction using a virtual card.

Parameter Type Description
type string Event type. The value is always CARD_CONVERSION_FEE_DEDUCTED.
card_id string Unique identifier of the card in the system.
transaction_number string Unique transaction number in the system.
transaction_amount number Fee amount in the operation currency.
transaction_currency string Fee currency, for example USD, EUR.
account_amount number Fee amount in the card currency.
account_currency string Card currency, for example USD, EUR.
merchant_name string Merchant name.
authorization_id string Unique authorization identifier.
fee_id string Unique identifier of the fee charge operation.
time_created number Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "CARD_CONVERSION_FEE_DEDUCTED",
    "card_id": "VC7914059264",
    "transaction_number": "TN4395601712",
    "transaction_amount": 1.2,
    "transaction_currency": "USD",
    "account_amount": 1.2,
    "account_currency": "USD",
    "merchant_name": "PAY2.HOUSE",
    "authorization_id": "AUTH123456",
    "fee_id": "FEE987654",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_CONVERSION_FEE_CONFIRMED

The event is sent when a currency conversion fee for a previously processed transaction is confirmed.

Parameter Type Description
type string Event type. The value is always CARD_CONVERSION_FEE_CONFIRMED.
card_id string Unique identifier of the card in the system.
transaction_number string Unique transaction number in the system.
transaction_amount number Conversion fee amount in the operation currency.
transaction_currency string Fee currency, for example USD, EUR.
account_amount number Conversion fee amount in the card currency.
account_currency string Card currency, for example USD, EUR.
merchant_name string Merchant name.
authorization_id string Unique authorization identifier.
fee_id string Unique identifier of the fee charge operation.
time_created number Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "CARD_CONVERSION_FEE_CONFIRMED",
    "card_id": "VC7914059264",
    "transaction_number": "TN4395601712",
    "transaction_amount": 1.2,
    "transaction_currency": "USD",
    "account_amount": 1.2,
    "account_currency": "USD",
    "merchant_name": "PAY2.HOUSE",
    "authorization_id": "AUTH123456",
    "fee_id": "FEE987654",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_CONVERSION_FEE_DEDUCTED_FROM_ACCOUNT

The event is sent when a currency conversion fee is charged from the internal account if the card balance is insufficient.

Parameter Type Description
type string Event type. The value is always CARD_CONVERSION_FEE_DEDUCTED_FROM_ACCOUNT.
card_id string Unique identifier of the card in the system.
transaction_number string Unique transaction number in the system.
transaction_amount number Conversion fee amount in the operation currency.
transaction_currency string Fee currency, for example USD, EUR.
account_amount number Fee amount charged from the internal account.
account_currency string Currency of the internal account from which the fee was charged.
merchant_name string Merchant name.
authorization_id string Unique authorization identifier.
time_created number Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "CARD_CONVERSION_FEE_DEDUCTED_FROM_ACCOUNT",
    "card_id": "VC7914059264",
    "transaction_number": "TN4395601712",
    "transaction_amount": 1.2,
    "transaction_currency": "USD",
    "account_amount": 1.2,
    "account_currency": "USD",
    "merchant_name": "PAY2.HOUSE",
    "authorization_id": "AUTH123456",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_REFUND_ON_HOLD

The event is sent when a refund is created and is in a pending state.

Parameter Type Description
type string Event type. The value is always CARD_REFUND_ON_HOLD.
card_id string Unique identifier of the card in the system.
transaction_number string Unique transaction number in the system.
transaction_amount string Reversal amount in the operation currency.
transaction_currency string Transaction currency, for example USD, EUR.
account_amount string Reversal amount in the card currency.
account_currency string Card currency, for example USD, EUR.
merchant_name string Merchant name.
authorization_id string Unique authorization identifier.
refund_id string Unique identifier of the reversal operation.
time_created number Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "CARD_REFUND_ON_HOLD",
    "card_id": "VC7914059264",
    "transaction_number": "TN4395601712",
    "transaction_amount": 50,
    "transaction_currency": "USD",
    "account_amount": 50,
    "account_currency": "USD",
    "merchant_name": "Amazon",
    "authorization_id": "AUTH123456",
    "refund_id": "REF987654",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_REFUND_TO_ACCOUNT

The event is sent when refund funds are credited to the customer’s internal account.

Parameter Type Description
type string Event type. The value is always CARD_REFUND_TO_ACCOUNT.
card_id string Unique identifier of the card in the system.
transaction_number string Unique transaction number in the system.
transaction_amount string Reversal amount in the operation currency.
transaction_currency string Transaction currency, for example USD, EUR.
account_amount string Amount credited to the internal account.
account_currency string Currency of the internal account.
merchant_name string Merchant name.
authorization_id string Unique authorization identifier.
refund_id string Unique identifier of the reversal operation.
time_created number Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "CARD_REFUND_TO_ACCOUNT",
    "card_id": "VC7914059264",
    "transaction_number": "TN4395601712",
    "transaction_amount": 50,
    "transaction_currency": "USD",
    "account_amount": 50,
    "account_currency": "USD",
    "merchant_name": "Amazon",
    "authorization_id": "AUTH123456",
    "refund_id": "REF987654",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_OUT_OF_WHITELIST_FEE_DEDUCTED

The event is sent when a fee is charged for a transaction outside the allowed list.

Parameter Type Description
type string Event type. The value is always CARD_OUT_OF_WHITELIST_FEE_DEDUCTED.
card_id string Unique identifier of the card in the system.
transaction_number string Unique transaction number in the system.
transaction_amount string Transaction amount in the operation currency.
transaction_currency string Transaction currency, for example USD, EUR.
account_amount string Fee amount in the card currency.
account_currency string Card currency, for example USD, EUR.
merchant_name string Merchant name.
authorization_id string Unique authorization identifier.
time_created number Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "CARD_OUT_OF_WHITELIST_FEE_DEDUCTED",
    "card_id": "VC7914059264",
    "transaction_number": "TN4395601712",
    "transaction_amount": 2.0,
    "transaction_currency": "USD",
    "account_amount": 2.0,
    "account_currency": "USD",
    "merchant_name": "PAY2.HOUSE",
    "authorization_id": "AUTH123456",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_OUT_OF_WHITELIST_FEE_DEDUCTED_FROM_ACCOUNT

The event is sent when a fee for a transaction outside the allowed list is charged from the internal account if the card balance is insufficient.

Parameter Type Description
type string Event type. The value is always CARD_OUT_OF_WHITELIST_FEE_DEDUCTED_FROM_ACCOUNT.
card_id string Unique identifier of the card in the system.
transaction_number string Unique transaction number in the system.
transaction_amount string Transaction amount in the operation currency.
transaction_currency string Transaction currency, for example USD, EUR.
account_amount string Fee amount charged from the internal account.
account_currency string Currency of the internal account from which the fee was charged.
merchant_name string Merchant name.
authorization_id string Unique authorization identifier.
time_created number Event creation time in Unix timestamp format.
date_created string Event creation date and time in YYYY-MM-DD HH:mm:ss format.
{
    "type": "CARD_OUT_OF_WHITELIST_FEE_DEDUCTED_FROM_ACCOUNT",
    "card_id": "VC7914059264",
    "transaction_number": "TN4395601712",
    "transaction_amount": 2.0,
    "transaction_currency": "USD",
    "account_amount": 2.0,
    "account_currency": "USD",
    "merchant_name": "PAY2.HOUSE",
    "authorization_id": "AUTH123456",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}
We use cookies to improve the website’s performance. By continuing to use the site, you agree to our privacy policy and service rules.