Remote Host Authorization

Remote Host Authorization (RHA) is a functionality that provides you as an on-boarding partner, the capability to authorize (or forbid) real-time transactions.

When a cardholder attempts to make a card transaction using an account configured on ISAC system, the following process occurs:

1. The merchant sends an authorization message to the card network.

2. The card network sends an authorization message to the ISAC platform.

3. The ISAC platform authenticates and authorizes the transaction.

4. ISAC platform forwards the authorization request to the remote host.

5. The remote host authorizes the request and sends the transaction response.

6. The response received from the remote host is mapped to the network's response code and is sent to the network.

7. Finally, the ISAC platform sends the transaction notification to the webhook endpoint.

Transaction Flow

To configure RHA, you must follow the below steps:

1. Send a one-on-one email to Happay POC, containing a username, password, and URL.

2. This URL must be configured to accept a POST request and validate it using basic authentication.

3. The request timeout is set to 4 seconds, so make sure you perform all your operations within the timeout duration.

4. You must respond back with either of the following http status codes. Any other statuses will be treated as the Remote Host’s server fault and the Happay platform will deny this transaction.

   • 200 - Transaction Approved By Remote Host

   • 402 - Transaction Denied By Remote Host

5. For Balance Enquiry transactions, you are expected to send 200 http status code and balance in the response. A sample response is mentioned below

RHA Request

{
	"transaction_id": "txn_379c86ce2b494a1bae03f0fab8f",
	"card_id": "crd_5e8856b0c9a24272b8250992f4a4",
	"account_id": "acc_91a6377961f77a7b1e2574bf",
	"txn_date": "2020-01-20T12:10:44.342339Z",
	"txn_type": "AUTH",
	"txn_code": "DEBIT",
	"channel": "POS",
	"mcc": "5999",
	"mid": "ABC123TESTMTF19",
	"rrn": "080000000013",
	"stan": "HAKUU32423",
	"terminal_id": "MTF TEST",
	"aid": "999901",
	"acquiring_details": {
		"amount": 1000,
		"currency": {
			"alpha_code": "USD",
			"numeric_code": 356,
			"exponent": 2
		},
		"fee_details": {
			"fee_applicable": true,
			"fee_type": "DEBIT",
			"amount": 100,
			"currency": {
				"alpha_code": "USD",
				"numeric_code": 840,
				"exponent": 2
			}
		}
	},
	"transaction_details": {
		"amount": 80000,
		"currency": {
			"alpha_code": "INR",
			"numeric_code": 356,
			"exponent": 2
		},	
	},
	"merchant": {
		"name": "Misc Retail",
		"city": "Vegas",
		"state": " N",
		"country": "V ",
		"formatted_name": "Misc Retail/Vegas/ N/V "
	},
	"authentication_details": {
		"pin_verified": true,
		"cvv_verified": true
	},
	"pan_entry_mode": "POS",
	"location": "DOM",
	"is_pre_auth": true,
	"is_dcc": true,
	"is_afd_applicable": false,
	"sub_txn_type": {
		"txn_condition": "EMI_TRANSACTION",
		"mandate": {
			"is_applicable": true,
			"txn_type": "DEREGISTER_MANDATE",
			"number_of_instalments": "1",
			"init_date": "02",
			"min_amount": "000000000500",
			"max_amount": "000000001000",
			"start_date": "02072023",
			"end_date": "01082024",
			"mode": "SMS_AND_EMAIL",
			"freq_indicator": "MONTHLY",
			"txn_id": "si_123frn5i55vtn454"
		},
		"emi": {
			"is_applicable": true,
			"total_amount": "000000001000",
			"amount": "000000000500",
			"number_of_instalments": "02",
			"interest_rate": "06.50"
		}
	}
}

RHA Response

{
    "balance": 200000 // representation in lowest denomination (INR 2000.00)
}

RHA Request Details

Field Name	Data Type	Required	Description
transaction_id	string	M	Unique reference to the transaction
card_id	string	M	Reference to the card
user_id	string	M	Reference to the user
account_id	string	M	Account Id of the user
txn_date	string	M	Transaction Date time stamp
txn_type	string	M	Refer below for more details
txn_code	string	M	Refers to transaction code
channel	string	M	Mode of the transaction (POS, ATM, ECOM)
mcc	string	M	Merchant category code
mid	string	M	Merchant Id
rrn	string	M	Retrieval Reference Number
stan	string	M	-
terminal_id	string	M	Terminal Id
aid	string	M	Acquirer Id
is_afd_applicable	bool	M	Denotes if afd is applicable
acquiring_details.amount	numeric	M	Acquiring amount is the amount sent by the acquirer in the country's local currency.
acquiring_details.currency.alpha_code	string	M	Transaction’s Acquiring Currency represents the local currency with which the transaction was performed.
acquiring_details.currency.numeric_code	numeric	M	Transaction’s Acquiring Numeric Code
acquiring_details.currency.exponent	numeric	M	This field indicates the number of decimal places used to represent subunits (such as paise) in the currency
authentication_details.pin_verified	bool	M	Denotes if pin is verified
authentication_details.cvv_verified	bool	M	Denotes if cvv is verified
merchant.name	string	M	Merchant name
merchant.city	string	M	Merchant city
merchant.state	string	M	Merchant state
merchant.country	string	M	Merchant country
transaction_details.amount	numeric	M	Transaction Amount. In case of international transactions, this would represent the converted value in INR.
transaction_details.currency.alpha_code	string	M	Transaction Currency Code. This would always be in INR
transaction_details.currency.numeric_code	numeric	M	Numeric Transaction Currency Code
transaction_details.currency.exponent	numeric	M	This field indicates the number of decimal places used to represent subunits (such as paise) in the currency
acquiring_details.fee_details.fee_applicable	bool	M	Denotes if there is any fees applicable
acquiring_details.fee_details.fee_type	string	M	Denotes if the fee is DEBIT/CREDIT to the customer
acquiring_details.fee_details.amount	numeric	M	Fee amount
acquiring_details.fee_details.currency.alpha_code	string	M	Fee currency
acquiring_details.fee_details.currency.numeric_code	numeric	M	Numeric code for fee currency
acquiring_details.fee_details.currency.exponent	numeric	M	This field indicates the number of decimal places used to represent subunits (such as paise) in the currency
sub_txn_type.txn_condition	string	O	This refers to the sub type of transaction such as EMI/SI. Possible values are EMI_TRANSACTION, STANDING_INSTRUCTION, ACCOUNT_STATUS_INQUIRY
sub_txn_type.mandate.is_applicable	bool	O	Denotes if mandate is applicable
sub_txn_type.mandate.txn_type	string	O	Denotes type of SI transaction. Possible values are REGISTER_MANDATE, DEREGISTER_MANDATE, UPDATE_MANDATE, INTIMATE_PRE_DEBIT, DEREGISTER_MANDATE_FOR_CARD
sub_txn_type.mandate.number_of_instalments	string	O	Denotes total number of payment instalments
sub_txn_type.mandate.init_date	string	O	Preferred date for SI initialization
sub_txn_type.mandate.min_amount	string	O	Minimum Amount for which SI can be initiated.
sub_txn_type.mandate.max_amount	string	O	Maximum Amount for which SI can be initiated.
sub_txn_type.mandate.start_date	string	O	SI start date
sub_txn_type.mandate.end_date	string	O	SI end date
sub_txn_type.mandate.mode	string	O	SMS/EMAIL
sub_txn_type.mandate.freq_indicator	string	O	Mandate frequency indicator(DAILY/WEEKLY)
sub_txn_type.mandate.txn_id	string	O	Mandate id populated by npci during mandate registration
sub_txn_type.emi.is_applicable	bool	O	Denotes if EMI is applicable
sub_txn_type.emi.amount	string	O	EMI amount
sub_txn_type.emi.total_amount	string	O	Total amount
sub_txn_type.emi.number_of_instalments	string	O	Number of EMI instalments
sub_txn_type.emi.interest_rate	string	O	EMI interest rate
is_pre_auth	bool	O	Denotes if the transaction is a PreAuth transaction
is_dcc	bool	O	Denotes if it's a DCC transaction
pan_entry_mode	string	M	Point of service entry mode - This is used to indicate the method used to enter the account number.
location	string	M	location could take values as either DOM or INTL representing domestic and international transaction respectively

Transaction Types

txn_type	Description	txn_indicator
AUTH	Card Authorization transaction	Debit
AUTH_ADVICE	For any card authorization, if any pre-auth was done, you will get the actual transaction details here.	Debit
REVERSAL	This is the immediate reversal of the authorized transactions.	Credit
REVERSAL_ADVICE	This is the immediate reversal of the authorized transactions.	Credit
CR_EXTEND_LIMIT	This is the reversal due to settlement - An example: Payments on Credit Flipkart/Amazon. If you are returning an item, the refund amount gets posted back to the cardholder. Here the txn_type will be CR_EXTEND_LIMIT. This is basically known as Refunds.	Credit
FP_CE_WITHDRAW_LIMIT	In case, the acquirer merchant claims more than the authorized Debit transaction(surcharge on IRCTC, fuel stations, etc), an extra debit is posted to the cardholder.	Debit
NULLIFY_CLEARED	Denotes that merchant has claimed the amount transacted during real time AUTH transaction	Debit