Incoming transactions

Overview

The Incoming transactions report shows incoming account operations. You can generate the report for all incoming transactions or for a specific incoming transaction type.

Status columns and possible values depend on the selected subtype. Statuses are captured when the report is generated; a previously downloaded file is not updated after a state changes.

When an incoming operation appears

The inclusion point depends on the selected subtype:

• All incoming transactions: a successful incoming operation appears after it has passed compliance and Calypso has recorded the account credit. A declined incoming transaction appears after Calypso records the declined transfer. Transactions whose compliance check is still pending are not yet included in this subtype.
• Only invoice transactions: an invoice appears as soon as its invoice record is saved, including while it is waiting for payment. The tr fields are populated later, after an incoming payment transaction is recorded, and the ct fields are populated after the account credit is recorded. Consequently, a newly generated report can contain an invoice row with empty transaction or credit fields.
• Only fiat transactions: a fiat operation appears after its fiat order is saved. If the order includes a payout to an external wallet, it is omitted while that external payout is in a non-terminal state and appears after the payout is completed.
• Only customers transactions: an operation appears after the customer purse transaction record is saved. Its current transaction and compliance states are returned at generation time.

These subtypes read current source records on demand and do not wait for a scheduled reporting import.

All incoming transactions

Field	Description
Transaction ID	Identification number of the transaction
External ID	Identification number added by the merchant when creating the invoice
Amount	Amount of funds received in the stated currency
Currency	Cryptocurrency used for the incoming transaction
Fiat Amount	Incoming transaction amount converted to fiat currency
Fiat Currency	Selected fiat currency
Type	Operation type. Use it to separate invoices from top-ups
Date of creation	When the operation was created
Service fee	Service fee paid to Calypso Pay for the operation
Invoice ID	Identification number of the invoice
Transaction hashes	Hashes of the transactions incoming to the invoice
Contact	Contact name from the address book
Transaction comment	Transaction comment
Author	Transaction comment author
Fixed fee	Fixed fee
Percent fee	Percent fee
Address from	Sender's address
Adjustment	Adjustment flag
Date of adjustment	Adjustment date
Sum after adjustment	Transaction amount after adjustment
Adjustment reason	Reason for adjustment
Compliance state	Compliance check status

The All incoming transactions report does not contain a general transaction State column. It contains Compliance state with these values:

Value	Meaning
DECLINE	The transaction failed the compliance check.
CHECKED	The compliance check completed successfully.

Operations with UNCHECKED or IN_PROGRESS compliance states are not included in this subtype yet. Use Only invoice transactions or Only customers transactions when you need the earlier lifecycle state supported by those report types.

Only invoice transactions

Field	Description
Invoice Creation Date	Invoice creation date
Invoice Type	Type of invoice created
Invoice ID	System invoice identifier
Invoice External ID	External invoice identifier provided by the merchant
Invoice Idempotency Key	Idempotency key, unique identifier
Invoice State	Invoice status
Invoice Currency	Invoice cryptocurrency
Invoice Amount	Invoice amount in cryptocurrency
Invoice Fiat Currency	Invoice fiat currency
Invoice Fiat Amount	Invoice amount in fiat currency
Intervention	Intervention flag
tr Create Date	Invoice transaction creation date
tr ID	System invoice transaction identifier
tr Hash	Transaction hash
tr Contact	Sender's contact from the address book
tr Address from	Sender's address
tr Address to	Invoice address
tr Type	Invoice transaction type
tr Amount	Invoice transaction crypto amount
tr Fiat Amount	Invoice transaction fiat amount
tr State	Invoice transaction state
ct Create Date	Date of creation of accrual for paid invoice
ct ID	Account charge ID for a paid invoice
ct Amount	Amount credited to the account for a paid invoice
ct Service Fee	Commission for paid invoice

Invoice State can contain:

Value	Meaning
MEM_POOL_FOUND	A payment transaction was detected in the mempool.
PENDING_PAYMENT	The invoice is waiting for payment.
PAID	The required payment was received.
COMPLETED	Invoice processing completed.
PENDING_INTERVENTION	The invoice requires merchant action, for example after an overpayment or underpayment.
CANCEL	The invoice was canceled.
ARCHIVED	The invoice was archived.
DECLINED	The invoice or its payment was declined.
PENDING_COMPLIANCE_CHECK	The payment is undergoing a compliance check.
REVERSED	The invoice operation was reversed.

tr State describes the incoming blockchain transaction and can contain:

Value	Meaning
MEM_POOL_FOUND	The transaction was detected in the mempool.
PENDING_COMPLIANCE_CHECK	The transaction is undergoing a compliance check.
CONFIRMED	The transaction was confirmed successfully.
DECLINED	The transaction failed the compliance check.

Only fiat transactions

Field	Description
Create Date	Fiat order creation date
ID	Fiat order system identifier
Merchant External ID	The fiat order identifier provided by the merchant when it was created
Fiat Currency	Fiat currency of the order
Fiat Amount	Fiat amount of the order
Crypto Currency	Crypto currency of the order
Crypto Amount	Crypto amount of the order
Fee	Commission amount for a paid fiat order
State	Fiat order status
Description	Comment to fiat order
Adjusted	Flag indicating the presence of an adjustment

State can contain the following fiat order statuses:

Value	Meaning
CREATED	The fiat order was created.
IN_PROGRESS	The order is being processed.
PAID	The customer's fiat payment was received.
DEPOSIT_COMPLETED	The cryptocurrency deposit was credited to the Calypso account.
EXTERNAL_WITHDRAWAL_IN_PROGRESS	Withdrawal to the external address is in progress.
PAUSED	External withdrawal requires attention or cannot be completed automatically.
COMPLETED	Fiat order processing completed.
FAILED	Payment or order processing failed.
EXPIRED	The customer did not pay before the order expired.

If you specified an address for payout to an external wallet when creating a fiat order, please review the following parameters:

Field	Description
Payout Currency	Payout currency sent to an external address for fiat orders
Payout Amount	Payout amount sent to an external address for fiat orders
Payout Address	Recipient's address
Payout Hash	Payout hash
Payout Service Fee	Commission amount

Only customers transactions

Field	Description
Created date	Transaction creation date
Transaction ID	System transaction identifier
Hash	Blockchain transaction hash
State	Transaction state
Compliance state	Compliance state
Currency	Crypto currency of the transaction
Amount	Crypto amount
Customer ID	System identifier of the customer
Customer external ID	External identifier of the customer
Purse ID	Deposit address system identifier
Purse state	Deposit address state
Deposit address	Deposit address

State and Compliance state use the following combinations:

State	Compliance state	Meaning
MEM_POOL_FOUND	UNCHECKED	The transaction was detected in the mempool. This state is not guaranteed to occur.
PENDING_COMPLIANCE_CHECK	IN_PROGRESS	The transaction is undergoing a compliance check.
DECLINED	DECLINE	The transaction failed the compliance check.
CONFIRMED	CHECKED	The transaction was confirmed successfully.