联系客户经理
如何开始？
Pay2.House 登录

Webhook Events

WALLET_DEPOSIT

当资金记入客户内部账户时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 WALLET_DEPOSIT。
sender_wallet string 发送方账户的标识或地址。
recipient_wallet string 接收方账户的标识或地址。
transaction_number string 系统中的交易唯一编号。
transaction_amount number 入账金额。
transaction_currency string 交易币种，例如 USDT。
transaction_hash string 交易哈希，用于区块链操作。
time_created number 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "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

当虚拟卡成功发行时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_ISSUED。
card_id string 系统中已发行卡片的唯一标识符。
{
    "type": "CARD_ISSUED",
    "card_id": "VC7914059264"
}

CARD_CLOSED

当虚拟卡被关闭时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_CLOSED。
card_id string 系统中卡片的唯一标识符。
time_created number 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "type": "CARD_CLOSED",
    "card_id": "VC7914059264",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_BLOCKED

当虚拟卡被阻止时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_BLOCKED。
card_id string 系统中卡片的唯一标识符。
time_created number 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "type": "CARD_BLOCKED",
    "card_id": "VC7914059264",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_RENEWED

当虚拟卡成功续期时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_RENEWED。
card_id string 系统中卡片的唯一标识符。
time_created number 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "type": "CARD_RENEWED",
    "card_id": "VC7914059264",
    "time_created": 1714230000,
    "date_created": "2026-04-27 18:00:00"
}

CARD_3DS_CODE_RECEIVED

当收到用于确认卡片操作的一次性验证码时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_3DS_CODE_RECEIVED。
card_id string 系统中卡片的唯一标识符。
otp_code string 用于确认交易的 3DS 验证码。
transaction_amount number 需要确认的交易金额。
transaction_currency string 交易币种，例如 USD、EUR。
time_created number 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "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

当收到用于卡片令牌化的一次性验证码时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_TOKENIZATION_CODE_RECEIVED。
card_id string 系统中卡片的唯一标识符。
otp_code string 用于卡片令牌化的验证码。
time_created number 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "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

当使用虚拟卡成功授权交易时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_AUTHORIZATION_APPROVED。
card_id string 系统中卡片的唯一标识符。
transaction_number string 系统中的交易唯一编号。
transaction_amount number 以操作币种表示的交易金额。
transaction_currency string 交易币种，例如 USD、EUR。
account_amount number 以卡片币种表示的交易金额。
account_currency string 卡片币种，例如 USD、EUR。
merchant_name string 商户名称。
authorization_id string 授权的唯一标识符。
time_created string 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "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

当从虚拟卡中扣除交易授权费用时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_AUTHORIZATION_FEE_DEDUCTED。
card_id string 系统中卡片的唯一标识符。
transaction_number string 系统中的交易唯一编号。
transaction_amount number 以操作币种表示的交易金额。
transaction_currency string 交易币种，例如 USD、EUR。
account_amount number 以卡片币种表示的交易金额。
account_currency string 卡片币种，例如 USD、EUR。
merchant_name string 商户名称。
authorization_id string 授权的唯一标识符。
time_created number 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "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

当卡片余额不足时，从客户内部账户扣除交易授权费用时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_AUTHORIZATION_FEE_DEDUCTED_FROM_ACCOUNT。
card_id string 系统中卡片的唯一标识符。
transaction_number string 系统中的交易唯一编号。
transaction_amount number 以操作币种表示的交易金额。
transaction_currency string 交易币种，例如 USD、EUR。
account_amount number 从内部账户扣除的费用金额。
account_currency string 执行扣款的内部账户币种。
merchant_name string 商户名称。
authorization_id string 授权的唯一标识符。
time_created number 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "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

当使用虚拟卡的交易授权被拒绝时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_AUTHORIZATION_DECLINED。
card_id string 系统中卡片的唯一标识符。
transaction_number string 系统中的交易唯一编号。
transaction_amount number 以操作币种表示的交易金额。
transaction_currency string 交易币种，例如 USD、EUR。
account_amount number 以卡片币种表示的交易金额。
account_currency string 卡片币种，例如 USD、EUR。
merchant_name string 商户名称。
authorization_id string 授权的唯一标识符。
time_created number 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "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

当因授权被拒绝而收取费用时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_AUTHORIZATION_DECLINED_FEE_DEDUCTED。
card_id string 系统中卡片的唯一标识符。
transaction_number string 系统中的交易唯一编号。
transaction_amount number 以操作币种表示的交易金额。
transaction_currency string 交易币种，例如 USD、EUR。
account_amount number 以卡片币种表示的费用金额。
account_currency string 卡片币种，例如 USD、EUR。
merchant_name string 商户名称。
authorization_id string 授权的唯一标识符。
time_created number 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "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

当卡片余额不足时，从内部账户扣除授权失败费用时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_AUTHORIZATION_DECLINED_FEE_DEDUCTED_FROM_ACCOUNT。
card_id string 系统中卡片的唯一标识符。
transaction_number string 系统中的交易唯一编号。
transaction_amount number 以操作币种表示的交易金额。
transaction_currency string 交易币种，例如 USD、EUR。
account_amount number 从内部账户扣除的费用金额。
account_currency string 执行扣款的内部账户币种。
merchant_name string 商户名称。
authorization_id string 授权的唯一标识符。
time_created number 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "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

当对已授权交易执行资金返还时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_REVERSAL_PROCESSED。
card_id string 系统中卡片的唯一标识符。
transaction_number string 系统中的交易唯一编号。
transaction_amount number 以操作币种表示的返还金额。
transaction_currency string 交易币种，例如 USD、EUR。
account_amount number 以卡片币种表示的返还金额。
account_currency string 卡片币种，例如 USD、EUR。
merchant_name string 商户名称。
authorization_id string 授权的唯一标识符。
reversal_id string 返还操作的唯一标识符。
time_created number 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "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

当确认根据先前授权完成扣款时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_AUTHORIZATION_CAPTURED。
card_id string 系统中卡片的唯一标识符。
transaction_number string 系统中的交易唯一编号。
transaction_amount number 以操作币种表示的交易金额。
transaction_currency string 交易币种，例如 USD、EUR。
account_amount number 以卡片币种表示的扣款金额。
account_currency string 卡片币种，例如 USD、EUR。
merchant_name string 商户名称。
authorization_id string 授权的唯一标识符。
transaction_id string 与该授权相关的扣款操作唯一标识符。
time_created number 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "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

当从虚拟卡交易中扣除货币转换费用时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_CONVERSION_FEE_DEDUCTED。
card_id string 系统中卡片的唯一标识符。
transaction_number string 系统中的交易唯一编号。
transaction_amount number 以操作币种表示的费用金额。
transaction_currency string 费用币种，例如 USD、EUR。
account_amount number 以卡片币种表示的费用金额。
account_currency string 卡片币种，例如 USD、EUR。
merchant_name string 商户名称。
authorization_id string 授权的唯一标识符。
fee_id string 费用扣除操作的唯一标识符。
time_created number 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "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

当确认已完成交易的货币转换费用时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_CONVERSION_FEE_CONFIRMED。
card_id string 系统中卡片的唯一标识符。
transaction_number string 系统中的交易唯一编号。
transaction_amount number 以操作币种表示的转换费用金额。
transaction_currency string 费用币种，例如 USD、EUR。
account_amount number 以卡片币种表示的转换费用金额。
account_currency string 卡片币种，例如 USD、EUR。
merchant_name string 商户名称。
authorization_id string 授权的唯一标识符。
fee_id string 费用扣除操作的唯一标识符。
time_created number 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "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

当卡片余额不足时，从内部账户扣除货币转换费用时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_CONVERSION_FEE_DEDUCTED_FROM_ACCOUNT。
card_id string 系统中卡片的唯一标识符。
transaction_number string 系统中的交易唯一编号。
transaction_amount number 以操作币种表示的转换费用金额。
transaction_currency string 费用币种，例如 USD、EUR。
account_amount number 从内部账户扣除的费用金额。
account_currency string 执行扣款的内部账户币种。
merchant_name string 商户名称。
authorization_id string 授权的唯一标识符。
time_created number 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "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

当创建退款且处于等待状态时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_REFUND_ON_HOLD。
card_id string 系统中卡片的唯一标识符。
transaction_number string 系统中的交易唯一编号。
transaction_amount string 以操作币种表示的返还金额。
transaction_currency string 交易币种，例如 USD、EUR。
account_amount string 以卡片币种表示的返还金额。
account_currency string 卡片币种，例如 USD、EUR。
merchant_name string 商户名称。
authorization_id string 授权的唯一标识符。
refund_id string 返还操作的唯一标识符。
time_created number 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "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

当退款资金记入客户内部账户时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_REFUND_TO_ACCOUNT。
card_id string 系统中卡片的唯一标识符。
transaction_number string 系统中的交易唯一编号。
transaction_amount string 以操作币种表示的返还金额。
transaction_currency string 交易币种，例如 USD、EUR。
account_amount string 记入内部账户的金额。
account_currency string 内部账户的币种。
merchant_name string 商户名称。
authorization_id string 授权的唯一标识符。
refund_id string 返还操作的唯一标识符。
time_created number 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "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

当交易不在允许列表中并收取费用时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_OUT_OF_WHITELIST_FEE_DEDUCTED。
card_id string 系统中卡片的唯一标识符。
transaction_number string 系统中的交易唯一编号。
transaction_amount string 以操作币种表示的交易金额。
transaction_currency string 交易币种，例如 USD、EUR。
account_amount string 以卡片币种表示的费用金额。
account_currency string 卡片币种，例如 USD、EUR。
merchant_name string 商户名称。
authorization_id string 授权的唯一标识符。
time_created number 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "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

当卡片余额不足时，从内部账户扣除不在允许列表中的交易费用时发送此事件。

参数 类型 描述
type string 事件类型。该值始终为 CARD_OUT_OF_WHITELIST_FEE_DEDUCTED_FROM_ACCOUNT。
card_id string 系统中卡片的唯一标识符。
transaction_number string 系统中的交易唯一编号。
transaction_amount string 以操作币种表示的交易金额。
transaction_currency string 交易币种，例如 USD、EUR。
account_amount string 从内部账户扣除的费用金额。
account_currency string 执行扣款的内部账户币种。
merchant_name string 商户名称。
authorization_id string 授权的唯一标识符。
time_created number 事件创建时间，格式为 Unix timestamp。
date_created string 事件创建日期和时间，格式为 YYYY-MM-DD HH:mm:ss。
{
    "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"
}
我们使用 Cookie 改善网站体验。继续使用本网站，即表示您同意我们的隐私政策和服务规则。