Authorization Request

message_type

“authorization”

string

Yes

message_qualifier

“request”

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_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 CLOWD9 use only:
"expired"
"risk"

string

Yes

card_ending

The last four digits of the PAN

string

Under Development

customer

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

customer_id

The Identifier of the Customer associated with the card

uuid

Yes

customer_external_ref

External ID of the customer associated with the card, if held

string

No

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, either:
“y”
"n"

string

Yes

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

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_local_date

The local date at the point of transaction origination

string (MMDD)

No

transaction_local_time

The local time at the point of transaction origination

string (hhmmss)

No

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: Integer format is required

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

Represents the transaction fee charged by a Card Acceptor (Merchant), beginning with “C” for Credit and “D” for Debit. This is represented in the Product base currency, with 2 decimal places

string

No

from_account

The source account type of the transaction request:
“default”,
“savings”,
“checking”, or
“credit”

string

Yes

to_account

The destination account type of the transaction request:
“default”,
“savings”,
“checking”, or
“credit”

string

Yes

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

Conditional

dcc_indicator

Indicates whether Dynamic Currency Conversion took place, either
“y”, or
“n”

string

Yes

chip_indicator

Indicates if the Integrated Chip Card was used:
“n”,
“contact”, or
“contactless”

string

Yes

pin_indicator

Indicates whether the PIN for the transaction was checked, its nature and the result:
“n”,
“offline_passed”,
“offline_failed”,
“online_passed”, or
“online_failed”

string

Yes

3ds_indicator

Indicates whether 3D-Secure Authentication took place for this transaction, either
“y”, or
“n”

string

Yes

avs_outcome

Provides the outcome of the Address Verification Service performed by CLOWD9:
"m" Both match
"a" Address match only
"p" Post code match only
"n" Neither match
"r" Error while processing

string

Yes

sca_indicator

Identifies if one of the SCA limits has been exceeded, requiring further authentication.
"y", Limit has been exceeded and response_code will be 120
"n", Limit has not been exceeded or the transaction is exempt

string

No

partial_approval_supported

Indicates whether Partial Approval is supported, either
“y”
“n”

string

Yes

cardholder_condition

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

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

string

Yes

authorization_code

A six digit code generated by CLOWD9, associated with the authorization request

string

Yes

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

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

acquirer

Information about the Merchant and their Acquiring Institution at point of transaction capture

acquiring_institution_id_code

The identification code of the Merchants Acquiring Institution

string

Yes

acquiring_institution_country_code

The ISO country code of the Merchants Acquiring Institution

string

Yes

merchant_category_code

The Merchant Category Code, numeric (4)

string

Yes

card_acceptor_terminal_id

The identifier of the Merchant terminal

string

Yes

card_acceptor_id

The identifier of the Merchant

string

Yes

card_acceptor_name

The name of the Merchant

string

Yes

card_acceptor_city

The city where the Merchant is registered

string

Yes

card_acceptor_country_code

The country the Merchant is registered in alpha (2)

string

Yes

card_acceptor_post_code

The Post code of the card acceptor entity

string

No