Webhook payload

Webhook payload example

{
  "requestId": "bf9348b7-2c14-46d7-868c-b597852da319",
  "id": 1,
  "createdDate": "2022-03-15T12:13:05.909616",
  "level": "SUCCESS",
  "service": "INVOICE",
  "eventType": "INVOICE_CREATE_INVOICE",
  "data": {
    "parentExternalId": 3,
    "amount": 0.01,
    "currency": "ETH",
    "fiatcurrency": "USD",
    "message": "Invoice example",
    "createdDate": "2022-03-15T12:13:03.157015",
    "type": "INVOICE_CREATE_INVOICE",
    "idempotencyKey": "5b0ca8da-6af4-4a1c-9efd-5cbfc19ace09"
  }
}

Webhooks deliver the responses to your service in JSON format. The parameters that webhook payload inсludes are listed in the table below.

Parameter	Type	Mandatory	Description
requestId	string	Yes	id of the request that created webhook subscription.
id	number	Yes	id of the event.
createdDate	string	Yes	creation date of the event.
level	string	Yes	level of the notification for the event. [SUCCESS, INFO, WARNING]
service	string	Yes	group of events which the event belongs to.
data	object	Yes	set of data depending on the event type. See list of field for each event type below.

Data object depending on event type

INVOICE_CREATE_INVOICE

Parameter	Type	Description
type	string	event type: INVOICE_CREATE_INVOICE
amount	number	money amount of the created invoice.
message	string	text of the invoice.
currency	string	crypto currency of the invoice. [BNB, BTC, DAI, ETH, FRAX, MATIC, TRX, USDC, USDT, USDT_MATIC, USDT_TRX, USDC_TRX, XDG, USDT_BSC]
fiatCurrency	string	fiat currency of the invoice. [USD, EUR, RUB, AED, ARS, AUD, AZN, BOB, BRL, BYN, CAD, CLP, COP, CRC, CZK, EGP, GHS, GTQ, HKD, HNL, IDR, INR, JPY, KES, KHR, KRW, KZT, MMK, MXN, MYR, NGN, NOK, NZD, PEN, PHP, PLN, RON, SAR, SEK, SGD, THB, TRY, TWD, UAH, UGX, UZS, VES, VND, XAF, XOF, ZAR]
parentExternalId	number	system id of the invoice.
createdDate	string	date and time of invoice creation
idempotencyKey	string	the external id that was generated while invoice creating through api.
externalId	string	merchant ID of invoice

INVOICE_CREATE_UNLIMITED_INVOICE

Parameter	Type	Description
type	string	event type: INVOICE_CREATE_UNLIMITED_INVOICE
message	string	text of the invoice.
currency	string	crypto currency of the invoice. [ BNB, BTC, DAI, ETH, FRAX, MATIC, TRX, USDC, USDT, USDT_MATIC, USDT_TRX, USDC_TRX, XDG, USDT_BSC ]
parentExternalId	number	system id of the invoice.
createdDate	string	date and time of invoice creation
idempotencyKey	string	the external id that was generated while invoice creating through api.
externalId	string	merchant ID of invoice

INVOICE_FUNDS_RECEIVED_FOR_INVOICE

Parameter	Type	Description
type	string	event type: INVOICE_FUNDS_RECEIVED_FOR_INVOICE
amount	number	amount of received money to invoice wallet.
transactionId	array	System ID of the invoice deposits.
message	string	text of the invoice.
currency	string	crypto currency of the invoice. [ BNB, BTC, DAI, ETH, FRAX, MATIC, TRX, USDC, USDT, USDT_MATIC, USDT_TRX, USDC_TRX, XDG, USDT_BSC ]
parentExternalId	number	system id of the invoice.
idempotencyKey	string	the external id that was generated while invoice creating through api.
createdDate	string	date and time of invoice creation.
senderAddress	string	wallet address from where funds were sent.
invoiceAddress	string	invoice address to which funds were received.
externalId	string	merchant ID of invoice
paymentDate	string	date of deposit transaction creation.
transactionHash	string	hash of the deposit transaction.
fiatAmount	object	invoice amount in fiat currency. Example: "fiatAmount":{"EUR":31.994837336,"USD":36.844106264}

INVOICE_PENDING_INTERVENTION

Parameter	Type	Description
type	string	Event type: INVOICE_PENDING_INTERVENTION
message	string	text of the invoice.
parentExternalId	number	system id of the invoice.
idempotencyKey	string	the external id that was generated while invoice creating through api.
externalId	string	merchant ID of invoice

INVOICE_TRANSLATION_TO_ACCOUNT_COMPLETED

Parameter	Type	Description
type	string	event type: INVOICE_TRANSLATION_TO_ACCOUNT_COMPLETED
amount	number	money amount of the invoice.
message	string	text of the invoice.
currency	string	crypto currency of the invoice. [ BNB, BTC, DAI, ETH, FRAX, MATIC, TRX, USDC, USDT, USDT_MATIC, USDT_TRX, USDC_TRX, XDG, USDT_BSC ]
parentExternalId	number	system id of the invoice.
createdDate	string	date and time of invoice creation.
idempotencyKey	string	the external id that was generated while invoice creating through api.
serviceFee	number	service fee for invoice deposit.
fiatAmount	object	invoice amount in fiat currency. Example: "fiatAmount":{"EUR":31.994837336,"USD":36.844106264}
transactionIds	array	system IDs of deposits for invoice. Always one ID in unlimited invoices, usually one ID in single invoices, but may be more IDs if intervention occurred.

INVOICE_EXPIRED

Parameter	Type	Description
type	string	Event type: INVOICE_EXPIRED
parentExternalId	number	system id of the invoice.
idempotencyKey	string	the external id that was generated while invoice creating through api.
amount	number	money amount of the invoice.
currency	string	crypto currency of the invoice. [ BNB, BTC, DAI, ETH, FRAX, MATIC, TRX, USDC, USDT, USDT_MATIC, USDT_TRX, USDC_TRX, XDG, USDT_BSC ]
fiatCurrency	string	fiat currency of the invoice. [USD, EUR, RUB, AED, ARS, AUD, AZN, BOB, BRL, BYN, CAD, CLP, COP, CRC, CZK, EGP, GHS, GTQ, HKD, HNL, IDR, INR, JPY, KES, KHR, KRW, KZT, MMK, MXN, MYR, NGN, NOK, NZD, PEN, PHP, PLN, RON, SAR, SEK, SGD, THB, TRY, TWD, UAH, UGX, UZS, VES, VND, XAF, XOF, ZAR]
message	string	description of the invoice.
createdDate	string	date and time of invoice creation.
expirationDate	string	date and time of invoice expiration.
externalId	string	merchant ID of invoice
fiatAmount	object	invoice amount in fiat currency. Example: "fiatAmount":{"EUR":31.994837336,"USD":36.844106264}

INVOICE_PAID

Parameter	Type	Description
amount	number	money amount of the invoice.
currency	string	crypto currency of the invoice. [ BNB, BTC, DAI, ETH, FRAX, MATIC, TRX, USDC, USDT, USDT_MATIC, USDT_TRX, USDC_TRX, XDG, USDT_BSC ]
description	string	description of the invoice.
externalId	string	merchant ID of invoice
fiatAmount	number	amount in fiat currency if it was set in fiat.
fiatCurrency	string	fiat currency of the invoice if it was set in fiat. [ USDT, EUR ]
idempotencyKey	string	the external id that was generated while invoice creating through api.
parentExternalId	number	system id of the invoice.
realAmount	number	amount of money that client really paid for the invoice.
type	string	Event type: INVOICE_PAID.

INVOICE_MEMPOOL_FOUND

Parameter	Type	Description
amount	number	money amount of the invoice.
currency	string	crypto currency of the invoice. [ BNB, BTC, DAI, ETH, FRAX, MATIC, TRX, USDC, USDT, USDT_MATIC, USDT_TRX, USDC_TRX, XDG, USDT_BSC ]
description	string	description of the invoice.
externalId	string	merchant ID of invoice
fiatAmount	number	amount in fiat currency if it was set in fiat.
fiatCurrency	string	fiat currency of the invoice if it was set in fiat. [ USDT, EUR ]
idempotencyKey	string	the external id that was generated while invoice creating through api.
parentExternalId	number	system id of the invoice.
realAmount	number	amount of money that client really paid for the invoice.
type	string	Event type: INVOICE_MEMPOOL_FOUND.
createdDate	string	date and time of invoice creation.
transactionHash	string	hash of the incoming transaction to the invoice wallet.

FIAT_APPLIER_FIAT_FUNDS_RECEIVED

Parameter	Type	Description
parentExternalId	number	system id of the fiat order.
idempotencyKey	string	the external id that was generated while fiat order creating through api.
fiatAmount	string	amount in fiat currency that was received after payment.
fiatCurrency	string	fiat currency of the fiat order
rate	number	rate of fiat order

FIAT_APPLIER_ORDER_UNPAID

Parameter	Type	Description
parentExternalId	number	system id of the fiat order.
idempotencyKey	string	the external id that was generated while fiat order creating through api.
reasonType	string	order expiration reason - "EXPIRED"

FIAT_APPLIER_PAYMENT_FAILED

Parameter	Type	Description
parentExternalId	number	system id of the fiat order
idempotencyKey	string	the external id that was generated while fiat order creating through api
reason	string	reason for fiat order payment failed

FIAT_APPLIER_ADJUSTMENT

Parameter	Type	Description
parentExternalId	number	system id of the fiat order
idempotencyKey	string	the external id that was generated while fiat order creating through api
adjustmentDate	string	date of adjustment
sumAfterAdjustment	number	amount received in adjustment
reason	string	reason for fiat order adjustment
currency	string	currency of adjustment
fiatCurrency	string	is fiat currency adjustment ? (true/false)

FIAT_APPLIER_WITHDRAWAL_SUCCESS

Parameter	Type	Description
rate	number	rate of c2f order
type	string	event type
state	string	c2f order state
orderId	string	c2f order id
currency	string	crypto currency of the с2f order
externalId	string	merchant ID of c2f order
fiatAmount	number	fiat amount of the с2f order
fiatCurrency	string	fiat currency of the с2f order
idempotencyKey	string	the external id that was generated while fiat order creating through api.
parentExternalId	number	system id of the c2f order

FIAT_APPLIER_WITHDRAWAL_FAILED

Parameter	Type	Description
state	string	c2f order state
type	string	event type
state	string	c2f order state
orderId	string	c2f order id
externalId	string	merchant ID of c2f order
idempotencyKey	string	the external id that was generated while fiat order creating through api.
reason	string	reason for c2f order failed
parentExternalId	number	system id of the c2f order

CUSTOMER_PURSE_EXPIRED

Parameter	Type	Description
customerId	string	system id of the customer
customerBlocked	boolean	customer block status
purseId	string	system id of the purse (address)

CUSTOMER_PURSE_MEM_POOL_FOUND

Parameter	Type	Description
currency	number	currency of the transaction
customerId	string	system id of the customer
customerBlocked	boolean	customer block status
purseId	string	system id of the purse (address)
transactionId	number	system id of the transaction
amount	number	transaction amount
senderAddress	string	transaction sender address
createdDate	string	transaction creation date
transactionHash	string	transaction hash from the blockchain

CUSTOMER_PURSE_PENDING_COMPLIANCE

Parameter	Type	Description
currency	string	currency of the transaction
customerId	string	system id of the customer
customerBlocked	boolean	customer block status
purseId	string	system id of the purse (address)
transactionId	string	system id of the transaction
amount	number	transaction amount

CUSTOMER_PURSE_COMPLIANCE_DECLINED

Parameter	Type	Description
currency	string	currency of the transaction
customerId	string	system id of the customer
customerBlocked	boolean	customer block status
purseId	string	system id of the purse (address)
transactionId	string	system id of the transaction
amount	number	transaction amount

CUSTOMER_PURSE_FUNDS_RECEIVED_FOR_PURSE

Parameter	Type	Description
currency	string	currency of the transaction
customerId	string	system id of the customer
customerBlocked	boolean	customer block status
purseId	string	system id of the purse (address)
transactionId	string	system id of the transaction
amount	number	transaction amount
senderAddress	string	transaction sender address
transactionHash	string	transaction hash from the blockchain
createdDate	string	transaction creation date

PAYOUT_CHANGE_STATUS

Parameter	Type	Description
hash	string	transaction hash.
type	string	event type: PAYOUT_CHANGE_STATUS.
parentExternalId	number	system id of the payout.
createdDate	string	date and time of payout creation.
payoutStatus	string	current state of the payout.
idempotencyKey	string	the external id that was generated while payout creating through api.
currency	string	currency of the payout.

PAYOUT_CONFIRMED

Parameter	Type	Description
type	string	event type: PAYOUT_CONFIRMED.
parentExternalId	number	system id of the payout.
createdDate	string	date and time of payout creation.
approved	array	list of users who approved the payout.
idempotencyKey	string	the external id that was generated while payout creating through api.
currency	string	currency of the payout

PAYOUT_VALIDATION_ERROR

Parameter	Type	Description
type	string	event type: PAYOUT_VALIDATION_ERROR.
parentExternalId	number	system id of the payout.
message	string	validation error message.
createdDate	string	date and time of payout creation.
dealWithdrawalId	number	system id of withdrawal where validation error occured.
validationStatus	string	the reason of validation error.
idempotencyKey	string	the external id that was generated while payout creating through api.
currency	string	currency of the payout.

INVOICE_COMPLIANCE_CHECK

Parameter	Type	Description
type	string	event type: INVOICE_COMPLIANCE_CHECK
amount	number	amount of received money to invoice wallet.
transactionId	array	System ID of the invoice deposits.
message	string	text of the invoice.
currency	string	currency of the invoice.
parentExternalId	number	system id of the invoice.
createdDate	string	date and time of invoice creation.
senderAddress	string	wallet address from where funds were sent.
idempotencyKey	string	the external id that was generated while invoice creating through api.
externalId	string	merchant ID of invoice
paymentDate	string	date of deposit transaction creation.
transactionHash	string	hash of the deposit transaction.
fiatAmount	object	invoice amount in fiat currency. Example: "fiatAmount":{"EUR":31.994837336,"USD":36.844106264}

INVOICE_COMPLIANCE_DECLINED

Parameter	Type	Description
type	string	event type: INVOICE_COMPLIANCE_DECLINED
amount	number	amount of received money to invoice wallet.
transactionId	array	System ID of the invoice deposits.
message	string	text of the invoice.
currency	string	currency of the invoice.
parentExternalId	number	system id of the invoice.
createdDate	string	date and time of invoice creation.
senderAddress	string	wallet address from where funds were sent.
idempotencyKey	string	the external id that was generated while invoice creating through api.
externalId	string	merchant ID of invoice
paymentDate	string	date of deposit transaction creation.
transactionHash	string	hash of the deposit transaction.
fiatAmount	object	invoice amount in fiat currency. Example: "fiatAmount":{"EUR":31.994837336,"USD":36.844106264}

TOP_UP_COMPLIANCE_CHECK

Parameter	Type	Description
type	string	event type: TOP_UP_COMPLIANCE_CHECK
amount	number	amount of received money to invoice wallet.
currency	string	currency of the invoice.
senderAddress	string	wallet address from where funds were sent.
paymentDate	string	date of deposit transaction creation.
transactionHash	string	hash of the deposit transaction.
fiatAmount	object	invoice amount in fiat currency. Example: "fiatAmount":{"EUR":31.994837336,"USD":36.844106264}

TOP_UP_COMPLIANCE_DECLINED

Parameter	Type	Description
type	string	event type: TOP_UP_COMPLIANCE_DECLINED
amount	number	amount of received money to invoice wallet.
currency	string	currency of the invoice.
senderAddress	string	wallet address from where funds were sent.
paymentDate	string	date of deposit transaction creation.
transactionHash	string	hash of the deposit transaction.
fiatAmount	object	invoice amount in fiat currency Example: "fiatAmount":{"EUR":31.994837336,"USD":36.844106264}

WALLET_FUNDS_DELIVERED_ACCOUNT

Parameter	Type	Description
type	string	event type: WALLET_FUNDS_DELIVERED_ACCOUNT
amount	number	amount of received money
currency	string	currency of the invoice.
senderAddress	string	wallet address from where funds were sent.
paymentDate	string	date of deposit transaction creation.
transactionHash	string	hash of the deposit transaction.
fiatAmount	object	invoice amount in fiat currency. Example: "fiatAmount":{"EUR":31.994837336,"USD":36.844106264}