Overview

In Control for Commercial Payments (ICCP) streamlines business transactions using configurable spending controls and enhanced data:

Unique card number for every transaction

A new account number is generated for each transaction and used only once, which gives each purchase its own unique identifier.

Set Transaction Level Controls

Transaction-level authorization lets you define how, where, and when cards are used.

Get enhanced data

Information important to each individual payment is included in each transaction.

Automated reconciliation

VCN data is available for reconciliation reporting.

Workflow control

Approval routing for transactions follows the existing approval process - can also be used as a key tool to reinvent your requisition-to-pay process.

Get Companies(Post)

This API enables customers to Get the details of the companies

Status :Production

Get DataSource(Post)

This API enables customers to Get the details of the schema to use in submit purchase request API calls

Get Purchase Templates(Post)

This API enables customers to Gets a list of the purchase templates available to use to create a purchase request

Get Real Cards(Post)

This API enables customers to quickly and easily view any restrictions on their credit or debit cards, helping them to make informed decisions about their spending.

Get Suppliers(Post)

This API enables customers to Get a list of suppliers to whom payments can be made

Get VCNAuthsReport(Post)

This API enables customers to Get the authorization report for a VCN

GetVCNClearingsReport(Post)

This API enables customers to Get the clearing report for a VCN

GetPurchaseRequestDetails(Post)

This API enables customers to Get the purchase request Details

GetPurchaseTemplateDetails(Post)

This API enables customers to Get the purchase Request Template Details

CancelPurchaseRequests(Post)

This API enables customers to Cancel a virtual card that’s no longer valid or needed

CreateVCNAuthsReport(Post)

This API enables customers to create report for authorization transactions performed using a VCN for a specific date range

CreateVCNClearingsReport(Post)

This API enables customers to create report for clearing transactions performed using a VCN for a specific date range

EmailCardImage(Post)

This API enables customers to send the virtual card image in an email

SubmitPurchaseRequest(Post)

This API enables customers to Submit a purchase request to generate a Virtual Card Number

UpdatePurchaseRequest(Post)

This API enables customers to Update a purchase request to generate a Virtual Card Number

Get VCNAuthsReport

Status:

Beta

Version:

V2

Product:

ICCP Solutions

GetVCNAuthsReport

Overview

Get the authorization report for a VCN using its report ID.

Node	Child Node	Type	Length	Description
Authorization* required	Bearer xxxx* required	string		Authorization Header (Bearer Token)
Content-Type* required	application/json* required	string		Content Type

Node Type								Type	Length	Description
header	msg_id* required							string	12	Unique Source Message ID
	msg_type* required							string	12	Request Type Default TRANSACTION
	msg_function* required							string	50	Function name to be used Default REQ_GET_VCN_AUTHS_REPORT
	src_application* required							string	10	Source requesting channel Ex IVR
	target_application* required							string	10	Target application name Ex MC
	timestamp* required							string	30	Timestamp of the request Format DD/MM/YYYY HH:MM:SS
	bank_id* required							string	4	Source Bank Id Ex bankID
body	from* required							string	3	First Transaction to review in the report. Index starts with 0
	report_id* required							string	10	ID of a report obtained from a Create API call
	to* required							string	4	Last transaction to retrieve the report. Max number of transactions per call is 100

{"NISrvRequest":{"request_get_vcn_auths_report":{"header":{"msg_id":"236001","msg_type":"ENQUIRY","msg_function":"REQ_GET_VCN_AUTHS_REPORT","src_application":"IVR","target_application":"WAY4","timestamp":"2020-07-20T10:49:02.366+04:00","bank_id":"NIC"},"body":{"from":"1","report_id":0,"to":"10"}}}}

{
    "NISrvRequest": {
        "request_get_vcn_auths_report": {
            "header": {
                "msg_id": "236001",
                "msg_type": "ENQUIRY",
                "msg_function": "REQ_GET_VCN_AUTHS_REPORT",
                "src_application": "IVR",
                "target_application": "WAY4",
                "timestamp": "2020-07-20T10:49:02.366+04:00",
                "bank_id": "NIC"
            },
            "body": {
                "from": "1",
                "report_id": 0,
                "to": "10"
            }
        }
    }
}

Node	Child Node	Type	Length	Description
Content-Type	application/json	string		Content Type

Node Type								Type	Length	Description
header	msg_id* required							string	12	The msg_id sent in the request will be sent back in response in this field
	msg_type* required							string	12	msg_type sent in the request will be sent back in response in this field
	msg_function* required							string	50	Function name to be used default REP_GET_VCN_AUTHS_REPORT
	src_application* required							string	10	The src_application sent in the request will be sent back in response in this field
	target_application* required							string	10	The target_application sent in the request will be sent back in response in this field
	timestamp* required							string	30	Timestamp of the request Format DD/MM/YYYY HH:MM:SS
	bank_id* required							string	4	The bank_id sent in the request will be sent back in response in this field Eg ABCD
	instance_id							string	10	InstanceID
exception_details	application_name							string	20	Application Name
	date_time							string	30	Timestamp of the response
	status							string	1	Status of the request (S/F)
	error_code							string	4	EAI Internal Error Code
	error_description							string	100	Error Description
body	from* required							string	3	First Transaction to review in the report. Index starts with 0
	has_more* required							integer
	to* required							string	4	Last transaction to retrieve the report. Max number of transactions per call is 100
	report_status* required							string
	auth_info	acquirer_ica						string
		avs_response_code						string
		billing_amount						string
		billing_currency_code						string
		billing_currency_code_desc						string
		company_name						string
		company_number						string
		incontrol_issuer_id						string
		incontrol_response						string
		issuer_response						string
		mcc						string
		mcc_description						string
		merchant_amount						string
		merchant_city						string
		merchant_country						string
		merchant_country_code						string
		merchant_currency_code						string
		merchant_currency_code_desc						string
		merchant_id						string
		merchant_name						string
		merchant_state						string
		processor_ica						string
		purchase_request_id						string
		realcard_alias						string
		realcard_number						string
		requestor_name						string
		settled						string
		terminal_id						string
		txn_date						string
		txn_time						string
		txn_environment						string
		txn_exchange_rate						string
		txn_sub_type						string
		txn_type						string
		vcn_expiry						string
virtual_card_number						string

{"NISrvResponse":{"response_get_vcn_auths_report":{"header":{"msg_id":"236001","msg_type":"ENQUIRY","msg_function":"REP_GET_VCN_AUTHS_REPORT","src_application":"IVR","target_application":"CMS","timestamp":"2020-07-20T10:49:02.366+04:00","bank_id":"NIC","instance_id":"InstanceID"},"exception_details":{"application_name":"TCC-ADP","date_time":"2023-02-01T16:39:47.314+04:00","status":"S","error_code":"000","error_description":"Success"},"body":{"from":"1","has_more":0,"to":"10","report_status":"Completed","auth_info":[{"acquirer_ica":"777777","avs_response_code":"00","billing_amount":"35.76","billing_currency_code":"USD","billing_currency_code_desc":"U.S. DOLLAR","company_name":"ABC Company","company_number":"100001","incontrol_issuer_id":"1","incontrol_response":"MCC limit fail","issuer_response":"Do not honor","mcc":"5511","mcc_description":"AUTOTRUCK DLRS-SALES, SVC, REPRS, PRTS, LEASING","merchant_amount":"35.76","merchant_city":"London","merchant_country":"United Kingdom","merchant_country_code":"826","merchant_currency_code":"EUR","merchant_currency_code_desc":"EURO CURRENCY UNIT","merchant_id":"111111111111111","merchant_name":"111","merchant_state":"London","processor_ica":"322222","purchase_request_id":"100","realcard_alias":"Alias1","realcard_number":"XXXX-XXXX-XXXX-4000","requestor_name":"abcCorp1","settled":"Unsettled","terminal_id":"77891137","txn_date":"2023\/07\/28","txn_time":"06-10","txn_environment":"ECOM","txn_exchange_rate":"2.4","txn_sub_type":"Regular","txn_type":"Authorization","vcn_expiry":"1705","virtual_card_number":"XXXX-XXXX-XXXX-1000"}]}}}}

{
    "NISrvResponse": {
        "response_get_vcn_auths_report": {
            "header": {
                "msg_id": "236001",
                "msg_type": "ENQUIRY",
                "msg_function": "REP_GET_VCN_AUTHS_REPORT",
                "src_application": "IVR",
                "target_application": "CMS",
                "timestamp": "2020-07-20T10:49:02.366+04:00",
                "bank_id": "NIC",
                "instance_id": "InstanceID"
            },
            "exception_details": {
                "application_name": "TCC-ADP",
                "date_time": "2023-02-01T16:39:47.314+04:00",
                "status": "S",
                "error_code": "000",
                "error_description": "Success"
            },
            "body": {
                "from": "1",
                "has_more": 0,
                "to": "10",
                "report_status": "Completed",
                "auth_info": [
                    {
                        "acquirer_ica": "777777",
                        "avs_response_code": "00",
                        "billing_amount": "35.76",
                        "billing_currency_code": "USD",
                        "billing_currency_code_desc": "U.S. DOLLAR",
                        "company_name": "ABC Company",
                        "company_number": "100001",
                        "incontrol_issuer_id": "1",
                        "incontrol_response": "MCC limit fail",
                        "issuer_response": "Do not honor",
                        "mcc": "5511",
                        "mcc_description": "AUTOTRUCK DLRS-SALES, SVC, REPRS, PRTS, LEASING",
                        "merchant_amount": "35.76",
                        "merchant_city": "London",
                        "merchant_country": "United Kingdom",
                        "merchant_country_code": "826",
                        "merchant_currency_code": "EUR",
                        "merchant_currency_code_desc": "EURO CURRENCY UNIT",
                        "merchant_id": "111111111111111",
                        "merchant_name": "111",
                        "merchant_state": "London",
                        "processor_ica": "322222",
                        "purchase_request_id": "100",
                        "realcard_alias": "Alias1",
                        "realcard_number": "XXXX-XXXX-XXXX-4000",
                        "requestor_name": "abcCorp1",
                        "settled": "Unsettled",
                        "terminal_id": "77891137",
                        "txn_date": "2023\/07\/28",
                        "txn_time": "06-10",
                        "txn_environment": "ECOM",
                        "txn_exchange_rate": "2.4",
                        "txn_sub_type": "Regular",
                        "txn_type": "Authorization",
                        "vcn_expiry": "1705",
                        "virtual_card_number": "XXXX-XXXX-XXXX-1000"
                    }
                ]
            }
        }
    }
}

Code	Description
200	Sample Description
400	Bad Request
401	Unauthorized
403	Forbidden
500	Internal Server Error
502	Bad gateway
503	Scheduled Maintenance
504	Gateway Timeout
596	Service Not Found