Authorization Request

CLOWD9 will transmit an authorization request to your configured endpoint, for your decision, which is provided in the Authorization response.

In the event your response is not received in time, CLOWD9 will return a 100 - Do Not Honour response to the network / scheme.

Field	Value	Format	Mandatory
message_type	“authorization”	string	Yes
message_qualifier	“request”	string	Yes
source	Identifies the source of the message, such as the network: visa mastercard discover 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	Numerical value associated with the transaction_type	string	Yes
transaction_service	Identifies the type of service used	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	No - optional for Discover
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	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
revised_cardholder_billing_amount	The total amount for Authorization including any Product fees	string	no
revised_cardholder_billing_rate	The new rate to be used for International transactions if applicable. The markup % is added to the Network conversion rate to calculate the markup_conversion_rate	string	no
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
pan_entry_mode	Identifies the PAN entry method	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	No
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	string	No
fees
amount	The amount of the fee	string	No
type	The type of fee applied: fixed_fee variable_fee minimum_fee maximum_fee markup_fee	string	No
fees_amount	The total amount of fees to be applied to the Network cardholder_billing_amount. The revised_cardholder_billing_amount will include the total fees. This is independent of any Network fees	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	No
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	No
card_acceptor_country_code	The country the Merchant is registered in alpha (2-3)	string	Yes
card_acceptor_post_code	The Post code of the card acceptor entity	string	No
token_info
provider	Identifies the Token provider: apple google	string	No
ending	The last four digits of the DPAN	string	No