Svix

KRIPT-SANDBOX Webhook Event Types

This is the list of event types that we currently send.
For guidance on how to listen to these events, take a look at Svix's guide to consuming webhooks.

crypto.buy.failed

This event occurs when buy crypto orders fail.

Example
JSON
{
  "data": {
    "created_at": "2022-05-22T03:39:52.505458Z",
    "fee": {
      "amount": 1.72,
      "currency": "USDT"
    },
    "receive": {
      "amount": 170.69,
      "currency": "USDT",
      "network": "TRC20"
    },
    "ref": "jfd7gdv7gf7",
    "send": {
      "amount": 10000000,
      "currency": "NGN"
    },
    "status": "failed"
  },
  "event": "crypto.buy.failed",
  "id": "146154b1-0ac5-41f4-86c5-ca75f13e5b8c"
}

crypto.buy.success

This event occurs when buy crypto orders complete successfully

Example
JSON
{
  "data": {
    "created_at": "2022-05-22T03:39:52.505458Z",
    "fee": {
      "amount": 1.72,
      "currency": "USDT"
    },
    "receive": {
      "amount": 170.69,
      "currency": "USDT",
      "network": "TRC20"
    },
    "ref": "jfd7gdv7gf7",
    "send": {
      "amount": 10000000,
      "currency": "NGN"
    },
    "status": "success"
  },
  "event": "crypto.buy.success",
  "id": "146154b1-0ac5-41f4-86c5-ca75f13e5b8c"
}

crypto.deposit.success

This event occurs when crypto payment are received on any of the created deposit addresses.

Example
JSON
{
  "data": {
    "amount": "1255354",
    "asset": "BTC",
    "block_confirmations": 672,
    "block_height": 735787,
    "chain_timestamp": 1652199588,
    "fee": "85686",
    "from_address": "bc1qpjs7kysnns7u7epld48shq69czgms0jkpq2hv2",
    "memo": "",
    "meta": {
      "address_label": "USER ADDRESS LABEL",
      "aml_screen_pass": true,
      "amount_decimal": 8,
      "fee_decimal": 8
    },
    "network": "BTC",
    "ref": "KPT",
    "status": "success",
    "to_address": "33FfPdqdhKyuLXoc17kpBiU8GQ8u5SzeMu",
    "txid": "3750dbeb4dbc1b0fc5f8fc6740650a1ba26bc2f956028a3c9be79a368fa1b6f9",
    "wallet_ref": "KPT-3677776d7"
  },
  "event": "crypto.deposit.success",
  "id": "ee9a2f61-1f75-458b-8397-0857ab7ad71a"
}

crypto.sell.failed

This event occurs when sell crypto orders fail.

Example
JSON
{
  "data": {
    "created_at": "2022-05-22T03:39:52.505458Z",
    "fee": {
      "amount": 12,
      "currency": "USDT"
    },
    "receive": {
      "amount": 56316000,
      "currency": "NGN"
    },
    "ref": "jfd7gdv7gf7",
    "send": {
      "amount": 1000,
      "currency": "USDT",
      "network": "TRC20"
    },
    "status": "failed"
  },
  "event": "crypto.sell.failed",
  "id": "146154b1-0ac5-41f4-86c5-ca75f13e5b8c"
}

crypto.sell.success

This event occurs when sell crypto orders complete successfully.

Example
JSON
{
  "data": {
    "created_at": "2022-05-22T03:39:52.505458Z",
    "fee": {
      "amount": 12,
      "currency": "USDT"
    },
    "receive": {
      "amount": 56316000,
      "currency": "NGN"
    },
    "ref": "jfd7gdv7gf7",
    "send": {
      "amount": 1000,
      "currency": "USDT",
      "network": "TRC20"
    },
    "status": "success"
  },
  "event": "crypto.sell.success",
  "id": "146154b1-0ac5-41f4-86c5-ca75f13e5b8c"
}

crypto.withdrawal.failed

This event occurs when crypto payments that are sent from any of the created crypto wallets fails (i.e gets rejected on the blockchain).

Example
JSON
{
  "data": {
    "amount": "1255354",
    "asset": "BTC",
    "fee": "85686",
    "memo": "",
    "meta": {
      "aml_screen_pass": true,
      "amount_decimal": 8,
      "fee_decimal": 8
    },
    "network": "BTC",
    "ref": "KPT",
    "status": "failed",
    "to_address": "33FfPdqdhKyuLXoc17kpBiU8GQ8u5SzeMu",
    "wallet_ref": "KPT-3677776d7"
  },
  "event": "crypto.deposit.failed",
  "id": "ee9a2f61-1f75-458b-8397-0857ab7ad71a"
}

crypto.withdrawal.success

This event occurs when crypto payments that are sent from any of the created crypto wallets becomes successful (i.e gets at least 6 confirmations on the blockchain).

Example
JSON
{
  "data": {
    "amount": "1255354",
    "asset": "BTC",
    "block_confirmations": 672,
    "block_height": 735787,
    "chain_timestamp": 1652199588,
    "fee": "85686",
    "from_address": "bc1qpjs7kysnns7u7epld48shq69czgms0jkpq2hv2",
    "memo": "",
    "meta": {
      "aml_screen_pass": true,
      "amount_decimal": 8,
      "fee_decimal": 8
    },
    "network": "BTC",
    "ref": "KPT",
    "status": "success",
    "to_address": "33FfPdqdhKyuLXoc17kpBiU8GQ8u5SzeMu",
    "txid": "3750dbeb4dbc1b0fc5f8fc6740650a1ba26bc2f956028a3c9be79a368fa1b6f9",
    "wallet_ref": "KPT-3677776d7"
  },
  "event": "crypto.withdrawal.success",
  "id": "ee9a2f61-1f75-458b-8397-0857ab7ad71a"
}

This event is sent when flux users successfully link their accounts with a business via Kript Pay

Example
JSON
{
  "data": {
    "flux_id": "F1234",
    "flux_tag": "@username",
    "metadata": {
      "consumer_id": 1,
      "email": "bortus@orville.com",
      "name": "Peter Bortus",
      "phone_number": "09012562354"
    },
    "name": "John Doe",
    "permission_type": "ALLOW_ALL_DIRECT_CHARGES",
    "ref": "146154b1-0ac5-41f4-86c5-ca75f13e5b8c"
  },
  "event": "flux.account.link",
  "id": "146154b1-0ac5-41f4-g756-ca75f13e5b8c"
}

payment.charge.complete

This event occurs when either a bank or flux transfer payment is successfully made through the Kript Pay checkout

Example
JSON
{
  "data": {
    "amount": 1500000,
    "channel": "STANDARD",
    "charged_amount": 1500000,
    "currency": "NGN",
    "fee": 0,
    "fee_bearer": "PAYER",
    "paid_amount": 1500000,
    "paid_at": "2022-07-27T05:01:36+00:00",
    "payment_type": "FLUX_TRANSFER",
    "ref": "316745623457654",
    "settled_amount": 1500000,
    "status": "PAID"
  },
  "event": "payment.charge.complete",
  "id": "146154b1-0ac5-41f4-86c5-ca75f13e5b8c"
}

payment.charge.expired

This event occurs when either a bank or flux transfer payment is not made within an an hour and expires.

Example
JSON
{
  "data": {
    "amount": 1300000,
    "channel": "STANDARD",
    "charged_amount": 1318200,
    "currency": "NGN",
    "fee": 12000,
    "fee_bearer": "PAYER",
    "paid_amount": 0,
    "paid_at": null,
    "payment_type": "BANK_TRANSFER",
    "ref": "316745623457654",
    "settled_amount": 0,
    "status": "EXPIRED"
  },
  "event": "payment.charge.expired",
  "id": "146154b1-0ac5-41f4-86c5-ca75f13e5b8c"
}

payment.charge.incomplete

This even occurs when an amount less than the expected amount is paid via bank transfer.

Example
JSON
{
  "data": {
    "amount": 1300000,
    "channel": "STANDARD",
    "charged_amount": 1318200,
    "currency": "NGN",
    "fee": 12000,
    "fee_bearer": "PAYER",
    "paid_amount": 1200000,
    "paid_at": "2022-07-27T05:01:36+00:00",
    "payment_type": "BANK_TRANSFER",
    "ref": "316745623457654",
    "settled_amount": 1188000,
    "status": "INCOMPLETE"
  },
  "event": "payment.charge.incomplete",
  "id": "146154b1-0ac5-41f4-86c5-ca75f13e5b8c"
}

payment.charge.rejected

This event occurs when a direct charge request is rejected by the Flux user.

Example
JSON
{
  "data": {
    "amount": 1300000,
    "channel": "DIRECT_CHARGE",
    "charged_amount": 1318200,
    "currency": "NGN",
    "fee": 12000,
    "fee_bearer": "PAYER",
    "paid_amount": 0,
    "paid_at": null,
    "payment_type": "FLUX_TRANSFER",
    "ref": "316745623457654",
    "settled_amount": 0,
    "status": "REJECTED"
  },
  "event": "payment.charge.rejected",
  "id": "146154b1-0ac5-41f4-86c5-ca75f13e5b8c"
}

transfer.failed

This event occurs when transfers from your NGN balance to a Nigerian bank accounts fails

Example
JSON
{
  "data": {
    "account_name": "JOHN DOE",
    "account_number": "0123456789",
    "amount": 500000,
    "bank_code": "058",
    "bank_name": "GT BANK",
    "created_at": "1985-12-14T13:59:00+00:00",
    "currency": "NGN",
    "fee": 5000,
    "meta": {},
    "ref": "857875187q8f7q87584",
    "status": "failed"
  },
  "event": "transfer.failed",
  "id": "146154b1-0ac5-41f4-86c5-ca75f13e5b8c"
}

transfer.success

This event occurs when transfers from your NGN balance to a Nigerian bank accounts becomes successful.

Example
JSON
{
  "data": {
    "account_name": "JOHN DOE",
    "account_number": "0123456789",
    "amount": 500000,
    "bank_code": "058",
    "bank_name": "GT BANK",
    "created_at": "1985-12-14T13:59:00+00:00",
    "currency": "NGN",
    "fee": 5000,
    "meta": {},
    "ref": "857875187q8f7q87584",
    "status": "success"
  },
  "event": "transfer.success",
  "id": "146154b1-0ac5-41f4-86c5-ca75f13e5b8c"
}