Transfer Events

The currently supported event types are as follows:

transfer.approved
transfer.succeed
transfer.expired
transfer.failed


Please note that duplicate events MAY occur and in some occasions, may arrive out of order. We ask partners to de-dupe these events.

Transfer event defination:

typestringevent type
typestringevent type
payload.idstringtransfer id
payload.to_wallet_idstringtarget wallet id which the tranfer made to
payload.amount.currencystringcurrency code
payload.amount.amountstringcurrency amount, big interger in string representation
payload.failed_messagestringoptional failed reason, initialized when the transfer failed
payload.created_atstringcreated time
payload.updated_atstringupdated time

Withdraw Event samples:

{
    "type": "transfer.approved",
    "payload": {
        "id": "92841860-481e-4ba4-9be2-12b1e497facf",
        "to_wallet_id": "11b9ca57-0559-403a-bf8e-7bd1a31aff46",
        "amount": {
            "currency": "USDT",
            "amount": "10000"
        },
        "created_at": "2024-02-14T12:00:00Z",
        "updated_at": "2024-02-14T12:01:00Z"
    }
}
{
    "type": "transfer.succeed",
    "payload": {
        "id": "92841860-481e-4ba4-9be2-12b1e497facf",
        "to_wallet_id": "11b9ca57-0559-403a-bf8e-7bd1a31aff46",
        "amount": {
            "currency": "USDT",
            "amount": "10000"
        },
        "created_at": "2024-02-14T12:00:00Z",
        "updated_at": "2024-02-14T12:01:00Z"
    }
}
{
    "type": "transfer.expired",
    "payload": {
        "id": "92841860-481e-4ba4-9be2-12b1e497facf",
        "to_wallet_id": "11b9ca57-0559-403a-bf8e-7bd1a31aff46",
        "amount": {
            "currency": "USDT",
            "amount": "10000"
        },
        "created_at": "2024-02-14T12:00:00Z",
        "updated_at": "2024-02-14T12:01:00Z"
    }
}
{
    "type": "transfer.failed",
    "payload": {
        "id": "92841860-481e-4ba4-9be2-12b1e497facf",
        "to_wallet_id": "11b9ca57-0559-403a-bf8e-7bd1a31aff46",
        "amount": {
            "currency": "USDT",
            "amount": "10000"
        },
        "failed_message": "insufficient balance",
        "created_at": "2024-02-14T12:00:00Z",
        "updated_at": "2024-02-14T12:01:00Z"
    }
}