Callbacks

Callbacks are used for retrieving state changes of initiated processes on specific URLs.

Types and statuses in callbacks

Transaction types: deposit / withdrawal / incoming / outgoing

Transaction statuses: new / processing / executed* / cancelled*

Operation types: deposit / withdrawal / exchange

Operation statuses: new / processing / executed* / cancelled*

*final statuses

Outgoing (withdrawal with autoconvert) callback examples

{
        "id":"31d236fc-a1fe-4288-8896-ea385659b40c",
        "referenceId":"Outgoing_Ref_102",
        "type":"outgoing",
        "amount":100,
        "amountType":"purchase",
        "status":"processing",
        "statusNote":null,
        "timestampCreated":"2022-01-01 00:00:00.000001 +03:00",
        "timestampUpdated":"2022-01-01 00:00:00.000001 +03:00",
        "operations": [
                {
                                "id":1003,
                                "type":"exchange",
                                "status":"processing",
                                "currency":"USDT_ERC20",
                                "exchangeFrom":"EUR",
                                "amount":97.713505,
                                "rate":1.0234,
                                "amountFinal":100
                }
        ],
        "callbackId":13
}
{
        "id":"31d236fc-a1fe-4288-8896-ea385659b40c",
        "referenceId":"Outgoing_Ref_102",
        "type":"outgoing",
        "amount":100,
        "amountType":"purchase",
        "status":"processing",
        "statusNote":null,
        "timestampCreated":"2022-01-01 00:00:00.000001 +03:00",
        "timestampUpdated":"2022-01-01 00:00:15.123123 +03:00",
        "operations": [
                {
                                "id":1003,
                                "type":"exchange",
                                "status":"executed",
                                "currency":"USDT_ERC20",
                                "exchangeFrom":"EUR",
                                "amount":97.713505,
                                "rate":1.0234,
                                "amountFinal":100
                },
                {
                                "id":1004,
                                "type":"withdrawal",
                                "status":"processing",
                                "address":"0xe0a113...c913F6",
                                "currency":"USDT_ERC20",
                                "amount":100,
                                "amountType":"gross",
                                "serviceFee":2.5,
                                "amountFinal":97.5,
                                "txHash":null
                }
        ],
        "callbackId":13
}
{
        "id":"31d236fc-a1fe-4288-8896-ea385659b40c",
        "referenceId":"Outgoing_Ref_102",
        "type":"outgoing",
        "amount":100,
        "amountType":"purchase",
        "status":"executed",
        "statusNote":"Outgoing successfully executed",
        "timestampCreated":"2022-01-01 00:00:00.000001 +03:00",
        "timestampUpdated":"2022-01-01 00:03:21.123123 +03:00",
        "operations": [
                {
                                "id":1003,
                                "type":"exchange",
                                "status":"executed",
                                "currency":"USDT_ERC20",
                                "exchangeFrom":"EUR",
                                "amount":97.713505,
                                "rate":1.0234,
                                "amountFinal":100
                },
                {
                                "id":1004,
                                "type":"withdrawal",
                                "status":"executed",
                                "address":"0xe0a113...c913F6",
                                "currency":"USDT_ERC20",
                                "amount":100,
                                "amountType":"gross",
                                "serviceFee":2.5,
                                "amountFinal":97.5,
                                "txHash":"0x17gh3f4e70...2edfb4c11b"
                }
        ],
        "callbackId":13
}

Incoming (deposit with autoconvert) callback examples

{
        "id":"65757b70-ef85-4c63-bebb-4eb75a5f8832",
        "type":"incoming",
        "status":"processing",
        "statusNote":null,
        "timestampCreated":"2022-01-01 00:00:00.000001 +03:00",
        "timestampUpdated":"2022-01-01 00:00:00.000001 +03:00",
        "operations": [
                {
                                "id":1005,
                                "type":"deposit",
                                "status":"processing",
                                "addressSource":"0x621D1d...bd0dc2",
                                "addressDestination":"0xe0a113...c913F6",
                                "addressReferenceId":"Address_Ref_2345",
                                "currency":"USDT_ERC20",
                                "amount":100,
                                "serviceFee":2,
                                "amountFinal":98,
                                "txHash":"0x17gh3f4e70...2edfb4c11b"
                }
        ],
        "callbackId":13
}
{
        "id":"65757b70-ef85-4c63-bebb-4eb75a5f8832",
        "type":"incoming",
        "status":"processing",
        "statusNote":null,
        "timestampCreated":"2022-01-01 00:00:00.000001 +03:00",
        "timestampUpdated":"2022-01-01 00:02:15.123123 +03:00",
        "operations": [
                {
                                "id":1005,
                                "type":"deposit",
                                "status":"executed",
                                "addressSource":"0x621D1d...bd0dc2",
                                "addressDestination":"0xe0a113...c913F6",
                                "addressReferenceId":"Address_Ref_2345",
                                "currency":"USDT_ERC20",
                                "amount":100,
                                "serviceFee":2,
                                "amountFinal":98,
                                "txHash":"0x17gh3f4e70...2edfb4c11b"
                },
                {
                                "id":1006,
                                "type":"exchange",
                                "status":"processing",
                                "currency":"USDT_ERC20",
                                "exchangeTo":"EUR",
                                "amount":98,
                                "rate":1.0234,
                                "amountFinal":100.2932
                }
        ],
        "callbackId":13
}
{
        "id":"65757b70-ef85-4c63-bebb-4eb75a5f8832",
        "type":"incoming",
        "status":"executed",
        "statusNote":"Incoming successfully executed",
        "timestampCreated":"2022-01-01 00:00:00.000001 +03:00",
        "timestampUpdated":"2022-01-01 00:02:42.123123 +03:00",
        "operations": [
                {
                                "id":1005,
                                "type":"deposit",
                                "status":"executed",
                                "addressSource":"0x621D1d...bd0dc2",
                                "addressDestination":"0xe0a113...c913F6",
                                "addressReferenceId":"Address_Ref_2345",
                                "currency":"USDT_ERC20",
                                "amount":100,
                                "serviceFee":2,
                                "amountFinal":98,
                                "txHash":"0x17f63f4e70...2ebfb7c51b"
                },
                {
                                "id":1006,
                                "type":"exchange",
                                "status":"executed",
                                "currency":"USDT_ERC20",
                                "exchangeTo":"EUR",
                                "amount":98,
                                "rate":1.0234,
                                "amountFinal":100.2932
                }
        ],
        "callbackId":13
}

Last updated