API Reference

Securo send webhook payload in JSON format. You have to parse it to readable object.

Below is the list of the events when Securo send the webhook:

Decentralised Exchange Swap (DeX Swap)

Webhook Event CodeDescription
dex.approvalThe allowance approval transaction is executed by the blockchain network.
dex.swapThe token swap transaction is executed by the blockchain network.

Sample JSON payload data (dex.approval)

{
  publicSessionId: 'VTJGc2RHVmtYMStUYy80SGkwaHpoNE56VGFvNUk3NThBcTZiZHRjeVEwb0VYNnpxdzVZTWFOcGJkQXdBSmtIeg==',
  orderId: '0225-275520-6112',
  data: {
  	token: '0xc2132D05D31c914a87C6611C10748AEb04B58e8F',
    spender: 'f2b9a3ae5b765556f2e2934173cb1f957c8ed50b',
    owner: '3f68a3c1023d736d8be867ca49cb18c543373b99',
    amount: '115792089237316195423570985008687907853269984665640564039457584007913129.639935',
    event: {
      transactionIndex: 54,
      blockNumber: 35319298,
      transactionHash: '0xef2d615e7530fb1373a3a91b291b701d78112e52d486107ad551803bb18a8899',
      address: '0xc2132D05D31c914a87C6611C10748AEb04B58e8F',
      topics: [
        '0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925',
        '0x0000000000000000000000003f68a3c1023d736d8be867ca49cb18c543373b99',
        '0x000000000000000000000000f2b9a3ae5b765556f2e2934173cb1f957c8ed50b'
      ],
      data: '0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff',
      logIndex: 228,
      blockHash: '0x13daac7b468cbbeb50554eb59e35c7df467af995805c4aaaec75c06b8ba9ace9'
    },
    status: 1
  }
}

Sample JSON payload data (dex.swap)

{
	publicSessionId: 'VTJGc2RHVmtYMStUYy80SGkwaHpoNE56VGFvNUk3NThBcTZiZHRjeVEwb0VYNnpxdzVZTWFOcGJkQXdBSmtIeg==',
	orderId: '0225-275520-6112',
	data: {
      sender: '0x10ED43C718714eb63d5aA57B78B54704E256024E',
      to: '0x3f68A3c1023d736D8Be867CA49Cb18c543373B99',
      amount0In: '0',
      amount1In: '3015526997545679',
      amount0Out: '1000000000000000000',
      amount1Out: '0',
      event: {
        transactionIndex: 112,
        blockNumber: 22849752,
        transactionHash: '0x2fd0c0281684f68fc80f5f699feb4759d6b7a214c0b9b80bde374c7e191057b5',
        address: '0x16b9a82891338f9bA80E2D6970FddA79D1eb0daE',
        topics: [
          '0xd78ad95fa46c994b6551d0da85fc275fe613ce37657fb8d5e3d130840159d822',
          '0x00000000000000000000000010ed43c718714eb63d5aa57b78b54704e256024e',
          '0x0000000000000000000000003f68a3c1023d736d8be867ca49cb18c543373b99'
        ],
        data: '0x0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ab69b177fd2cf0000000000000000000000000000000000000000000000000de0b6b3a76400000000000000000000000000000000000000000000000000000000000000000000',
        logIndex: 304,
        blockHash: '0xba3aa125a7952b3b9bb55f11db6d2def0036850b38e551338c10ec31c92f9b79'
      },
      status: 1
   }
}

Investment for Index Funds

Webhook Event CodeDescription
noncustodian.approvalThe allowance approval transaction is executed by the blockchain network.
noncustodian.depositThe deposit transaction is executed by the blockchain network.
noncustodian.withdrawThe withdrawal transaction is executed by the blockchain network.

Sample JSON payload data (noncustodian.approval)

{
	publicSessionId: 'VTJGc2RHVmtYMStUYy80SGkwaHpoNE56VGFvNUk3NThBcTZiZHRjeVEwb0VYNnpxdzVZTWFOcGJkQXdBSmtIeg==',
	orderId: '0225-275520-6112',
	data: {
      token: 'BSC.USDT',
      spender: '0x69380cc2169046f8A3B2c03D58Fe206475aAe3CB',
      owner: '0xe7540213cBAe297AbEcD73d90f3b345EE46977F6',
      amount: '999999999999999999.0',
      event: {
        blockNumber: 24276289,
        blockHash: '0x9973ea841123dedb82a3d9a4b8a4acb84de0ffda369e6bba144cc427c96539d9',
        transactionIndex: 4,
        removed: false,
        address: '0x1F326a8CA5399418a76eA0efa0403Cbb00790C67',
        data: '0x0000000000000000000000000000000000c097ce7bc90715a56ae85c589c0000',
        topics: [
          '0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925',
          '0x000000000000000000000000e7540213cbae297abecd73d90f3b345ee46977f6',
          '0x00000000000000000000000069380cc2169046f8a3b2c03d58fe206475aae3cb'
        ],
        transactionHash: '0x0f46f10a5466699451ffb71f9f9dd378607adbcfdf2f8217a022f13c95c31b23',
        logIndex: 2,
        event: 'Approval',
        eventSignature: 'Approval(address,address,uint256)',
        args: [
          '0xe7540213cBAe297AbEcD73d90f3b345EE46977F6',
          '0x69380cc2169046f8A3B2c03D58Fe206475aAe3CB',
          [Object]
        ]
      }
   }
}

Sample JSON payload data (noncustodian.deposit)

{
	publicSessionId: 'VTJGc2RHVmtYMStUYy80SGkwaHpoNE56VGFvNUk3NThBcTZiZHRjeVEwb0VYNnpxdzVZTWFOcGJkQXdBSmtIeg==',
	orderId: '0225-275520-6112',
 	data: {
      token: 'BSC.LCI',
      sender: '0x46d5D81D9C855ed58f35447cD0c1Dd0e07e967D2',
      amount: '10.0',
      stableTokenAddress: '0x1F326a8CA5399418a76eA0efa0403Cbb00790C67',
      shares: '9.999999999999999643',
      event: {
        blockNumber: 24344275,
        blockHash: '0xfbb87432ed77868caff0decc0124836dfeea3d254fdb19d8a10bd1f30f0f1608',
        transactionIndex: 7,
        removed: false,
        address: '0x69380cc2169046f8A3B2c03D58Fe206475aAe3CB',
        data: '0x00000000000000000000000046d5d81d9c855ed58f35447cd0c1dd0e07e967d20000000000000000000000000000000000000000000000008ac7230489e800000000000000000000000000001f326a8ca5399418a76ea0efa0403cbb00790c670000000000000000000000000000000000000000000000008ac7230489e7fe9b',
        topics: [
          '0xd2f8022f659fd9c8c558f30c00fd5ee7038f7cb56da45095c3e0e7d48b3e0c4b'
        ],
        transactionHash: '0xc3540bccb262b95b458cc108b3dd3344f60f68fc53b32a78ba8097b9bdc006ff',
        logIndex: 11,
        event: 'Deposit',
        eventSignature: 'Deposit(address,uint256,address,uint256)',
        args: [
          '0x46d5D81D9C855ed58f35447cD0c1Dd0e07e967D2',
          [Object],
          '0x1F326a8CA5399418a76eA0efa0403Cbb00790C67',
          [Object]
        ]
      }
   }
}

Sample JSON payload data (noncustodian.withdraw)

{
	publicSessionId: 'VTJGc2RHVmtYMStUYy80SGkwaHpoNE56VGFvNUk3NThBcTZiZHRjeVEwb0VYNnpxdzVZTWFOcGJkQXdBSmtIeg==',
	orderId: '0225-275520-6112',
	data: {
      token: 'BSC.LCI',
      sender: '0x46d5D81D9C855ed58f35447cD0c1Dd0e07e967D2',
      amount: '1.000000000000000034',
      stableTokenAddress: '0x1F326a8CA5399418a76eA0efa0403Cbb00790C67',
      shares: '1.0',
      event: {
        blockNumber: 24333950,
        blockHash: '0x818cd544661b2d0a85e608b06d79d6301ffccb92f1703031827e77a2de120648',
        transactionIndex: 2,
        removed: false,
        address: '0x69380cc2169046f8A3B2c03D58Fe206475aAe3CB',
        data: '0x00000000000000000000000046d5d81d9c855ed58f35447cd0c1dd0e07e967d20000000000000000000000000000000000000000000000000de0b6b3a76400220000000000000000000000001f326a8ca5399418a76ea0efa0403cbb00790c670000000000000000000000000000000000000000000000000de0b6b3a7640000',
        topics: [
          '0x457f950b75085c30ff780acd57bde642ff1316cc4aad9f286af2c1ffc4163a78'
        ],
        transactionHash: '0xa03f078a5442c12f67bd4865b8b4478e6c7286e097a3fb0203d5b56c8104b1e5',
        logIndex: 6,
        event: 'Withdraw',
        eventSignature: 'Withdraw(address,uint256,address,uint256)',
        args: [
          '0x46d5D81D9C855ed58f35447cD0c1Dd0e07e967D2',
          [Object],
          '0x1F326a8CA5399418a76eA0efa0403Cbb00790C67',
          [Object]
        ]
      }
   }
}

Fiat-to-Crypto

Webhook Event CodeDescriptionStatus Code
payment.topupThe purchase order transaction is executed successfully.success
payment.topupThe purchase order transaction is failed to executed.failed
payment.topupThe purchase order transaction is processing. There are different orderStatus in the event data to indicate the process stage of the order.pending

Sample JSON payload data (payment.topup)

{
  type: 'payment.topup',
  data: {
    invoiceId: '0225-968059-1010',
    totalFees: 7.81,
    cryptoCurrency: 'USDT',
    fiatCurrency: 'MYR',
    paymentMethod: 'credit_debit_card',
    paymentStatus: 'success',
    orderStatus: 'COMPLETED',
    isBuyOrSell: 'Buy',
    tax: 0,
    blockchainNetwork: 'ethereum',
    exchangeRate: 0.2104691449501919,
    fiatAmount: 142,
    cryptoAmount: 28.24,
    expiredDate: '2022-11-01T09:22:53.000Z',
    createdAt: '1667208172520',
    createdDate: '2022-10-31T09:22:52.525Z',
    paymentProvider: 'Transak',
    walletAddress: '0x69380cc2169046f8A3B2c03D58Fe206475aAe3CB',
    user: {
      emailAddress: '[email protected]',
      firstName: '[email protected]',
      lastName: null,
      mobileNumber: null,
      dateOfBirth: null,
      street: null,
      city: null,
      state: null,
      country: null,
      postalCode: null
    }
  }
}