Authorization Notification

message_type

“authorization”

string

Yes

message_qualifier

“notification”

string

Yes

source

Identifies the source of the message, such as the network:
"visa"
"mastercard"
"clowd9"

string

Yes

card

Contains vital information about the card as held in the CLOWD9 database.

card_id

The Identifier of the card associated to the authorization request

uuid

Yes

card_ending

The last four digits of the PAN

string

Under Development

card_form_factor

Form factor of card. Supported values:

“physical”
“virtual”

string

Yes

card_status

Shows the current status of the card that is sent during the authorization process or following a successful status change.

Supported values for use:

"inactive"
“active”
"administrative"
“destroyed”
"fraud"
"freeze"
"lost"
“stolen”

Status values for CLOWD8 use only:
"expired"
"risk"

string

No

card_prev_status

Previous status of the card. Only present when card status changes.

Supported values for use:

"inactive"
“active”
"administrative"
“destroyed”
"fraud"
"freeze"
"lost"
“stolen”

Status values for CLOWD9 use only:

"expired"
"risk"

string

No

card_status_change_reason

Free-text field giving insight into the reason for the card status change.

string

No

customer

Contains vital information about the customer as held in the CLOWD9 database.

customer_id

The ID of the customer associated with the card.

uuid

Yes

customer_external_ref

External ID of the customer associated with the card, if known.

string

No

account

Contains vital information about the account as held in the CLOWD9 database.

account_id

The ID of the account related to the transaction or message.

uuid

Not applicable for Off Ledger

account_currency_code

The ISO currency code of the account.
Note: This may have implications to the decimal place in the transaction amount and balances fields.

string(3)

Not applicable for Off Ledger

amount_in_account_currency

The transaction amount in the account currency as applied against the account.

string

Not applicable for Off Ledger

balance_before

Balance of the account prior to the transaction.

string

Not applicable for Off Ledger

balance_after

Balance of the account after the transaction.

string

Not applicable for Off Ledger

transaction

Details of the transaction.

auth_type

Used to identify the type of an authorization message:
"preauth",
"incremental",
"completion",
"recurring_initial"
"recurring_subsequent", or
"anticipated_amount_verification"

string

No

credential_on_file

Indicates if the transaction was a credential on file transaction. Supported values:

“y”
"n"

string

No

reversal_type

Used to identify the type of a reversal message. Supported values:

"full"
"partial"

string

No

transaction_type

Used to identify the type of service used

string

Yes

transaction_service

Numerical value associated with the transaction_type

string

Yes

transaction_id

The unique identifier of the transaction log entry in the CLOWD9 database.

uuid

Yes

system_trace_audit_number

The System Trace Audit Number for the network message if present/applicable.

string

Yes

retrieval_reference_number

The Retrieval Reference Number for the network message if present/applicable.

string

Yes

network_transaction_id

The unique identifier of the transaction assigned by the network, such as Visa TID

string

Yes

transmission_date

The date the message was received, as indicated in the message from the network

string (MMDD)

Yes

transmission_time

The time the message was received, as indicated in the message from the network

string (hhmmss)

Yes

transaction_amount

The amount to be authorized with the transaction. Can be “0” for non-financial messages.
Note: we only accept integers format

string

Yes

transaction_currency_code

The ISO currency code in which transaction_amount is represented

string (3)

Yes

cardholder_billing_amount

The amount to be billed against the cardholder’s account, if the transaction currency is different to card settlement currency.
Note: we only accept integers format

string

Yes

cardholder_billing_currency_code

The ISO currency code in which cardholder_billing_amount is represented

string (3)

Yes

cardholder_billing_conversion_rate

The conversion rate used to calculate cardholder_billing_amount from transaction_amount

string

Yes

transaction_fee_amount

The amount of the transaction fee. Note that this is already accounted for in transaction_amount

string

No

transaction_fee_program

Name of the fee configuration that was used to calculate transaction_fee_amount

string

No

from_account

The source account type of the transaction request. Valid values:

“default”
“savings”
“checking”
“credit”

string

No

to_account

The destination account type of the transaction request. Valid values:

“default”
“savings”
“checking”
“credit”

string

No

from_account_id

The source account ID in the CLOWD9 database, if known

string

No

to_account_id

The destination account ID in the CLOWD9 database, if known

string

No

update

Used in transactions where context from original/previous transaction is of relevance, such as reversals or pre-auth completion messages

original_message_type

The Message Type from the related transaction

string

original_message_qualifier

The Message Qualifier from the related transaction

string

No

original_transaction_id

The CLOWD9 transaction log identifier of the related transaction

uuid

No

original_system_trace_audit_number

The System Trace Audit Number from the related transaction

string

No

original_retrieval_reference_number

The Retrieval Reference Number from the related transaction

string

No

original_transmission_date

The date the related transaction was received

string (MMDD)

No

original_transmission_time

The time related to when transaction was received

string

No

original_transaction_amount

The Transaction Amount from the related transaction

string

No

actual_transaction_amount

The Actual Transaction Amount to be applied in a partial reversal

string

No

eci

E-Commerce authentication indicator. For an e-commerce transaction, when available, identifies the various security measures applied before transaction submission. Possible values:

"0" - Not applicable to the transaction
"1" - Single transaction of mail/phone order
"2" - Recurring transaction
"3" - Instalment payment
"4" - Mail/Telephone order type unknown
“5” - Fully authenticated
“6” - Authentication attempted but unsuccessful
"7" - Authentication not attempted
"8" - Non-secure transaction

string

No

dcc_indicator

Indicates whether Dynamic Currency Conversion took place. Possible values:

“y”
“n”

string

No

chip_indicator

Indicates if the transaction was an ICC transaction, and if so contact or contactless. Possible values:

“n”
“contact”
“contactless”

string

No

pin_indicator

Indicates whether the PIN for the transaction was checked, its nature and the result. Possible values:

“n”
“offline_passed”
“offline_failed”
“online_passed”
“online_failed”

string

No

3ds_indicator

Indicates whether 3D-Secure Authentication took place for this transaction. Possible values:

“y”
“n”

string

No

avs_outcome

Provides information on the outcome of Address Verification performed by CLOWD9. For a list of possible values, refer to the CLOWD9 AVS Codes:

"m" Both match
"a" Address match only
"p" Post code match only
"n" Neither match
"r" Error while processing

string

No

partial_approval_supported

Indicates whether Partial Approval is supported. Possible values:

“y”
“n”

string

No

cardholder_condition

Cardholder condition indicator provided during the authorization. Possible values are:

“00” card holder present, normal transaction
“01” card holder not present
“02” card holder present
“03” card present, suspicious activity
“05” card holder present
“08” card holder not present, mail or telephone order
“59” card holder not present, electronic order (ecommerce)
“71” card holder present (Used in US only)

string

No

status

response_code

Response code numeric value used by CLOWD9 and you for the final outcome of the request.

string

Yes

response_source

Indicates the source of the response_code value. Possible values:

“scheme”
“clowd9”

string

Yes

response_reason

The alpha description associated to the response_code

string

Yes

authorization_code

The authorization code associated with the authorization notification if received or generated by CLOWD9

string

No

transaction_link_id

The Identifier of the transaction assigned by the network. The Identifier will be provided in all future Financial messages.
Reserved for future use for Visa

string

No

acquirer

Information about the entity and point of transaction capture

acquiring_institution_id_code

The identification code of the Acquiring Institution

string

Yes

acquiring_institution_country_code

The ISO country code of the Acquiring Institution

string

Yes

merchant_category_code

The Merchant Category Code

string

Yes

card_acceptor_terminal_id

The identifier of the terminal where the transaction took place

string

Yes

card_acceptor_id

The identifier of the card acceptor entity

string

Yes

card_acceptor_name

The name of the card acceptor entity

string

Yes

card_acceptor_city

The city of the card acceptor entity

string

Yes

card_acceptor_country_code

The country of the card acceptor entity

string

Yes

card_acceptor_post_code

The Post code of the card acceptor entity

string

Yes